8                Freeware CD-ROM Software and Organization    G ** The CD-ROM disk will be referenced as  CDROM:  in this discussion **   > ** To test, you can just define a rooted logical of CDROM: by:8        $ define/process cdrom mydisk:[cdrom.]/trans=conc    # To active the FREEWARE menu system: # -----------------------------------   !   $ @cdrom:[freeware]freeware.com      This command file will:   B   o  set up the FREEWARE$CD:   logical to point to this disk driveC   o  set up the FREEWARE$LOC:  logical to point to cdrom:[freeware] ,   o  set up logicals used by the menu system   o  active the menu system      The menu system  ---------------   A The INTOUCH 4GL base menu system will use a small database called    FREEWARE$LOC:MENU_INFO  D This database will have previously been built using the TTI supplied procedure BUILD_MENU_INFO.INT.       BUILD_MENU_INFO.INT  -------------------   E This INTOUCH 4GL based procedure should be run *prior* to burning the B master CDROM disk.  The procedure scans the directory structure as follows:  G      Scan CDROM:[000000...]FREEWARE_README.TXT  -- if found, stores the 7      directory name into MENU_INFO database.  Opens the H      FREEWARE_README.TXT file and reads the FIRST text line.  It expects!      the first line to look like:   4         PACKAGE_NAME, CATEGORY, ONE_LINE_DESCRIPTION        for example:   K         INTOUCH 4GL, LANGUAGE, High-performance 4GL for VAX and AXP systems   H      The one-line descriptions will be truncated to 60 characters.  ThisG      will allow them to display nicely on the selection menus later on.   G      The PACKAGE_NAME, CATEGORY and ONE_LINE_DESCRIPTION are all stored !      into the MENU_INFO database.   G      Any additional lines of text in the FREEWARE_README.TXT file will  H      be displayed to the user from the MENU SYSTEM, if they choose this       package from the menu.     6      Lines preceeded by a "!" are ignored as comments.  H      If there is a FREEWARE_DEMO.TXT file, this is noted.  If there is a0      FREEWARE_DEMO.COM file, this is also noted.  H      The FREEWARE_DEMO.TXT file is text that can explain how to try thisC      software...or explains what the FREEWARE_DEMO.COM file will be       showing the user.  <      If the user selects this package from the menu system, 1      the FREEWARE_DEMO.COM file will be executed.      MNEU_INFO database ------------------  D The MENU_INFO database is an INTOUCH data structure that consists of these three RMS file types:   B    MENU_INFO.DAT  -  index file based on package name and category  ,    MENU_INFO.DEF  -  INTOUCH data dictionary  ;    MENU_INFO.STR  -  INTOUCH specific structure information      Data elements are:  ;    PACKAGE   name of this package  (INTOUCH, or BLISS, ...) A    CATEGORY  software category (language, tool, application, ...) @    DESC      short description of the package (<60 characters??).    DIR       directory location of the package9    DEMO_TXT  is a FREEWARE_DEMO.TXT available to display? J    DEMO_COM  can a demo be run by the user using a FREEWARE_DEMO.COM file?      
 Misc Files
 ----------  G In [FREEWARE] is the file  FREEWARE_HELP.TXT.  When a user chooses HELP ; from the Freeware menu, this is the file that is displayed.   3 FREEWARE.DOC is this file that you are reading now.   E FREEWARE_COPYRIGHT.COM contains Digital Copyright information and the 7 FREEWARE CD-ROM version number (for software tracking).   