home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / KELSTAR / KELSTR02.MSA / TOMS.DOC < prev   
Text File  |  1985-11-20  |  15KB  |  336 lines
  1.  
  2.                          The Observer Menu System v2.0
  3.                          -----------------------------
  4.  
  5.                               Last Updated 12.6.95
  6.  
  7.                              Written by Terry King
  8.                           Ninth Wave Software 1994-95
  9.  
  10.  
  11.   The  Observer  Menu  System or TOMS for short is a  shell  program  for  the 
  12.   Observer document displayer.
  13.  
  14.   You  are probably already reading this document from within TOMS  so  you've 
  15.   already figured out how to access the menus !  To exit back to the main menu 
  16.   select  'Exit To Menu' from the File menu or press UNDO or press  the  right 
  17.   mouse button.
  18.  
  19.   There  are two modes that can be used ;  mouse mode and cursor  mode.  Mouse 
  20.   mode  is accessed from the Scroll menu or by pressing 'M'.  While  in  mouse 
  21.   mode  the cursor will be invisible (so you can't access the menus)  and  you 
  22.   can  scroll through the document by moving the mouse up and down.  To  enter 
  23.   cursor  mode simply press the left mouse button and the cursor  will  appear 
  24.   allowing you to access the menus or mark lines of text for printing. You can 
  25.   also  scroll  through the document with the cursor keys  in  whichever  mode 
  26.   you're  in.  Pressing up and down scrolls up and down and pressing left  and 
  27.   right moves to the previous or next disk description.
  28.  
  29.   From  the main menu you can use the accessories by  selecting  'Accessories' 
  30.   under the Atari symbol in the top left. Documents other than those listed in 
  31.   the menus can be read by selecting 'Load Document'.  To quit back to desktop 
  32.   simply select 'Quit'.
  33.  
  34.   Once  you  have  selected  a document it will  be  loaded  and  depacked  if 
  35.   necessary. You have now left the shell program and entered The Observer.
  36.  
  37.   Using The Observer
  38.   ------------------
  39.  
  40.   After the program has been run you will be presented with a menu at the  top 
  41.   of the screen and the document details at the bottom of the screen with  the 
  42.   document displayed in the middle.  To start with you will be put into  mouse 
  43.   mode,  this  allows you to scroll through the document by moving  the  mouse 
  44.   vertically.  To access the menus press the left mouse button and the  cursor 
  45.   will appear allowing you to enter the drop down menus.
  46.  
  47.   File Menu
  48.   ---------
  49.  
  50.       Save Settings
  51.  
  52.           Saves the current document settings ;  tab  width,  colours,  screen 
  53.           frequency and font.
  54.  
  55.       Exit To Menu
  56.  
  57.           Takes you back to the main menu to access other documents.
  58.  
  59.   Options Menu
  60.   ------------
  61.  
  62.       Goto Top/Bottom
  63.  
  64.           Jumps straight to the top or the bottom of the document.
  65.  
  66.       Goto Line
  67.  
  68.           Allows  you  to type in the line that you wish to jump  to.  If  you 
  69.           enter a value greater than the number of lines then it will jump  to 
  70.           the bottom of the document.
  71.  
  72.       Mark Start
  73.  
  74.           Sets the first line of the display as the start of a block.  If  the 
  75.           'Mark End' has already been used then the new block of text will  be 
  76.           inverted.
  77.  
  78.       Mark End
  79.  
  80.           Sets  the  last line of the display as the end of a  block.  If  the 
  81.           'Mark  Start' has already been used then the new block of text  will 
  82.           be  inverted.  Unlike normal block marker functions the  old  marked 
  83.           block will stay marked.
  84.  
  85.       Clear Marks
  86.  
  87.           Clears every marked (iverted) line.
  88.  
  89.       Search Text
  90.  
  91.           Type in a word or phrase to search, select whether it should be case 
  92.           sensitive  or not and also whether the search should start from  the 
  93.           start of the document or your current line. When pressing the RETURN 
  94.           key on the alert boxes they will default to their previous values.
  95.  
  96.           Wildcard  '*'  and  joker '?' searches can  be  used  to  substitute 
  97.           unknown characters.  A wildcard is used for any number of characters 
  98.           and  a  joker is used to replace just one  character.  For  example, 
  99.           'b?t' could search for 'bat',  'bet',  'bit' or 'but'.  'b*t'  could 
  100.           search  for the same words,  but  also  'ballet',  'blast',  'bolt', 
  101.           'bust', etc. 
  102.  
  103.       Repeat Search
  104.   
  105.           Repeats the search from the current line.
  106.  
  107.       Set Bookmark
  108.  
  109.           Allows you to mark up to 10 important places within a document. When 
  110.           setting a bookmark it will store the first line of the display along 
  111.           with the line number.  Bookmarks are kept even when loading  another 
  112.           document.
  113.  
  114.       Goto Bookmark
  115.  
  116.           Select  the bookmark and you'll be taken straight to that  line.  If 
  117.           the  bookmark belongs to another document it will still  attempt  to 
  118.           goto the same line as defined in the bookmark.
  119.  
  120.       Set TAB Width
  121.  
  122.           Set a new TAB width, the default should be 8.
  123.  
  124.       Set Colours
  125.  
  126.           Allows  you to select a palette which is most comfortable  for  your 
  127.           eyes.  The  sub  menu is different for colour and  mono  users.  For 
  128.           colour users there is a choice of five colour schemes, the first two 
  129.           have light coloured backgrounds and the others have dark backgrounds 
  130.           (which  are  generally  easier  on  the  eyes  when  reading   large 
  131.           documents).  For mono users there are only three options,  the first 
  132.           is  the default black on white text,  the second is white  on  black 
  133.           text and the final option is used to toggle whether the menu text is 
  134.           black or white.
  135.  
  136.       Change Hertz
  137.  
  138.           Used  to select 50 or 60 hertz screen frequency.  A bigger  vertical 
  139.           screen  is  shown for those TV/Monitors that can cope  with  a  60Hz 
  140.           display.
  141.  
  142.       Change Font
  143.  
  144.           Four  fonts  are  included,  the standard ST  font,  the  IBM  font, 
  145.           Macintosh font and a Sans Serif font.
  146.  
  147.   Print Menu
  148.   ----------
  149.  
  150.       Print Document
  151.  
  152.           Prints  the  entire  document,  either page by  page  or  continuous 
  153.           depending  on the settings covered in 'Configure Output'.  If  paged 
  154.           output  is selected then the file name and current page number  will 
  155.           be printed at the top of every page.
  156.  
  157.       Print Marked Lines
  158.  
  159.           While in cursor mode you can click on any individual lines you  wish 
  160.           to  print or you can define a block by holding down the  left  mouse 
  161.           button  (defining the start of the block) and dragging the mouse  to 
  162.           the  end of the block.  Any lines that are printed inverted will  be 
  163.           printed by the command,  this also includes any blocks marked by the 
  164.           'Mark Start' & 'Mark End' commands.
  165.  
  166.           NOTE: There is no page formatting, output is continuous.  
  167.  
  168.       Configure Output
  169.  
  170.           Allows  you to select whether the 'Print Document' command prints  a 
  171.           page at a time or dumps the entire document to the printer.  If page 
  172.           formatting is selected it will then ask for the number of lines  per 
  173.           page, the default being 60 lines.
  174.  
  175.       Configure Printer
  176.  
  177.           The  configure  printer  option allows you to  assign  a  number  of 
  178.           printer control codes to radio buttons,  which allow you to set such 
  179.           things  as  fonts,letter quality modes and indents just with  a  few 
  180.           mouse  clicks.
  181.  
  182.           Up  to four printers can be supported,  three of which have  already 
  183.           been setup for Epson compatibles,  the Hewlett Packard Deskjet range 
  184.           and the Star Gemini printers.  Click on the appropriate printer name 
  185.           and  the  twelve radio buttons on the right hand side  will  display 
  186.           their settings for the selected printer.  Click on the radio buttons 
  187.           to send the control codes to the printer,  if the printer is offline 
  188.           then  it  waits for you to put the printer online or gives  you  the 
  189.           option to cancel.  To edit an existing sequence of control codes  or 
  190.           create new ones,  select the 'Edit Command' button and select  which 
  191.           of  the  twelve radio buttons you wish to edit from  the  drop  down 
  192.           menu.  You  will  then be asked to edit the name to  appear  on  the 
  193.           button and then enter a sequence of control codes. The codes must be 
  194.           entered  as two digit hexidecimal numbers seperated by  spaces.  For 
  195.           example,  the sequence ESC S 1 would be 1B 53 01 (which would select 
  196.           subscript mode on an Epson compatible).
  197.  
  198.           To  create a new set of codes for another printer  or  alternatively 
  199.           add  more  than  twelve  commands  for  one  printer,   select   the 
  200.           printer  radio buttons on the left side and select 'New  Name'.  You 
  201.           will then be asked to edit the printer name or create a new one. The 
  202.           twelve  radio  buttons  connected  to  that  printer  will  then  be 
  203.           displayed.
  204.  
  205.           From this menu you can also save or load the printer  configuration. 
  206.           Saving will automatically save to the home directory of the  program 
  207.           and not the drive/directory currently selected.  The printer  output 
  208.           configuration  is  also saved in this file which includes  the  page 
  209.           length,  page  mode  and whether there is a pause  between  printing 
  210.           pages.
  211.  
  212.           I  have  a  HP Deskjet myself hence the  inclusion  of  the  Deskjet 
  213.           control  codes.  If  you  are  printing a  manual  I  can  recommend 
  214.           selecting  Gothic  12pt with indent which will give around  an  inch 
  215.           left border with around another inch right border for 80 column text 
  216.           which  makes it ideal for double page printing with enough room  for 
  217.           hole-punching into a ring binder.  If you're a real paper scrooge or 
  218.           are just printing something out for reference then select a 6  point 
  219.           font  with indent as this will allow you to print up to  around  128 
  220.           lines  per  page (remember to change this in  the  configure  output 
  221.           option) or simply select continuous output.
  222.  
  223.   Scroll Menu
  224.   -----------
  225.  
  226.       Mouse Scroll
  227.  
  228.           Puts you into mouse mode allowing you to scroll through the document 
  229.           one  line at a time by moving the mouse up and  down.  Pressing  the 
  230.           left  mouse  button returns the cursor allowing you  to  access  the 
  231.           menus.
  232.  
  233.       ExpoMouse Scroll
  234.  
  235.           An  exponential scroll which is ideal for large documents  that  you 
  236.           wish  to  quickly browse.  Moving the mouse at a normal  speed  will 
  237.           scroll  one line at a time just like the normal mouse  scroll  mode, 
  238.           but moving the mouse in a fast continuous motion allows you to  skip 
  239.           many  lines  at a time.  At its fastest it can jump 512 lines  at  a 
  240.           time.  Again,  pressing the left mouse button will put you back into 
  241.           cursor mode.
  242.  
  243.   Infinite Block Markers !
  244.   ------------------------
  245.  
  246.   Well  not quite 'infinite' but this feature allows you to  select  whichever 
  247.   lines you want printed.  While in cursor mode click on the text you want  to 
  248.   mark  and it will invert.  If you hold down the mouse button you can drag  a 
  249.   box  which  will mark or unmark a block depending on whether  the  line  you 
  250.   selected  was  originally marked or unmarked.  If the  line  was  originally 
  251.   unmarked then the block will be marked, if it was marked then the block will 
  252.   be unmarked.
  253.  
  254.   This feature makes it ideal to print out and mark only the lines which catch 
  255.   your  eye instead of having to select and print a block at a time like  most 
  256.   (if  not all) other document display programs.  Select 'Print Marked  Lines' 
  257.   from the Print menu to print the lines.
  258.  
  259.   Keyboard Shortcuts
  260.   ------------------
  261.  
  262.   I have gone against just about every type of document displayer here as  the 
  263.   keys  are single presses (no control or alternate need be held  down)  which 
  264.   makes it much easier for one handed operation.
  265.  
  266.   File Menu
  267.  
  268.           F10       Save Settings
  269.           UNDO      Quit To Main Menu
  270.  
  271.   Options Menu
  272.  
  273.           T         Goto Top
  274.           B         Goto Bottom
  275.           G         Goto Line
  276.           F1        Mark Start
  277.           F2        Mark End
  278.           CLR       Clear Marks
  279.           S         Search Text
  280.           R         Repeat Search
  281.           V         Set Bookmark
  282.           J         Goto Bookmark
  283.           TAB       Set TAB Width
  284.           
  285.   Print Menu
  286.  
  287.           P         Print Document
  288.           K         Print Marked Lines
  289.           O         Configure Output
  290.           X         Configure Printer
  291.  
  292.   Scroll Menu
  293.  
  294.           M         Mouse Scroll
  295.           E         ExpoMouse Scroll
  296.  
  297.   Buy Menu
  298.  
  299.           1         Select Item For Purchase
  300.           2         List/Delete Selected Items
  301.           3         Print Order
  302.  
  303.   Others
  304.  
  305.           Up        Scroll One Line Up
  306.           Down      Scroll One Line Down
  307.           Space     One Page Down
  308.           Shft/Down One Page Down
  309.           Shft/Up   One Page Up
  310.           Left      Goto Previous Disc Marker
  311.           Right     Goto Next Disc Marker
  312.  
  313.   That's it
  314.   ---------
  315.  
  316.   If  you would like information about using/customising your own  version  of 
  317.   TOMS then let me know (my address is in 'About TOMS' on the main menu).
  318.  
  319.   TOMS  was  written  in GFA Basic v3 with numerous  68000  assembly  routines 
  320.   written with DEVPAC 2.
  321.  
  322.   While  you're  here my I take this opportunity to give a  blatant  plug  for 
  323.   'Sprite Works'.  If you're a programmer (either GFA v3.x or assembler)  then 
  324.   this  is  THE essential purchase.  It has many,  many powerful  (and  a  few 
  325.   unique) commands that will set your software alight.  For assembly  program-
  326.   mers there's full source code listings and for GFA users there's examples of 
  327.   every command in action. All aspects of graphics and sound are covered.
  328.  
  329.   Also included is a fully fledged art package,  two map designers,  two demos 
  330.   and three demo games and with version 2.0 there's also a sample editor.  All 
  331.   for  an incredibly low price of £7.00 for two DS/DD  disks.
  332.  
  333.   All code and documentation Copyright Terry King 1994/95 - Ninth Wave Software 
  334.  
  335.  
  336.