home *** CD-ROM | disk | FTP | other *** search
/ POWERdrive for you 4 / PFY04.ISO / share / upddos / anwend / gsm / english.txt < prev    next >
Text File  |  1995-09-11  |  46KB  |  1,160 lines

  1.           ┌──────────────────────────────────────────────────────────┐
  2.           │                                                          │
  3.           │                GS-MENU (R) Release 3.40                  │
  4.           │                   (C) 1989 - 1995                        │
  5.           │                                                          │
  6.           │             Shareware  -  Made in Germany !              │
  7.           │                                                          │
  8.           └──────────────────────────────────────────────────────────┘
  9.           ┌──────────────────────────────────────────────────────────┐
  10.           │                Program Documentation                     │
  11.           │                                                          │
  12.           │          Translation by Hennig Bardenwerper              │
  13.           └──────────────────────────────────────────────────────────┘
  14.  
  15.  
  16.                     Gandke & Schubert  -  Computerprograms
  17.  
  18.                                 P. O. Box 200 429
  19.                             D-41204 Mönchengladbach
  20.  
  21.                           Telefon: (0 21 66) 94 80-0
  22.  
  23.                                9.00 AM - 5.00 PM
  24.                              (On Fridays - 4.00 PM)
  25.  
  26.                           Telefax: (0 21 66) 61 20 37
  27.                           Mailbox: (0 21 66) 94 80-50
  28.                                     BTX: GS#
  29.  
  30.  
  31.  
  32.           ┌───────────────────┐
  33.           │ Table of Contents │
  34.           └───────────────────┘
  35.  
  36.           1. System Requirements
  37.           2. General Introduction
  38.           (3. Virus Protection)
  39.           4. Hard Disk Installation
  40.           5. Operating the Menu System
  41.           6. The Menu Batch File
  42.  
  43.                 (a) What is a batch file?
  44.                 (b) Structure of menu batch file
  45.                 (c) Menu windows (*)
  46.                 (d) Menu options (#)
  47.                 (e) Direct actions on selection
  48.                 (f) Branching to a submenu (%)
  49.                 (g) Inserting program parameters ($)
  50.                 (h) Password protection for individual options (?)
  51.                 (i) <F1> Help text for individual menu options (!)
  52.                 (j) Remarks within the batch file
  53.                 (k) Including batch files (@)
  54.  
  55.           7. Creating and Editing a Menu Batch File
  56.           8. Loading the Menu automatically at Start Up
  57.  
  58.           9. The ALT-Functions
  59.  
  60.                 (a) ALT + V Moving windows
  61.  
  62.                 (b) ALT + I Miscellaneous settings
  63.  
  64.                        -  Screen colours
  65.                        -  Shadows
  66.                        -  Time lock
  67.                        -  Dark screen
  68.                        -  Language
  69.                        -  Save settings
  70.  
  71.                 (c) ALT + P    Enter/change system password
  72.  
  73.  
  74.           10. Additional Tips
  75.  
  76.                 (a) Shelling to DOS
  77.                 (b) Renaming EXAMPLE.MEN
  78.                 (c) Inducing a monochrome display
  79.                 (d) Password before leaving the menu
  80.                 (e) Calling GS-MENU by PATH
  81.                 (f) The environment variables MENUTMP and MENUSYS
  82.  
  83.           11. Network (LAN) Installation, switching off <CTRL>+<C> and
  84.               <CTRL>+<BREAK>.
  85.  
  86.           12. Provisions/Restrictions of GS-MENU
  87.           13. Restrictions of a Shareware Version
  88.           14. As often as possible .....
  89.           15. User Registration
  90.           16. Prices of Registered Versions
  91.           17. How to proceed
  92.           18. One last Thing .....
  93.  
  94.  
  95.           ┌─────────────────────────┐
  96.           │ 1.  System Requirements │
  97.           └─────────────────────────┘
  98.  
  99.           PC/MS-DOS (at least Version 3.00)
  100.           512 KB Main Memory
  101.           Hard Disk
  102.  
  103.  
  104.           ┌──────────────────────────┐
  105.           │ 2.  General Introduction │
  106.           └──────────────────────────┘
  107.  
  108.           GS-MENU will provide you  with a convenient and simple  user
  109.           interface for your  Personal  Computer. By selecting a  menu
  110.           option  using  the  <ARROW  KEYS>,  the  <SPACEBAR>  or  the
  111.           first letter of the option and by confirming your  selection
  112.           by  pressing <RETURN/ENTER> you can easily call up all  your
  113.           various  programs. After  leaving  an  application  you will
  114.           automatically find yourself back on the menu.
  115.  
  116.           These functions will also work with a serial (or  compatible)
  117.           MS-Mouse .
  118.  
  119.           Unlike  most other  menu systems, which can be tough on your
  120.           computer's  RAM,  this one,  as a rule,  will  take  up only
  121.           80  (EIGHTY!!!)  Bytes  of memory. In other words, even very
  122.           memory-hungry applications can be integrated in the menu.
  123.  
  124.           In order to set  up  the menu system you will  need at least
  125.           some  basic  knowledge  of  your  operating  system, as  you
  126.           will be working entirely with  DOS commands. Where these are
  127.           concerned we will have to refer you to your DOS manual or to
  128.           other literature  on the   subject.   Generally spoken, very
  129.           few   commands  will  be  required.   We  suggest  that  you
  130.           familiarise  yourself with the following:
  131.  
  132.           - MD       (MKDIR)    Create a new directory
  133.           - CD       (CHDIR)    Change to an existing directory
  134.           - DIR      Show contents of drive/directory
  135.           - COPY     Copy files
  136.  
  137.           You should also be familiar with the following:
  138.  
  139.  
  140.           -  directory structure under PC/MS-DOS,
  141.           -  files   under  PC/MS-DOS  (in  particular  those with
  142.              extensions ".EXE". ".COM" and ".BAT"),
  143.           -  calling programs in PC/MS-DOS,
  144.           -  keyboard settings of your computer (refer to the manual)
  145.              and
  146.           -  the start file "AUTOEXEC.BAT"
  147.  
  148.  
  149.           The  functions  of so-called batch files which carry out DOS
  150.           commands  sequentially   (in  a batch)   are  of  particular
  151.           interest (and  important in this  context). All DOS commands
  152.           which  can  be  executed  from  within  a batch file  can be
  153.           carried out by GS-MENU without difficulty.
  154.  
  155.           If  you  know  the operating system of your computer to this
  156.           extent, you  will  have no problem  whatsoever in setting up
  157.           and maintaining your own individual menu system.
  158.  
  159.           ┌──────────────────────┐
  160.           │ 3.  Virus Protection │
  161.           └──────────────────────┘
  162.           Some  Versions  of  GS-MENU  used to check the length of the
  163.           file "MENU.EXE"  whenever it was  started. Due to the use of
  164.           LZEXE  for compression this is no longer possible. The virus
  165.           check (and the whole program)  will  not work if the program
  166.           itself is infected.
  167.  
  168.           If GS-MENU does not start the reason might be a virus!
  169.  
  170.           ┌───────────────────────────────────────────────┐
  171.           │ 4.  Installing of the Program on a Hard Disk  │
  172.           └───────────────────────────────────────────────┘
  173.  
  174.  
  175.           Since  the program,  including this documentation, fits on a
  176.           single diskette there was no need to have it compressed. The
  177.           usual installation procedure is therefore not necessary.
  178.  
  179.           All you have to do is to copy the contents of  the  diskette
  180.           into a new  subdirectory on your hard disk.  Should you have
  181.           worked with an older version  of  GS-MENU  already,  make  a
  182.           back-up copy of your old menu batch file and then delete all
  183.           files in this directory.
  184.  
  185.           To install GS-MENU take the following steps:
  186.  
  187.           1. Create a new directory, e.g.:
  188.  
  189.              C:\> md gsmenu
  190.  
  191.  
  192.           2. Change to the new directory:
  193.  
  194.              C:\> cd gsmenu
  195.  
  196.  
  197.           3. Copy the diskette into the new directory:
  198.  
  199.              C:\GSMENU> copy a:*.*
  200.  
  201.           That's all ! The installation on  a  network  is  identical.
  202.           However, a special environment variable must exist for every
  203.           workstation (see section 11 below.)
  204.  
  205.  
  206.           ┌───────────────────────────────┐
  207.           │ 5.  Operating the Menu System │
  208.           └───────────────────────────────┘
  209.  
  210.           To  load  the  program you must specify the name of the menu
  211.           batch file as a parameter.  This batch  file,  as  discussed
  212.           later, contains commands  which  control further processing.
  213.  
  214.           C:\GSMENU> gsmenu example.men
  215.  
  216.           "EXAMPLE.MEN" is the name of a sample file supplied  by  us.
  217.           You  should rename  it and change it  according to  your own
  218.           needs  or create a  new batch file  and use the new  name as
  219.           the parameter.
  220.  
  221.           On  the  diskette  you  will  also  find a batch file called
  222.           "ENCODE. MEN".  It contains the same  as  "EXAMPLE.MEN"  but
  223.           encoded  by  a  special  program  available as a utility for
  224.           GS-MENU. This is useful if you want to be sure  that  nobody
  225.           will find out your passwords in the ASCII-Batch-File.
  226.  
  227.           Try using  the  menu  system.  Move  the  selection  bar  by
  228.           pressing  the  <ARROW  KEYS> or the <SPACEBAR>. Confirm your
  229.           selection by pressing <ENTER/RETURN>.  When  you  are  in  a
  230.           submenu you can leave it by pressing <ESC>. The main menu is
  231.           ended  by  pressing  <ESC>. <ARROW KEYS> in this context are
  232.           <ARROW Dn>, <ARROW Up>, <PgDn> and <PgUp>. If  you  enter  a
  233.           letter  the  selection bar will move to the next option that
  234.           begins with this letter. If there is only one  option  which
  235.           begins with that letter it will be executed immediately.
  236.  
  237.           If  you  are using a mouse the left key equals <RETURN>, the
  238.           right one equals <ESC>.
  239.  
  240.           Now select the option  "Adjust  menu  system"  in  the  main
  241.           menu.  The options offered by the submenu will enable you to
  242.           adjust the menu system to your own individual needs.
  243.  
  244.           The option  "Edit  menu  batch  file"  will  load  the  file
  245.           EXAMPLE.MEN  into  the editor GS-EDIT so that you can change
  246.           it (see more detailed  instructions  under  section  6).  Be
  247.           careful:  if  you insert to many "wild" changes the menu can
  248.           go totally haywire. In such cases you will have to restart.
  249.  
  250.           The  option  "View documentation" will allow you to view the
  251.           file DOC.TXT (this text).
  252.  
  253.           If you wish to print this document  select the option "Print
  254.           documentation".  Make  sure  your  printer is ready and that
  255.           there is a sufficient supply of paper (20 to 25 pages).
  256.  
  257.           We hope the program meets with your approval!  If you intend
  258.           to use it regularly, the two following options will give you
  259.           information on  how  to  become  a registered  user  and  on
  260.           other programs available from this company.
  261.  
  262.           ┌────────────────────────┐
  263.           │ 6. The Menu Batch File │
  264.           └────────────────────────┘
  265.  
  266.           We  are  now using  the  file  EXAMPLE.MEN   to  explain the
  267.           functions of the menu system.
  268.  
  269.           (a) What is a batch file?
  270.  
  271.           A  batch file is a normal text file containing a sequence of
  272.           command which  will tell the menu system what it is supposed
  273.           to do. There are two main categories of commands:
  274.  
  275.           -  The  first  category  are  internal menu  system commands
  276.              like calls for submenus, options, on-screen positions  of
  277.              menu windows etc.
  278.  
  279.           -  The second category are operating  system  (DOS) commands
  280.              like changing directories, loading  application  programs
  281.              etc. The menu system will make the operating system carry
  282.              out these commands as if they had been entered at the DOS
  283.              command line.
  284.  
  285.           Print the EXAMPLE.MEN batch file by selecting  the  relevant
  286.           option  in the main menu.  You should then read this part of
  287.           the documentation very carefully with the print-out  of  the
  288.           batch  file  in  front  of you. You will realise quickly how
  289.           easy it is to understand the functions of the program.   You
  290.           will  even develop your own ideas on the directory structure
  291.           of your hard disk.
  292.  
  293.  
  294.           (b) Structure of a menu batch file
  295.  
  296.           Here is an example:
  297.  
  298.              *Main Menu (20,8)
  299.  
  300.                  #Ap^plications
  301.                      %Applications
  302.  
  303.                  #^Utilities
  304.                      %Utilities
  305.  
  306.                  #System ^Commands
  307.                      ?Secret
  308.                      %System Commands
  309.  
  310.                  #^Edit Menu System
  311.                      %Edit Menu System
  312.  
  313.                  #P^rint Menu Batch File
  314.                      type example.men > prn
  315.  
  316.           Each line  of  the  batch  file  contains  a  command  which
  317.           defines   the  subsequent  actions.  These  are  mainly  the
  318.           following:
  319.  
  320.           Menu windows (preceded by a "*") which represent a  complete
  321.           window with different options.
  322.  
  323.           Menu  options (preceded by a "#") which will start an action
  324.           of some kind. The pre-defined hotkey  of  each option is its
  325.           first letter.  You  can  use  a "^" to define another letter
  326.           as a hotkey.
  327.  
  328.           Calls for submenus (preceded by a "%") which will  open  yet
  329.           another window when selected;
  330.  
  331.           normal  commands  as in MS-DOS batch files to start programs
  332.           or carry out DOS commands;
  333.  
  334.           additional  commands  for  the  menu  system,  i.e.  program
  335.           parameters, password protection, help text, window positions
  336.           etc.
  337.  
  338.           To improve the visual structure of your batch file  you  can
  339.           insert  indentations  and blank lines.  Please be aware that
  340.           the menu system differentiates between lower and upper  case
  341.           letters in calls for menu windows.
  342.  
  343.  
  344.           (c) Menu windows (*).
  345.  
  346.           Each  menu  window  is preceded by an asterisk (*). The text
  347.           following the asterisk  represents  the  window  header  and
  348.           must  be  absolutely identical to the text following the "%"
  349.           character which calls this submenu from the previous window.
  350.           When  the  menu  system  is  loaded,  the  program  searches
  351.           automatically for the first asterisk in the batch file. Make
  352.           sure, therefore, that your  main  menu  is  located  at  the
  353.           beginning of the batch file, i.e.
  354.  
  355.              *Main Menu (20,8).
  356.  
  357.           The  numbers  in  brackets define the screen position of the
  358.           upper left corner of  the  menu  window.  The  first  number
  359.           represents  the  horizontal  X  value.  The  second  is  the
  360.           vertical  Y  value.  You  should  not be too concerned about
  361.           these  coordinates.  You  can  adjust  the  position  of the
  362.           window  easily on-screen using the <ARROW KEYS> (see section
  363.           9).
  364.  
  365.  
  366.           (d) Menu options (#).
  367.  
  368.           Menu options are preceded by the "#" character.
  369.  
  370.                MAIN MENU
  371.                #Applications       <- 1st option
  372.                #Utilities          <- 2nd option
  373.                #-                  <- dividing line
  374.                #System Commands    <- 3rd option
  375.  
  376.           These are the options that you will see on the screen.
  377.  
  378.           The maximum number of options per window is 18. (These would
  379.           fill the screen from top to bottom).
  380.  
  381.           "-" instead of text shows a dividing line.
  382.  
  383.  
  384.           (e) Direct actions on selection
  385.  
  386.           On the line immediately below the individual option you  can
  387.           enter the actions  that  your  computer  should carry out if
  388.           this option is selected.
  389.  
  390.                   #Print Menu Batch File
  391.                       type example.men > prn
  392.  
  393.           You   can   enter   commands   which  will  be  carried  out
  394.           immediately. There is no need to enter any commands to  make
  395.           the program  return to the menu system after having executed
  396.           the commands. This is done automatically.
  397.  
  398.                   #Show Floppy Disc Contents
  399.                       dir a: /p /w
  400.                       echo.              <- echo. yields a blank line
  401.                       pause
  402.  
  403.  
  404.           (f) Branching to a submenu (%)
  405.  
  406.           Instead  of commands  to be processed directly, you can also
  407.           enter a  command  which  will  make the program  branch to a
  408.           submenu (i.e. open a new window).
  409.  
  410.                   #Utilities           <- Main menu option
  411.                       %Utilities       <- Submenu to be loaded
  412.  
  413.           Every  call  for  a  submenu  must  be  preceded  by  a  "%"
  414.           character.  The  options  in this new window could then look
  415.           like this:
  416.  
  417.                   *Utilities (32,11)
  418.  
  419.                       #PC-Tools
  420.                         cd\util
  421.                         pctools
  422.  
  423.                       #Quick-DOS
  424.                         cd\util
  425.                         qd
  426.  
  427.                       #Norton Tools
  428.                         cd\util
  429.                         nu
  430.  
  431.           A  maximum  number of 15 windows (submenus) can be opened on
  432.           the screen at the same time.
  433.  
  434.  
  435.           (g) Many programs (i.e.   word  processors)  can  be  loaded
  436.               with  certain  parameters.   Have  a  look at the option
  437.               "Word  Processing"  in  the  menu  batch   file:   #Word
  438.               Processing $Textname: gsedit $
  439.  
  440.           The   program  will  interpret  the  "$"   character  at the
  441.           beginning of the  command  line  as  a  command  to  open an
  442.           additional window where parameters can  be entered.  In this
  443.           case enter the  name  of  the  batch  file  EXAMPLE.MEN  and
  444.           confirm by pressing <ENTER>.
  445.  
  446.           So you see, this entry has  the  same  effect  as  the  menu
  447.           option "Edit Menu Batch File":
  448.  
  449.                       #Edit Menu Batch File
  450.                           gsedit example.men
  451.  
  452.           When you enter the control code "$" after a  command  in the
  453.           menu  batch  file,  it  will  be  replaced by the entry  you
  454.           made in the parameter window, when the command was executed.
  455.  
  456.           If you want to enter more than one parameter,  simply  enter
  457.           them   one  after  the  other  into  the  parameter  window.
  458.           Obviously, the command which opens the parameter window  has
  459.           to be located, before the command which loads the program.
  460.  
  461.           If  you wish to use single parameters at different places in
  462.           the batch file, just use the parameters "$0"  to  "$9".
  463.  
  464.           Example:
  465.  
  466.                  Enter Options:
  467.  
  468.                  Option1 Option2 Option3   <- Your Input
  469.  
  470.  
  471.           While  "$"  contains  the  whole line of your input "Option1
  472.           Option2 ..." "$0" represents "Option1", "$1" "Option2" ...
  473.  
  474.           If  you  don't  wish to enter all parameters in one line you
  475.           will have to define more than one parameter window:
  476.  
  477.              #Parameter-Test
  478.                 $0Parameter1:
  479.                 $1Parameter2:
  480.                 program $0 $1
  481.  
  482.           (h) Password protection for individual menu options (?)
  483.  
  484.           If  you  want  to  protect  individual  menu  options  by an
  485.           additional password you must insert this in the  batch  file
  486.           on  the line following the line that contains the option (#)
  487.           itself.
  488.  
  489.                #System Commands
  490.                    ?Secret            <- your special Password
  491.                    %System Commands
  492.  
  493.           GS-MENU interprets the question mark as a  command  to  open
  494.           another window which prompts you to enter the password, i.e.
  495.           "Secret" in this particular  case. The name of the protected
  496.           menu  option is also displayed  to avoid  any confusion with
  497.           the general  system  password  (see  section 9.c).
  498.  
  499.           If  you  are  using  a combination of password and parameter
  500.           entries the "$" parameter line must follow the "?"  password
  501.           line.
  502.  
  503.  
  504.           (i) Help text with <F1> for individual menu options
  505.  
  506.           For  every  menu  option you can insert a detailed help text
  507.           which can be displayed by pressing <F1>  if  the  cursor  is
  508.           positioned on the relevant option.
  509.  
  510.              #System Commands
  511.                  ?Secret                 <- your special password
  512.  
  513.                  !The system commands enable you to work on the
  514.                  !level of the operating system of your computer
  515.                  !and require profound knowledge of the system.
  516.                  !An inexperienced user can easily damage essential
  517.                  !data.
  518.                  !This option is therefore protected by a password.
  519.                  !(The password is "Secret" but don't tell anybody.)
  520.  
  521.                  %System Commands
  522.  
  523.           Each  line  of   the   help   text   must   begin   with  an
  524.           exclamation mark. As these text lines can be placed anywhere
  525.           within  the block  relating  to  the  individual option they
  526.           can also be "misused" as comments  to  individual  commands.
  527.           The  help screen  will  display  all lines  as one connected
  528.           block of text.
  529.  
  530.           Help  texts  can  be  placed  into external files, and other
  531.           programs  (e. g. for showing graphics)  can be called up. If
  532.           the first character of a help text is a ":", GS-MENU assumes
  533.           that you are calling up an external file.
  534.  
  535.           Examples:
  536.  
  537.           #System commands
  538.              !:System.txt
  539.  
  540.           The file SYSTEM.TXT will be shown as help text.
  541.  
  542.           #System commands
  543.              !:System.exe
  544.  
  545.           The program SYSTEM.EXE is called. GS-MENU starts files  with
  546.           suffixes .EXE, .COM or .BAT as programs. All other files are
  547.           shown like normal help texts.
  548.  
  549.           (j) Remarks within the Batch File
  550.  
  551.           Lines  beginning  with   "REM"   (Remark)  will  be  ignored
  552.           by GS-MENU.
  553.  
  554.  
  555.           (k) Including Batch Files (@include)
  556.  
  557.           If  parts  of your GS-MENU batch file are used several times
  558.           or  if  you  work  with  different  batch  files  which  are
  559.           almost  the  same,  it can be useful to split it into two or
  560.           more  files.  In  your  batch  file  you   write   "@include
  561.           <xyz.men>".
  562.  
  563.           Example:
  564.  
  565.              #Read a file
  566.                 @include read.men
  567.  
  568.           The file READ.MEN could read like this:
  569.  
  570.              c:
  571.              cd \test
  572.              program
  573.  
  574.           Do not forget that the length of batch  files, including the
  575.           included files, is limited to 64 kB.
  576.  
  577.  
  578.           ┌───────────────────────────────────────────┐
  579.           │ 7. Creating and Editing a Menu Batch File │
  580.           └───────────────────────────────────────────┘
  581.  
  582.           A batch file can be  created  and  edited  with  every  word
  583.           processor or editor which is capable of saving text in ASCII
  584.           format. In addition we  supply  the  program  GSEDIT  It  is
  585.           loaded  automatically  by the menu batch file as soon as the
  586.           option "Edit Menu  Batch  File"  is  selected.  If  you  are
  587.           working on the DOS level enter
  588.  
  589.                 C:\GSMENU> gsedit <filename>
  590.  
  591.           Editor Commands:
  592.  
  593.             <ESC>            Cancel editing
  594.             <Ctrl-Y>         Delete line
  595.             <Ctrl-PgUp>      Beginning of text
  596.             <Ctrl-PgDn>      End of text
  597.             <HOME>           Beginning of line
  598.             <END>            End of line
  599.  
  600.           as well as <ARROW KEYS>, <DEL> and Backspace. At the  bottom
  601.           right hand corner of the screen, you will find an indication
  602.           wheather you are in INSERT or OVERWRITE mode. You can toggle
  603.           this mode by pressing the <INSERT> key.
  604.  
  605.           The command
  606.  
  607.                   C:\GSMENU> gsmenu example.men
  608.  
  609.           will load the menu batch file into the editor.
  610.  
  611.           Make  only  a  few  changes  at  first  and test them. For a
  612.           better  visual  overview,   separation  of  the   individual
  613.           submenus  by  at  least  one blank line and insertion of the
  614.           appropriate  indentations  as   shown   in  the  example  is
  615.           recommended.
  616.  
  617.           Load the menu system by  entering  "gsmenu  example.men"  at
  618.           the DOS prompt and see the results of your changes.
  619.  
  620.           ┌────────────────────────────────────────────────┐
  621.           │ 8. Loading GS-MENU automatically at Start Up   │
  622.           └────────────────────────────────────────────────┘
  623.  
  624.  
  625.           If you  are  satisfied with your menu batch file, you should
  626.           rename EXAMPLE.MEN to something like MYMENU.MEN. You  should
  627.           then  include a command in the AUTOEXEC.BAT file, located in
  628.           your  root directory, which  loads  the  menu  automatically
  629.           every time you start your computer. The changed file  should
  630.           look similar to this:
  631.  
  632.                       keyb gr
  633.                       date
  634.                       time
  635.                       ......
  636.                       ......
  637.                       cd\gsmenu
  638.                       gsmenu mymenu.men
  639.  
  640.           As with your menu batch file, you can edit AUTOEXEC.BAT with
  641.           the editor GSEDIT. The commands to change to  the  directory
  642.           GSMENU and to load the menu system must be the last commands
  643.           in this file.
  644.  
  645.           PLEASE NOTE:
  646.  
  647.           Batch  files  cannot be loaded direct from the menu, because
  648.           the menu system is such a batch file itself. One batch  file
  649.           cannot  call  another  without  interrupting  the  chain  of
  650.           commands in the calling file.
  651.  
  652.           Under MS/PC-DOS 3.3  and higher  versions, batch filescan be
  653.           loaded direct with the command CALL.
  654.  
  655.           Example (DOS 3.3 and higher):
  656.  
  657.                      *Batch Files (7,7)
  658.  
  659.                          #Word Processing
  660.                              cd\ batch
  661.                              call txtbatch.bat
  662.  
  663.           Under  older versions  of MS/PC-DOS  you will have to load a
  664.           "copy" of COMMAND.COM which  reduces  the  available  memory
  665.           by about 4 KB.
  666.  
  667.           Example (DOS 3.2 and lower):
  668.  
  669.  
  670.               *Batch Files (7,7)
  671.  
  672.                    #Word Processing
  673.                        cd\ batch
  674.                        command /c txtbatch.bat
  675.  
  676.           The  easiest way around this problem would be to include the
  677.           commands in your menu batch file.
  678.  
  679.  
  680.  
  681.           ┌───────────────────────┐
  682.           │ 9.  The ALT-Functions │
  683.           └───────────────────────┘
  684.  
  685.           We  have  assigned some  functions  which are not to be made
  686.           available  to  every  user  of  your   computer  to  ALT-key
  687.           combinations.
  688.  
  689.  
  690.           (a) <ALT-V>      Moving a window
  691.  
  692.           Pressing <ALT> and <V> simultaneously  will get you into the
  693.           "MOVE"  mode.  You can  then  move  the active window to any
  694.           position  on  the  screen, by  using  the  arrow keys or the
  695.           mouse. Pressing  <RETURN> will confirm the present  position
  696.           and  the batch  file  is  automatically changed. Play around
  697.           with this function for a while! It is good fun!
  698.  
  699.           If the Menu-Batch-File is encrypted it is impossible to move
  700.           windows!
  701.  
  702.           (b) <ALT-I>          Miscellaneous settings
  703.  
  704.           - Colour settings
  705.  
  706.           Use  the  arrowkeys  to  select an option from the left hand
  707.           window  and  confirm  with  <RETURN>.  The  options  are  as
  708.           follows:
  709.  
  710.                Color   - Background
  711.                        - Window
  712.                        - Selection
  713.                        - Header and Footer
  714.  
  715.           The bottom line will display the present colour combination:
  716.  
  717.                Foreground - Background
  718.  
  719.           <PgUp> and <PgDn> changes the background colour,  <Arrow Up>
  720.           and <Arrow  Dn> changes the foreground. You cannot of course
  721.           change  the background to the same colour as the foreground.
  722.           When you find a  new  combination  you  like,  confirm  with
  723.           <RETURN>. <ESC> cancels your changes.
  724.  
  725.  
  726.           - Shadow ON or OFF
  727.  
  728.           The tick after the option (√) indicates that the  shadow  is
  729.           displayed.  You  can  switch  it  off  and  on  by  pressing
  730.           <RETURN>.
  731.  
  732.  
  733.           - Set time lock (Seconds until the password is requested)
  734.  
  735.           If  you  set a  system  password, (see (c)  below), you  can
  736.           enter  here  if  and  after  what period of time it is to be
  737.           requested if no key is pressed for the time specified. (This
  738.           can be quite useful if you have to leave your  computer  and
  739.           you want to keep unauthorised persons out of your system!
  740.  
  741.           If you enter "0" (default), no password  will be  requested.
  742.           Any  larger number means that the password will be requested
  743.           after the corresponding number of seconds. Don't  enter  the
  744.           number  "1",  please! Your reactions would have to be pretty
  745.           fast to be able to change this again.
  746.  
  747.  
  748.           - Set dark screen switch (Seconds until dark screen)
  749.  
  750.           If  the  menu  display is  frequently  kept  on your monitor
  751.           screen for long  periods of time it will "burn" very  slowly
  752.           itself onto the  screen  coating. To avoid  this the display
  753.           can be  switched off  if no  key is  pressed for a number of
  754.           seconds which  you  can  specify  here.  The only thing  you
  755.           will see  then  is a box appearing in different positions on
  756.           the screen, which will prompt you to press any key to switch
  757.           the display of the menu back on.  As with the time lock, you
  758.           can disable this function by  setting  the number of seconds
  759.           to "0".
  760.  
  761.  
  762.           - Dark-screen-box
  763.  
  764.           If  you  find  the  jumping box in dark screen mode annoying
  765.           you can switch it off by pressing <RETURN> at  this  option.
  766.           The tick (√) indicates that the switch is set to ON.
  767.  
  768.  
  769.           - Select language
  770.  
  771.           You  can  select  wether the menu text is to be displayed in
  772.           English, German, Italian, French,  Dutch  or  Russian.   You
  773.           should  load a cyrillic screen-driver when selecting Russian
  774.           in order to show the correct letters.
  775.  
  776.           - Save settings
  777.  
  778.           Your settings can be saved and the menu re-activated.
  779.  
  780.           Pressing <ESC> at any time will  cause  all  changes  to  be
  781.           discarded.  That is to say:  you  can play  around  with the
  782.           settings for as long as you like, as long as you do not save
  783.           anything.
  784.  
  785.  
  786.  
  787.           (c) <ALT-P> Set/change system password
  788.  
  789.           You  can enter a general system password here. If a password
  790.           exists already you have to enter it first.
  791.  
  792.           The system password will be requested every time  you  start
  793.           or  leave the menu system. If you have set a time lock, this
  794.           will also activate the request (see above).
  795.  
  796.           Another option is the <F10> key. If you press this  key, the
  797.           program will request the password. This may be useful if you
  798.           have to leave your computer and you  wish to protect it from
  799.           unauthorised access.
  800.  
  801.  
  802.           IMPORTANT: The password does  not  offer one hundred percent
  803.                      protection. There  is no absolute  guarantee that
  804.                      unauthorized users  will not  be  able to  access
  805.                      your data.
  806.  
  807.                      Do not  forget  your password.  If you do so, you
  808.                      will  not  be  able  to access  your own programs
  809.                      again.
  810.  
  811.                      If you cannot think of anything else to use as  a
  812.                      password   but   the  name  of  your  wife,  your
  813.                      girlfriend or your dachshund  (nobody  will  ever
  814.                      guess  that!), you  should at least mix lower and
  815.                      upper case letters.
  816.  
  817.  
  818.           ┌─────────────────────┐
  819.           │ 10. Additional tips │
  820.           └─────────────────────┘
  821.  
  822.  
  823.           (a) Shelling to DOS
  824.  
  825.           To be able to work on  DOS  level  you  should  integrate  a
  826.           command  to  load the DOS command processor COMMAND.COM (see
  827.           above). After loading COMMAND.COM and working on that  level
  828.           you can return to the menu by typing "EXIT".
  829.  
  830.           Example:
  831.  
  832.            #Exit to DOS
  833.                ?PaSsWoRd                <-  your special password
  834.                cls
  835.                echo Type EXIT to return to the menu
  836.                SET PROMPTMARK=%PROMPT%
  837.                PROMPT [GS-MENU active] %PROMPT%
  838.                command
  839.                PROMPT %PROMPTMARK%
  840.                SET PROMPTMARK
  841.  
  842.           In  this  example  the prompt is modified and, after leaving
  843.           the DOS level, changed again to its initial  form,  so  that
  844.           you will not forget the menu in the background.
  845.  
  846.  
  847.           (b) Renaming EXAMPLE.MEN
  848.  
  849.           After  tailoring  your own menu batch file you should rename
  850.           EXAMPLE.MEN to  prevent  it  from  being  overwritten  by  a
  851.           re-installation of GS-MENU (see section 4).
  852.  
  853.  
  854.           (c) Inducing a monochrome display
  855.  
  856.           Some  computers  are  equipped  with  a colour graphics card
  857.           although they only have  a  monochrome  screen,  i.e.   many
  858.           laptops.   The  program  will  automatically  recognise  the
  859.           existence of such a colour card and  attempt  to  produce  a
  860.           colour  display  which  may  lead  to strange results on the
  861.           screen. In such cases you can enter "sw"  as  an  additional
  862.           parameter  when  you  load  the  program  (sw  =  short  for
  863.           "schwarz-weiss" = German for black and white).
  864.  
  865.                 C:\GSMENU> gsmenu example.men  sw
  866.  
  867.           This will disable the automatic recognition  of  the  colour
  868.           card and induce a proper black and white display.
  869.  
  870.  
  871.           (d) Password before leaving the menu
  872.  
  873.           If  you  are  using  a  system  password  and  would like to
  874.           prevent  the menu system from being started  and  left  with
  875.           the  same  password  you can enter a special password on the
  876.           first line of your batch file which will only  be  requested
  877.           when you leave the menu, i.e.:
  878.  
  879.                ?DOSexit        <- Password for leaving the menu on the
  880.                                        first line
  881.  
  882.                   *Main Menu (20,8)
  883.  
  884.                       #Applications
  885.                           %Applications
  886.  
  887.                       #Utilities
  888.                           %Utilities
  889.  
  890.                       #System Commands
  891.                           %System Commands
  892.  
  893.           This has  the  advantage  that,  while  your  secretary  can
  894.           activate  the  password protected menu system every morning,
  895.           she cannot  access  the  operating  system.   It  will  also
  896.           prevent  you  from accidentally throwing out the menu system
  897.           by pressing <ESC>  while  the  main  menu  is  active.   The
  898.           computer  may  be  switched off while the menu is activated,
  899.           without causing any problems.
  900.  
  901.           (e) Calling GS-MENU by PATH
  902.  
  903.           GS-MENU can be called by DOS-PATH: You need  not  change  to
  904.           the Menu-directory to start it.
  905.  
  906.           Write the directory of GS-MENU into the PATH defined in your
  907.           "autoexec.bat":
  908.  
  909.              PATH=C:\;C:MENU;...
  910.  
  911.           NOTE: Sometimes other directories also contain an executable
  912.                 file  called  "MENU".  If  such  a directory is in the
  913.                 PATH-definition before the GS-MENU directory the wrong
  914.                 MENU.EXE  will be called and that will cause problems.
  915.  
  916.           (f) Environment Variables MENUTMP and MENUSYS
  917.  
  918.           As  default,  GS-MENU  uses  its own directory for temporary
  919.           and configuration-files.
  920.  
  921.           You can define other directories by setting the environment-
  922.           variables MENUTMP  (temporary)  and  MENUSYS  (configuration
  923.           files):
  924.  
  925.           SET MENUTMP=h:\gsmenu\tmp\
  926.           SET MENUSYS=h:\gsmenu\tmp\
  927.  
  928.           Please do not forget the backslash "\" at the end!
  929.  
  930.           ┌────────────────────────────────┐
  931.           │ 11. Network (LAN) Installation │
  932.           └────────────────────────────────┘
  933.  
  934.           If  you  own  a  version  of the program which is capable of
  935.           being installed in a network (even the shareware version can
  936.           be  installed  in  a network, but for testing only!) GS-MENU
  937.           can be loaded from all workstations if it is installed in  a
  938.           directory  on  the  server.   Theoretically, the menu can be
  939.           loaded 45,656 times at the same time.
  940.  
  941.           To  tell the program which computer it is being run on it is
  942.           necessary to assign a  number  to  each  workstation.   This
  943.           number  is located in the environment variable and should be
  944.           assigned via the AUTOEXEC.BAT:
  945.  
  946.           Example for a single workstation:
  947.  
  948.                keybgr
  949.                SET GSMENU=1
  950.                .....
  951.                .....
  952.                .....
  953.                e:
  954.                cd\ gsmenu
  955.                gsmenu  overall.men
  956.  
  957.           Please  note  that  each workstation number may be used only
  958.           once. The variable GSMENU can have a maximum length of  four
  959.           characters  (alpha  characters  and  numbers  only!). Longer
  960.           values will cause the menu to crash.
  961.  
  962.           IMPORTANT:
  963.  
  964.           The environment variable GSMENU may only  be  defined  in  a
  965.           program  version which is capable of being run in a network.
  966.           You will recognise such a version by the fact that  it  will
  967.           not crash if the environment variable is defined.
  968.  
  969.           ........Got it?........
  970.  
  971.           <CTRL>+<C>  and  <CTRL>+<BREAK> will be switched off if  you
  972.           call the resident program CTRLC.COM. PLEASE NOTE: If you are
  973.           using a very old AT or a XT, CTRLC.COM does not work!
  974.  
  975.           ┌───────────────────────────────────┐
  976.           │ 12.  External Password Protection │
  977.           └───────────────────────────────────┘
  978.  
  979.           Some  users  of  this program have got "Top-Secret-Programs"
  980.           which  are  protected by  a special  program  which asks for
  981.           passwords. GS-MENU  can  be  made  to  use  those  passwords
  982.           instead of the ones defined in Batch-File and with <ALT+P>:
  983.  
  984.           Define an environmental variable called MENUPASS:
  985.  
  986.               C:\GSMENU> SET MENUPASS=cls;dir;backup c:*.* a:;
  987.  
  988.           This   variable   contains  the  names  of  three  programs,
  989.           separated and ended by ";"
  990.  
  991.           The first one of these programs is  called  when  you  start
  992.           GS-MENU.
  993.  
  994.           The  second  is  called  when  you  press  <F10> or the time
  995.           limitation is activated.
  996.  
  997.           On leaving the menu the last one is called.
  998.  
  999.           ┌────────────────────────────────────────┐
  1000.           │ 13. Provisions/Restrictions of GS-MENU │
  1001.           └────────────────────────────────────────┘
  1002.  
  1003.           - Size of menu batch file up to 64 KB
  1004.  
  1005.           - Up to 18 options per menu window (full screen)
  1006.  
  1007.           - Up to 15 windows open at the same time
  1008.  
  1009.           - Any number of commands under each option
  1010.  
  1011.           - Runs in a network (up to 46,656 workstations)
  1012.  
  1013.           - Mouse support
  1014.  
  1015.  
  1016.           ┌───────────────────────────────────────────┐
  1017.           │ 14.  Limitations of the Shareware Version │
  1018.           └───────────────────────────────────────────┘
  1019.  
  1020.           - NONE (You are only urged to register as a user)
  1021.  
  1022.           - Shareware versions can be run in a network
  1023.  
  1024.           ┌───────────────────────────┐
  1025.           │ 15.  As often as possible │
  1026.           └───────────────────────────┘
  1027.  
  1028.           You  may  copy and  pass on  shareware  versions as often as
  1029.           you wish. (For the full versions  this is only applicable if
  1030.           you are a licensed agent!!!)
  1031.  
  1032.           If  you only own  the full version and would like to pass it
  1033.           on, you can convert it into a shareware version by  deleting
  1034.           the   file   KUNDE  which  identifies  the program as a full
  1035.           version.
  1036.  
  1037.           Other  changes  to the diskette, i.e. to its  size or to the
  1038.           programs may be executed subject to our written agreement in
  1039.           the first instance.
  1040.  
  1041.  
  1042.           ┌───────────────────────┐
  1043.           │ 16. User Registration │
  1044.           └───────────────────────┘
  1045.  
  1046.           Every  author  tends  to believe that he has written a great
  1047.           program.
  1048.  
  1049.           In most cases this is probably true, but as a user with your
  1050.           individual  range  of problems you,  of course, want to know
  1051.           if  this  marvellous  software  can  cope with your specific
  1052.           requirements.
  1053.  
  1054.           We also believe that you are entitled to  expect  good value
  1055.           for your money and we will be glad to hear of any other.
  1056.  
  1057.           We  do  offer  the shareware version of GS-MENU  without any
  1058.           restriction, because  we  believe  that limited versions are
  1059.           not reliable.
  1060.  
  1061.           If, after having tested it thoroughly, you  should intend to
  1062.           continue  using  our  program because you like its features,
  1063.           you can buy the full version at a "ROCK BOTTOM PRICE".
  1064.  
  1065.  
  1066.           ┌──────────────────────────────┐
  1067.           │ 17. Prices of Full Versions  │
  1068.           └──────────────────────────────┘
  1069.           You  can  receive  your  register as a  licensed user of the
  1070.           latest full version of GS-MENU for a mere DM 29.00  (Network
  1071.           version  DM 59.00). You  will  be  supplied with the program
  1072.           immediately after registration.   As well as relieving  your
  1073.           conscience  with a registered version, you will also get rid
  1074.           of our registration  screen  which  tends  to  get  on  some
  1075.           people's  nerves  after  a  while.  You will also help us to
  1076.           develop and launch further improved versions of the program.
  1077.  
  1078.           A  dealer's  version with your name and address or advert on
  1079.           the bottom  line of  the screen can be obtained at a cost of
  1080.           DM 199.00 (network versions DM 399,00). It may be copied and
  1081.           passed on  (but not sold)  as often as you like. Please send
  1082.           us in writing  the  wording  of  the bottom line you wish to
  1083.           display. There are 78 characters at your disposal.
  1084.  
  1085.           [...................... 78 characters .....................]
  1086.  
  1087.           For DM 99,00 you will receive a  program for encrypting your
  1088.           menu batch files which proviceds a special security for your
  1089.           passwords.
  1090.  
  1091.  
  1092.           ┌─────────────────────┐
  1093.           │ 18.  How to proceed │
  1094.           └─────────────────────┘
  1095.           How do you obtain your registered full version?
  1096.  
  1097.           Print the file FORMULAR.TXT, i.e.
  1098.  
  1099.               C:\GSMENU> type formular.txt >prn
  1100.  
  1101.           or call the relevant menu option.
  1102.  
  1103.           You  will  receive a blank  registration  form which you can
  1104.           fill  in  and  return  to us. For a dealer's version we also
  1105.           need the 78 character advert line.
  1106.  
  1107.           Extra charges:
  1108.  
  1109.           Pre-paid delivery (Within GERMANY ONLY)
  1110.  
  1111.           ->      DM  6.00   postage and packaging
  1112.  
  1113.           Cash on delivery    (GERMANY)
  1114.  
  1115.           ->      DM  9.50   postage and packaging
  1116.  
  1117.  
  1118.           Cash on delivery    (OTHER EUROPEAN COUNTRIES)
  1119.  
  1120.           ->      DM 32.00   postage and packaging
  1121.  
  1122.           Please do not  forget to specify  your  exact  address  and
  1123.           a telephone number where you can be reached during the day.
  1124.  
  1125.  
  1126.           ┌─────────────────────┐
  1127.           │ 19. One last Thing  │
  1128.           └─────────────────────┘
  1129.  
  1130.           A  good  and  proven software product is not only defined by
  1131.           the programmer but also by the  requirements  of the market.
  1132.           You, as  a  user, represent the market.  It will always be a
  1133.           problem  for the  programmer  to  write  good  and effective
  1134.           software if he does not  know about the user's requirements.
  1135.           Programs  should, therefore,  always be  developed  in close
  1136.           consultation  with users . Only then it can  be ensured that
  1137.           the  software  will   meet   the  users' needs. This program
  1138.           is the result of such fruitful collaboration.
  1139.           But nevertheless ......
  1140.  
  1141.           ......  please try  to think of anything which might further
  1142.           improve the program and which  features  you  would  like us
  1143.           to add. Let us hear your  suggestions and if they make sense
  1144.           we will include them in further updates.
  1145.  
  1146.           We would be happy  to  hear your individual problems because
  1147.           that  will assist us to write  useful and efficient software
  1148.           that can compete in the market.
  1149.  
  1150.           Help us by writing to us or giving us a ring!
  1151.  
  1152.  
  1153.  
  1154.           NOTE: MS-DOS is a registered trademark  of  Microsoft  Corp.
  1155.                 PC-DOS is a registered trademark of IBM Corp.
  1156.  
  1157.  
  1158.          ... end ...
  1159.  
  1160.