home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / a / conix1.lbr / MENU.DZC / MENU.DOC
Encoding:
Text File  |  1993-10-26  |  7.3 KB  |  133 lines
  1.  
  2. Instructions for Installing the ConIX Pull-Down Menu System:
  3. ============================================================
  4.  
  5. Simply  described,  MENU  is a user-friendly  front-end  to  many 
  6. rather  complex  ConIX functions.   Through the use of  different 
  7. levels  of  menus  and built-in help,  the user  will  be  guided 
  8. through many tedious operations with great ease and  reassurance.  
  9.  
  10. The  goal  of  the  Pull-Down Menu System  is  to  eliminate  the 
  11. inconvenience  of  constantly  having to  refer  to  the  printed 
  12. documentation  in  order  to perform  every-day  tasks,  such  as 
  13. enabling   the   Print  Spooler, or  setting  a  Disk   Variable.  
  14.  
  15. Additionally,  the  Menu System interfaces to the  ConIX  PROFILE 
  16. start-up  program  to configure very basic operating  parameters, 
  17. such  as the character sequence used to clear the console  screen 
  18. and   the  directories  used  when  searching  for   a   command.  
  19. Previously,  to  set  these kinds of features,  the user  had  to 
  20. manually  edit his own customized PROFILE and then preprocess  it 
  21. with XCC and install it.  This is now done by MENU automatically.
  22.  
  23. The  source  code  to  the PROFILE that interacts  with  MENU  is 
  24. provided in the ConIX distribution.  The preprocessed PROFILE.COM 
  25. is  also supplied on disk.   PROFILE itself remains the  same  in 
  26. that  changing  a  default setting does not change  the  physical 
  27. PROFILE.COM file.  Instead, MENU manipulates an intermediate file 
  28. PROFILE.SET which contains the configurations.  This file is read 
  29. by  PROFILE when the system is first started and the commands  in 
  30. it executed automatically.
  31.  
  32. Installing  the  Menu  System  is merely a  matter  of  correctly 
  33. positioning  the  files in the  disk  directory.   MENU.COM,  the 
  34. program  executed  to change  system  configurations,  should  be 
  35. accessible  from all disk directories.   In other words,  whether 
  36. you  are working on drive A user area 10 or drive B user  area  5 
  37. you should be able to execute this program. The way to do this is 
  38. to  place MENU.COM in a Search Path directory.   For the  moment, 
  39. drive  A:  user  area  0 is good location since the  Search  Path 
  40. defaults to include this directory.  You can change this later as 
  41. you reorganize your disks to your own preference.
  42.  
  43. More   crucial  is  the  positioning  of  the   PROFILE.COM   and 
  44. PROFILE.SET programs.  In order for these programs to be executed 
  45. automatically,  they  must  be present on the same disk and  user 
  46. area from which ConIX was initially loaded into your system.  For 
  47. example,  if you load ConIX from drive A user area 0, the PROFILE 
  48. files should be stored there.
  49.  
  50. You will of course note that we have not supplied the PROFILE.SET 
  51. file on your ConIX Distribution.  The reason is that  PROFILE.COM 
  52. will create this file automatically the first time it is executed 
  53. by  ConIX.   Therefore,  after  positioning  PROFILE.COM,  simply 
  54. cold  boot  your  system (hit RESET or turn it off  and  on)  and 
  55. PROFILE  should  sign  on  with  a  message  saying  it   created 
  56. PROFILE.SET.   This  message should never appear again unless the 
  57. settings file was deleted somehow.
  58.  
  59. Once  all  the  files  are positioned,  you  can  load  MENU  and 
  60. configure your system as desired.   MENU itself does not give you 
  61. particular  steps  to perform for initial  system  configuration.  
  62. You must first read the ConIX documentation to see what you  want 
  63. to  configure  and  then  use MENU to do  it.   MENU  is  not  an 
  64. installation program, but rather a tool to be used at any time.
  65.  
  66. Invoking  MENU brings us into a little definition of why we  call 
  67. this  a  "Pull-Down"  Menu System.   The reason is  the  way  you 
  68. execute MENU is similar to many modern systems of requesting help 
  69. menus.   ConIX  comes  configured to execute the MENU program  by 
  70. typing a single keystroke - CTRL-B.  Hitting CTRL-B at the system 
  71. prompt  (in the same place you'd hit CTRL-C to reset  the  disks) 
  72. will  cause  MENU to be pulled-down or booted.   Of  course,  you 
  73. could manually enter M+E+N+U+<RETURN>, but hitting CTRL-B is more 
  74. convenient.
  75.  
  76. The  first  time  you execute MENU,  you will be  asked  for  the 
  77. setting of the Clear Screen Sequence,  which is the ASCII control 
  78. string  used to clear the screen and position the cursor  at  the 
  79. top  left  corner  of your terminal.   Since  every  terminal  is 
  80. different,  MENU  must ask you for your particular configuration.  
  81. You do not have to set it here,  but it is preferable that you do 
  82. since MENU would like to clear the screen at certain points if it 
  83. knew how.
  84.  
  85. Consult  the operation manuals for your computer/terminal if  you 
  86. don't know the clear screen sequence.   Most terminals use either 
  87. CTRL-L or CTRL-Z to clear the screen.  In either case, to enter a 
  88. control  character,  type  the `^' and then  the  control  letter 
  89. rather than the actual CTRL-x sequence.  
  90.  
  91. When you finally enter the control sequence,  have MENU set it as 
  92. the  startup default in PROFILE.SET.   This way,  the  next  time 
  93. ConIX is loaded you won't have to reset the CLS sequence.
  94.  
  95. Once all this initial toil is behind you, you will be given quick 
  96. access  to the main menu screen of MENU.   From this menu you can 
  97. select  various  MENU operations.   All choices should  be  self-
  98. explanatory  after reading the ConIX documentation,  as  MENU  is 
  99. just a supplement to ConIX itself.   However, there are a few new 
  100. additons that MENU was able to bring to your system.
  101.  
  102. The  first  is  called ConIX Auto-Load.   It's described  in  the 
  103. manual,  but implemented through MENU and PROFILE.  Briefly, this 
  104. feature  when  set  will cause ConIX to  be  loaded  into  memory 
  105. automatically whenever your system is cold booted.   This is done 
  106. by  placing a $$$.SUB submit file in the boot directory  (usually 
  107. drive A user 0, the directory which you are placed into when your 
  108. system  is first booted.)  This SUB file contains an  instruction 
  109. to  load ConIX,  and then ConIX executes the PROFILE which resets 
  110. this file to Auto-Load the next time you boot.   This feature  is 
  111. rather  convenient,  except the BYE command won't work  properly. 
  112. Use the new replacement for BYE, BYEBYE.COM as provided.
  113.  
  114. Another new MENU feature is that PROFILE can be set to execute or 
  115. chain to another program each time your system is cold booted.  A 
  116. possible  use  for this is to execute a program that  prints  the 
  117. time  and  date  if  your  system  has  a  built-in  clock.   The 
  118. possibilities  are  endless,  and  entirely at  your  discretion.  
  119. Currently,  the  startup  command  feature is  used  to  print  a 
  120. friendly  welcome message,  which you receive whenever PROFILE is 
  121. executed.
  122.  
  123. If you are not familiar with any other terms/features handled  by 
  124. MENU,  refer to the ConIX documentation.   Be reassured, however, 
  125. that   MENU  will  not  change  any  configurations  unless   you 
  126. explicitly  tell  it to.   So,  you can explore all of  the  menu 
  127. features,  read  the short help messages,  and still not make any 
  128. configuration changes.
  129.  
  130. In  total,  the  Pull-Down Menu System should prove to be a  very 
  131. useful and convenient tool for painlessly integrating ConIX  into 
  132. your system.
  133.