home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / portfoli / rg / read.me < prev    next >
Encoding:
Text File  |  1990-02-13  |  4.3 KB  |  183 lines
  1.  
  2. SYSOP:  The following can be split
  3.         into separate documentation
  4.         files and bundled with the
  5.         related software in an ARC
  6.         file.
  7.  
  8.                        R. Gigengack
  9. -------------------------------------
  10.  
  11. General Information
  12. ===================
  13.  
  14. The following files are simple DOS 
  15. utilities which have been downloaded 
  16. from various bulletin boards. I have 
  17. tried many such (small) utilities: most 
  18. do not work. These have worked for me 
  19. so far. The files are: 
  20.  
  21.  - SORTF.COM sorts an ASCII file
  22.  - CIFER.COM encrypts an ASCII file
  23.  - QUERY.COM get user input in a batch
  24.              file using error level
  25.  - STRIP.BAS filters a file made with
  26.              the Portfolio ROM editor
  27.              for word processors
  28.  
  29.  
  30. File-by file description
  31. ========================
  32.  
  33.  - SORTF.COM
  34.  
  35. This program allows an ASCII file to be 
  36. sorted. Just type SORTF, and the 
  37. program will prompt you for file names. 
  38. In this case, sorting will proceed on 
  39. the basis of the first character. If 
  40. the sort must be on, for example, the 
  41. third character, the following command 
  42. can be used: 
  43.  
  44.  sortf in_file out_file /+3
  45.  
  46. If a reversed sort is desired, enter 
  47.  
  48.  sortf in_file out_file /r/+3
  49.  
  50.  
  51. ------------------
  52.  - CIFER.COM
  53.  
  54. This is a simple encryption program. It 
  55. uses DOS redirection to identify the 
  56. input and output device (NB: files, but 
  57. also CON can be used). 
  58.  
  59. The program is called as follows: 
  60.  
  61.   CIFER <in_dev >out_dev key
  62.  
  63. EXAMPLE: encrypt the file text.doc to 
  64. text.xxx using the key "rosebud". 
  65.  
  66.   cifer <text.doc >text.xxx rosebud
  67.  
  68. EXAMPLE: read the encrypted file 
  69. text.xxx made as in the example above.
  70.  
  71.   cifer <text.xxx >con blowjob
  72.  
  73. EXAMPLE: Type a file named hide.xxx, 
  74. and encrypt it directly, using the key 
  75. "hangman" 
  76.  
  77.   cifer <con >hide.xxx hangman
  78.  
  79. NB: Use a CTRL-Z to end.
  80.  
  81. NB: The Portfolio bug preventing a 
  82. "COPY CON ..." to be performed with 
  83. lines exceeding 9 characters must first 
  84. be fixed before the last example can be 
  85. performed. 
  86.  
  87.  
  88. ------------------
  89.  - QUERY.COM
  90.  
  91. This is a variant of the well-known 
  92. class of programs which can be used in 
  93. a batch file to get user input. 
  94.  
  95. This version is used as follows:
  96.  
  97.  query prompt @abc..z
  98.  if errorlevel=26 goto l_26
  99.  ..
  100.  if errorlevel=3  goto l_3
  101.  if errorlevel=2  goto l_2
  102.  if errorlevel=1  goto l_1
  103.  
  104. The "l_#" are labels in the batch file. 
  105.  
  106. The "PROMPT" can be any sequence of 
  107. (extended) ASCII characters. 
  108.  
  109. The "abc..z" can be any digit or 
  110. capital(!) letters. The position which 
  111. the digit or letter takes in the 
  112. "abc..z" sequence determines the error 
  113. level returned (note that this is very 
  114. different from popular variants of the 
  115. program, where the error level returned 
  116. is the ASCII value of the character 
  117. itself). 
  118.  
  119.  
  120. EXAMPLE: ask whether or not to back up 
  121. files to a RAM card in a batch file.
  122.  
  123.    ..
  124.    ..
  125.    query Back up files to A: @YN
  126.    if errorlevel=2 goto no_back
  127.    ..
  128.    .. (statements to perform back-up)
  129.    ..
  130.    
  131.    :no_back
  132.    ..
  133.    ..
  134.  
  135.  
  136. NB: The check on the errorlevel must 
  137. always be done from highest to lowest! 
  138.  
  139. NB: To simulate the DOS "PAUSE" 
  140. statement, for example, use 
  141.  
  142.    query Hit any key done! @?
  143.  
  144. The question mark is a wild card, and 
  145. matches any key pressed. 
  146.  
  147. Finally, note that the user MUST press 
  148. a key appearing in the "abc..z" 
  149. sequence. Thus, in the backup example 
  150. above, the user must press either "Y" 
  151. or "N"; any other response will only 
  152. produce a "beep". So it is wise to 
  153. include a "Q" for "quit" option in the 
  154. option list. 
  155.  
  156.  
  157.  
  158. ------------------
  159.  - STRIP.BAS
  160.  
  161. One of the "professional" tips to be 
  162. found in the downloadable file 
  163. "PRTFTIPS.TXT" is that to filter the 
  164. files generated by the Portfolio's 
  165. internal editor, or WS_EDIT, so that 
  166. they can be read-in by eg. WordPerfect, 
  167. you can use one of the PD "stripper" 
  168. programs. In case you don't have one, 
  169. this simple BASIC program will remove 
  170. all hard carriage return-line feed 
  171. combinations, unless a sequence of two 
  172. consequtive hard carriage return-line 
  173. feeds is encountered. In other words, 
  174. if you remember to separate paragraphs 
  175. by a blank line (containing only a 
  176. carriage return-line feed), then this 
  177. program will allow you to make the file 
  178. readable by your word processor. The 
  179. program is not elegant, but it works. 
  180.  
  181.  
  182. {EOF}
  183.