home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u496.dms / in.adf / View80.doc < prev    next >
Encoding:
Text File  |  1990-11-18  |  12.3 KB  |  299 lines
  1.  
  2.  
  3.  
  4.                                      View80
  5.                                    ----------
  6.  
  7.                                       v1.1
  8.  
  9.  
  10.                               by Federico Giannici
  11.  
  12.  
  13.  
  14.  
  15.  
  16. View80 is a fast and comfortable ASCII files reading program.
  17. It  allows you to  visualize 80 columns  texts and to  use the scrollbar at same
  18. time.
  19.  
  20. View80 is entirely written  in C language, except  for a little routine  for the
  21. screen  writing,  that,  from  the  version  1.1, has been rewritten in assembly
  22. language in order to obtain the maximum speed. So, 3 different scroll-modes  are
  23. available:  SMOOTH-Scroll with gradual appearing of the lines, FAST-Scroll rapid
  24. but fluent, and TURBO-Scroll that gives  you the fastest speed, obtained by  not
  25. refreshing the scroll-bar which is positioned only when you release the keys.
  26.  
  27. View80  gives you the best  when there is some  FAST-RAM available. It is due to
  28. the fact that it's  a multiprocessor program (in  Amiga almost every program  is
  29. multiprocessor), in fact, while the Blitter is scrolling the screen, AT THE SAME
  30. TIME,  the CPU (680x0)  is writing the  next line in  a temporary buffer. So, if
  31. View80 is forced  to work in  CHIP-RAM, the CPU  and the Blitter  will come into
  32. conflict  for accessing the memory. This causes, with long lines, a slowing down
  33. of the Fast and Turbo scroll. No problems with the Smooth-Scroll.
  34.  
  35. Another peculiarity of View80, from the  version 1.1, is the ability of  loading
  36. up to three files in memory, and to switch among them by simply pressing a key.
  37.  
  38. View80  is a Public Domain  program and you can  copy and utilize it freely. You
  39. don't have to pay to me  anything (every monetary contributions however will  be
  40. well  accepted) but you can't  modify, sell or incorporate  it in any commercial
  41. program without my  written authorization. Again,  I am not  responsible for any
  42. damage, direct or indirect, derived by the utilization of View80.
  43.  
  44. And now, formalities off, let's start with the program description.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                     LOADING
  51.                                    ---------
  52.  
  53.  
  54. You can run View80 both from CLI or Workbench.
  55.  
  56. Files can be automatically loaded in the usual way:
  57.  
  58. From  CLI, typing View80  followed by the  filenames (up to  three). The CLI can
  59. immediately be used, as if the "Run" command has been used to load the program.
  60.  
  61. From Workbench, using  the multiple selection  procedure with the  SHIFT key, or
  62. typing  "View80"  into  the  Default  Tool  of  the  file to be loaded, and then
  63. double-clicking it. You surely know what and where the Default Tool is (it is in
  64. the INFO window that is activated by the first menu of the Workbench, under  the
  65. "Info" label, do you remember?).
  66.  
  67. If   no  file  is   supplied,  the  program   will  automatically  activate  the
  68. File-Requester (File-Finder by FG, of course!). We'll examine it later on.
  69.  
  70. View80 automatically recognizes if it has been loaded on a PAL or NTSC Amiga and
  71. adapts its  screen dimension.  I haven't  actually tested  my program  on a NTSC
  72. machine but I think there should not be any problem.
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                                      MOVING
  79.                                     --------
  80.  
  81.  
  82. You can move up and down trough the textfile both by keyboard or mouse.
  83.  
  84.  
  85. KEYBOARD MOVEMENTS
  86. By using the UP - DOWN arrow keys you can scroll the text in SMOOTH-Scroll.
  87. If  you press them with  the SHIFT key you  obtain the FAST-Scroll, and pressing
  88. the ALT key you obtain the TURBO-Scroll.
  89. By using the LEFT - RIGHT arrow keys you can move through the text, page by page
  90. (the last line of the previous page will  be showed at the top of the screen  in
  91. order  not to loose the thread of what  you was reading). If you press the SHIFT
  92. key the movement will be carried out in FAST-Scroll.
  93. By using the ALT key with the LEFT - RIGHT arrow keys you can jump to the top or
  94. to the bottom of the text.
  95. The SPACE bar will activate/deactivate the automatic scroll. Again, you can  use
  96. the SHIFT or ALT keys to speed up the scroll.
  97. With  the F4  and F5  keys you  can jump  to a  mark that  was previously set by
  98. pressing the  SHIFT and  F4 or  F5. When  a new  file is  loaded, F4  and F5 are
  99. initialized  to the first and last line of  the file. So, initially, they are an
  100. easy substitute for the ALT and LEFT - RIGHT keys.
  101.  
  102.  
  103. MOUSE MOVEMENTS
  104. By using the mouse you can operate on the scrollbar and on the arrow gadgets  (a
  105. double-click  activate the FAST-Scroll).  Besides, you can  enable the scroll by
  106. clicking with the mouse in the top  or the bottom halves of the screen  (if this
  107. is done just near the borders the scroll will turn to the FAST-Scroll).
  108. The TURBO-Scroll isn't available with the mouse, because for long movements it's
  109. more convenient to use the scroll-bar.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.                                      MENUS
  116.                                     -------
  117.  
  118.  
  119. LOAD FILE
  120. (Obtained also with F9)
  121. This  option allows you to load a new file in memory replacing the previous one.
  122. To Load a new file without delete the previous one, you have to change the File#
  123. (with the F1, F2 and F3 keys,  see later...), then you can choose the  LOAD FILE
  124. command.
  125. The  File-Finder window will appear as you  select this option (File-Finder is a
  126. File-Requester I had created some time ago) and the current directory  filenames
  127. will be displayed.
  128. File-Finder  works like many  other file-requester so  I will tell  you only its
  129. peculiarity.
  130. The "Suffix" gadget  allows you to  select only those  files which end  with the
  131. suffix  you chose  (obviously, if  no suffix  is chosen  every filename  will be
  132. displayed).
  133. If you let File-Finder  complete the last directory  reading, the next time  you
  134. recall it, the current directory list will be immediately displayed.
  135. Again,  since it's difficult to select by  mouse one of the filenames during the
  136. directory  reading  (the  filenames  scroll   down  as  they  are  arranged   in
  137. alphabetical  order), File-Finder  stops reading  as you  click in the filenames
  138. window in order to let you select, among the filenames read until now, which one
  139. you want to load.
  140.  
  141.  
  142. QUIT
  143. (Obtained also with F10)
  144. It leaves the program clearing all the files in memory.
  145. It will appear a requester asking you to confirm your intentions. You can answer
  146. positively by pressing any key but the function and arrow ones.
  147.  
  148.  
  149. SEARCH STRING
  150. This option allows you to search a string in the file with no care for upper  or
  151. lower case.
  152. The  search starts from the second displayed  line on the screen downward (we'll
  153. see why later).
  154. If the search is successful the  line containing the string is displayed  on the
  155. screen in Reverse Mode.
  156.  
  157.  
  158. SEARCH NEXT
  159. Like  "SEARCH  STRING",  but  without  request  for the string to search. Since,
  160. usually, the  last line  founded is  displayed on  the top  of the screen (first
  161. line),  and the  search starts  from the  second screen  line, the result is the
  162. usual "SEARCH NEXT" function. (Q.E.D.)
  163.  
  164.  
  165. PRINT RANGE
  166. This option allows you to print a selected range of lines.
  167. You will  be asked  for the  number of  the first  and the  last line  to print.
  168. Usually  these  lines  will  be  previously  chosen  positioning  the screen and
  169. pressing the F6 and  F7 keys respectively. By  default the F6 and  F7 values are
  170. assigned to the first and last line of the file.
  171. View80  makes a 80 columns print (with  no care for the Preferences settings) so
  172. to reproduce  exactly what  is on  the screen,  expanding the  Tabs properly and
  173. replacing the unprintable characters with the "X" character. (see TABS)
  174. Commonly  the print will  be sent to  the "PRT:" device  (the printer), but it's
  175. possible to redirect the output to any file you choose by the "Send to"  gadget.
  176. If  the file already exists the output will  be appended to the end of the file.
  177. So, it's possible to make a  collage of several pieces of different  files. It's
  178. recommended, for speed problems, to make this operations in RAM:.
  179. The printing can be aborted at any time by clicking on the CANCEL gadget.
  180.  
  181.  
  182. PRINT LINE
  183. When this option is selected the first line on the top of the screen is printed,
  184. and automatically the whole text is scrolled up of a line.
  185. It  is  useful  for  printing  a  small  amount of lines avoiding the line range
  186. requester.
  187. You pay this advantage in terms of  speed, because, for each line View80 has  to
  188. open and to close the "PRT:" (or other) device and this operation requires a lot
  189. of time.
  190.  
  191.  
  192. USE MY COLORS
  193. By default, View80 uses the Workbench colors.
  194. If they result no good for reading or simply you don't like them, you can choose
  195. another  pre-defined  set  of  colors  (nearly  the  default  of Preferences) by
  196. selecting this option.
  197.  
  198.  
  199. JUMP TO
  200. A requester will appear asking you the line number to which to jump. If the line
  201. isn't accessible as the first of the  screen, the line you chose will appear  in
  202. reverse (try to jump to a pair of line before the end of file).
  203.  
  204.  
  205. CLEAR FILE
  206. Clears  the file corresponding to  the current File#. The  other files in memory
  207. will not be affected.
  208.  
  209.  
  210. ABOUT KEYS
  211. (Obtained also with the HELP key)
  212. By selecting this option, View80 will show  an help window with the list of  the
  213. keys (and their functions) you can make use of in the program.
  214. It is also showed the total amount of free memory.
  215. You can get rid of this window by pressing any key.
  216.  
  217.  
  218. FILE# (1, 2, 3)
  219. (Obtained also with F1, F2 and F3)
  220. This command let you switch from a file to another in memory.
  221. Note  that everytime you  come back to  a File# you  will find it EXACTLY as you
  222. left it. In  particular it will  be memorized: the  current position, the  marks
  223. (F4, F5), the print line numbers (F6, F7), the Word-Wrap and the Tab.
  224.  
  225.  
  226. WORD-WRAP (OFF, ON)
  227. When  this function is active  (ON) View80 doesn't split  the word at the end of
  228. the line, but puts it into the following line.
  229.  
  230.  
  231. TAB (OFF, 1, 2, 4, 8)
  232. This option allows you to select the way the Tabs will be displayed.
  233. If you select "OFF", View80 will  consider the Tabs like the others  unprintable
  234. characters  (it will display them in a  single vertical "09" character) (look at
  235. the next topic: MISCELLANEA).
  236. If you select  one of the  other numbers (1,  2, 4, 8)  View80 will display  the
  237. right number of spaces in order to adequately tabulate the text.
  238.  
  239. Note  that  each  time  you  either  change  from  one TAB setting to another or
  240. activate/deactivate the  Word-Wrap, View80  has to  reformat the  whole text and
  241. this  requires some  time. Besides,  the values  of F4,  F5, F6  and F7  will be
  242. brought back to the default (first and last line of the file).
  243.  
  244.  
  245.  
  246.  
  247.  
  248.                                   MISCELLANEA
  249.                                  -------------
  250.  
  251.  
  252. If  the  scroll  is  obtained  by  the  keyboard, View80 makes the mouse pointer
  253. temporarily  invisible. At the  first movement of  the mouse View80 re-makes the
  254. pointer visible.
  255.  
  256. In the drag-bar  of the screen  the following information  are always displayed:
  257. the  name of the program (View80); the  Version number; the number of File#; the
  258. name of the loaded File;   its dimension in bytes  and its length in lines;  the
  259. number  of the current  line, that is  the first line  on the top  of the screen
  260. (View80 updates this number only when you release the mousebuttons or any key).
  261.  
  262. View80 makes  use of  a special  set of  characters which  shows any unprintable
  263. character  contained  between  00  and  1F  and  between 80 and 9F with a single
  264. "vertical" character showing the proper  hexadecimal value of the character  (it
  265. seems difficult but it is not; try to load a non-text file and you will see).
  266. During the print these special characters are replaced with the "X" character.
  267.  
  268. Sometime a requester with some message for you can appear. You can get rid of it
  269. by clicking on the "Continue" gadget or simply pressing any key.
  270.  
  271. When  View80 meets  a CR  and LF  characters sequence  (Carriage Return and Line
  272. Feed) it considers them as a single LF character.
  273.  
  274.  
  275.  
  276.  
  277.  
  278.                                    FINAL NOTE
  279.                                   ------------
  280.  
  281.  
  282. For any  suggestion, criticism,  bug reporting,  contribution and,  most of all,
  283. praises  you can  contact me  at the  address shown  on the  top of  the menu of
  284. View80. You can also contact me on the Italian BBS Mc-Link (06-4180440), my code
  285. is MC4080.
  286.  
  287. I  enjoyed  very  much  programming  View80.  The  result  has  exceeded  all my
  288. expectations. I hope you like it, too.
  289.  
  290.  
  291.  
  292.  
  293.                                                        Federico Giannici
  294.  
  295.                                                        Viale Francia 4
  296.                                                        90146 Palermo
  297.                                                        Italy
  298.  
  299.