home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / select14.lzh / Select_E.doc < prev    next >
Text File  |  1992-05-18  |  6KB  |  176 lines
  1.  
  2.  
  3.  
  4.                      Select 1.4
  5.  
  6.               by  V.Gervasi - ICARUS
  7.  
  8.  
  9.  
  10.    Introduction
  11.   --------------
  12.  
  13. ááDid  you  ever wanted to perform some operation on your files, let's say
  14. compress,  rename  or  delete  them,  and that all files matched a certain
  15. pattern...  but one or two ? Or wanted to archive all files matching #?.c,
  16. but  that  bstro_tab.bin,  too, and no other #?.bin ? Did you ever need to
  17. remove some file from two or more directories ?
  18.  
  19. ááOr  let's  say  that,  while you are writing a certain shell script, you
  20. want  to  allow  the  user  to  select  a  file from a certain list (e.g.,
  21. devs:#?.device): what do you do ?
  22.  
  23. ááIn  any  of this cases, Select/Except is the right tool for the job. You
  24. only need AmigaOS 2.0 or later.
  25.  
  26.  
  27.  
  28.    Distribution
  29.   --------------
  30.  
  31. ááSelect is not shareware, strictly speaking, and is NOT public domain.
  32. ááSelect is (C) Copyright 1991 V.Gervasi - ICARUS.
  33.  
  34. ááHowever,  you  can  freely distribute it, with the only restriction that
  35. you  cannot  obtain any profit greater than the bare duplication and media
  36. cost (i.e., no more than $4.-).
  37.  
  38. ááIn  any  case,  the Select executable, the icon Select.info, the Install
  39. script  and  this  document, Select.doc, must be distributed together, not
  40. necessarily  in  their  original  .lzh  archive,  but  in  their original,
  41. unmodified form.
  42.  
  43. ááYou don't need to pay to use Select; however, a contribution is welcome.
  44. If  you  get  10 bucks, put them in an envelope and send it to the Author,
  45. you will merit his grateful wishes and, probably, an updated version.
  46.  
  47. ááI beleive that this distribution policy is quite reasonable; let me know
  48. your opinion !
  49.  
  50.  
  51.    Installation
  52.   --------------
  53.  
  54. ááJust issue "execute Install" or, if you use AmigaShell, simply "Install".
  55.  
  56. ááThe  script  will prompt you for a directory in which to install Select;
  57. the remaining actions are automatic.
  58.  
  59.  
  60.    Select or Except ?
  61.   --------------------
  62.  
  63. ááActually,  this  program  is two programs. Or, better, this two programs
  64. are  the  same  program.áOh,  well,  the  program,  once  run, will behave
  65. differently depending on the name it had when run:
  66.  
  67.  - Select   Will select from the files matching the given pattern;
  68.  - Except   Will select from the files NOT matching the given pattern.
  69.  
  70. ááThe  included  script,  Install, takes care of performing a MAKELINK, so
  71. that  you  can  have both programs without wasting twice the space on your
  72. disk.
  73.  
  74. ááIn the following, we will refer to Select, but Except behaves exactly in
  75. the same way.
  76.  
  77.  
  78.    Syntax
  79.   --------
  80.  
  81. ááThe syntax is quite simple:
  82.  
  83.     SELECT <command line with pattern>
  84.  
  85. ááHere, <command line> is exactly the same you should issue to execute the
  86. required  command,  with  the  only  exception  that you can use a pattern
  87. whereas you would have used a file name.
  88.  
  89.  
  90. ááExamples:
  91.  
  92.     select copy df0:#? df1:
  93.  
  94.       Copies the files you will select from df0: to df1:
  95.  
  96.     select type #?.doc
  97.  
  98.         Types the files you will select, chosen among those whose name
  99.     ends in ".doc".
  100.  
  101.     select delete #?read#?me#?
  102.  
  103.         Deletes all files you will select, chosen among those whose name
  104.     contains "read" and "me", in that order.
  105.  
  106. ááThe  first  AmigaDOS pattern in the <command line> is used to select the
  107. files  that  will  appear in list. You can select any number of files from
  108. this list, or add other files.
  109.  
  110.  
  111.    Select's Interface
  112.   --------------------
  113.  
  114. ááSelect's  window  contains a file list (corresponding to the pattern) on
  115. which  you  can  operate,  a single line containing a copy of the <command
  116. line> and 6 command buttons.
  117.  
  118. ááYou  can  select  a  file  from the list simply by clicking on his name;
  119. beside  the  name  will  appear  a  ">>" symbol. As usual, you can use the
  120. scrolling bar to see the entire list.
  121.  
  122. ááThe  "All"  button  selects  all  the  files from the list, while "None"
  123. deselect  them  all.  "Invert" deselects all currently selected files, and
  124. selects  those  not  selected. e  "anoc,  
  125.    a----d dTe  "sOádYded. ewy    w⌠-d dTe  "sOádYded. ewyO ah≥f the <comma
  126. Oádw╒ne <corrr l selS.doc, msileôsC AmigaOS tendlectedn ; <co ndle≡6bceistru file e <cf the <comma
  127. O !    d, rl?lecn:
  128.  
  129. Æo c┐ in  thaísi╟rCac, so▌s╒le:5.eon h ee⌡rCac, so▌s╒le:5.eon h ee⌡rCac, so▌s╒le:5.eobis     Coplect  a  fi files fwb:#?.device): what do you do ?
  130.  
  131. ááIn  any  of this casesvertt do:5.e═of tr-
  132.  
  133. áuÆ do:5.s matoles yoo═ofKELaoe:5c,  
  134. onco,aaere#ct containsbn.all   pát simply ) Copyrlects  ts matolwe.i#ct"Ly:
  135.  
  136.       Cop.dye lisfevert" dobi o:5m ad
  137. ⌠ert"end cD d cD dd to seleck
  138. afileos includ
  139.  an ng at┴o╓h seleckndlA   0 those  not  selected. e f≡ from tehave bC╢ileôsC AmigaOS tenehose we liselcome. respondte.i#ct"d loe a. ewaTDraOSibondchoªot  obw╒ne < adtr-    Φaraelectel?⌡
  140. Ωot
  141. r t. respondte.i#ct"d loe a. e < 
  142. c┐ in  ths two pr Amigaareya
  143. cre#cins n.<coNy:
  144.  thosea. el As us" sel1a;he  "AgiEtieae coDUCi--------
  145.  
  146. ááTt ¢╚╓ihe  "AgiEtieas
  147. e.atLacRae
  148.  
  149. ááTo╛Ω Oou cG 
  150.    a---rnfrom #ct"d loec, oso¢g all. á╖ose.mdyen l..i#c9em ad
  151. ⌠ert"end cD d cD dd ontaa easy  v"ist  ewy    b╒?bdtglásoi    b╒?bdtglásoi    m #l ¢╚╓ihOh"p  tiwingle "g tca╛Ω =tirsr h eu,gleside  the eael>Oins .i#A   0 thoseafilthe e,io
  152. h"afiltAdeael>Oinsi---6bcd---rnf"n.<c#d
  153. ⌠yV<coàe  "A buttdcro"g tc>Oin se same waÜuO 4.oü the
  154. r,o dyen l..i#c9em ad
  155. ⌠ert"end cD d cD dv <co e  inclem inomn÷O a╖ll.  g---- only╨no¢ctel?⌡
  156. Ωot
  157. r t. respondte.i#ct"d loe a. e < 
  158. c┐ in ¥list.Σn\--6bcd---clcomm<, l.'list.oondtete.i#ct"d loe a. e < 
  159. c┐ in ¥list.Σn\--6bcd---clcomm<, qAsel
  160. dof_D>enehose we liselcome. respondte.i#ct"d loe a. ewaT╚sF▌≤iilope and send it to the A
  161. end it to the A
  162.  msileôsC AmigaOS tendlectedn ; <co ndle≡6bceistrnca╛Ω =t:pen-mm<, qAsel
  163. dof_D>enehthe files ymigar╚ two programsto the pattern) o; thLa╛Ω =t:ôsC 4
  164. eleceÉôglá;commsaVsW
  165.  
  166.  rCvog t"s, iuT.4TÖo; thLa╛Ω-6bòAs, iuT.4TÖo; thLa╛Ω-6bòAs, iuT.4TÖo; th≡p Φs Interface
  167.   ---------------∞raeleeVsWvd±╛Θ frooplapa@ selg@ selg@ selg@ selg@ selg@ sel "Aggiven pa#h,r;it
  168. ááIn tuw ;it;he  #ctnw,Σn\-I±
  169. i    b╒?bdtglásoi    m #l ¢╚╓ihOh"p  tiwingle "g tca╛Ω =all liswIwo   0 du"ny"Oh"p a. e╛.," dobi.#ct ahe "t"d loeamsto thbdr line>i L<i/uTelg@ sêbcdanl>Oins 
  170.  
  171. -6bcd--- - cute the
  172. required  command,  with  thaVsesile<<i/uTelg@5---------.áÖ "Aggm~uopo(g┐nsi---e snehohgand
  173. £o∙.s:? tiwint╚"le:5.eop,re. 
  174. to tym # ece0ondto soctel?⌡asìoplNooe═of<i/; 6bòu-6bòAs, olg@ sêbcdanl>Oins 
  175.  
  176. -6bcd--- - cute th