EDFORM
------

Format:        EDFORM

Purpose:       Allows  the  CONVERT  command's  CP/M   format 
          database to be edited and updated.

Use:           EDFORM  is a menu driven program,  and  allows 
          the adding, deleting and editing of CP/M formats in 
          the  FORMDATA.DAT file used by the CONVERT utility. 
          Only very technical user's are likely to use it.

               When it starts up, EDFORM looks in the current 
          directory  of the current drive for the  data  file 
          FORMDATA.DAT.  The main menu is then displayed,  as 
          follows:


               A) ADD a format

               E) EDIT a format

               D) DELETE a format

               X) EXIT and save

               Q) QUIT no save


                    One  of the available options may then be 
          chosen.  The first three options allow the database 
          to be changed,  whilst the forth option allows  the 
          new  database to be saved and the FORMDATA.DAT file 
          updated.  The last option allows the program to  be 
          exited  without  saving any changes that  may  have 
          been made.

               The D option,  when chosen, displays the names 
          of  the  currently  defined formats in pages  of  8 
          types per page, and allows one of the formats to be 
          selected.   It  will  then  be  removed  from   the 
          database.

               The  E  option  similarly allows  an  existing 
          format to be chosen.  Once chosen,  it's parameters 
          will  be  displayed as described below and  can  be 
          edited.

               The A option will add a new format to the  end 
          of  the  database with default values for  all  the 
          parameters.  It will then behave as the E option in 
          allowing the format to be edited.

                    When  editing  a format,  each CP/M  disk 
          parameter  is displayed on a separate line  of  the 
          screen.  The  joystick  can be used to move up  and 
          down between parameters so they can be changed. The 
          editing  screen displays the parameters as  follows 
          (with the default values shown):


          Format name:
          Default format: N

          HARDWARE PARAMETERS
             Single/Double density.. D
             Number of sides........ 1
             Tracks per side........ 40
             Sectors per track...... 8
             Sector size............ 512

          SOFTWARE PARAMETERS
             Block size (K)......... 1
             Reserved tracks........ 1
             Directory entries...... 64
             First physical sector.. 1

          Translate table: N


               The format name is an arbitrary name chosen by 
          the user, and is the name used to select the format 
          in the CONVERT program.  The parameter for "Default 
          format" can be either Y or N,  and if Y is  chosen, 
          then  the  CONVERT program will use this format  by 
          default when it starts up.

               The  "hardware parameters" allow the  physical 
          format of the disk to be selected,  and control the 
          parameters  that the CONVERT program gives  to  the 
          disk controller hardware. The "software parameters" 
          control  the  actual  CP/M  format.  See  the  CP/M 
          technical documentation for details.

               The  parameter  to  "translate table"  can  be 
          either  Y  or  N.   If  Y  is  chosen,   then   the 
          appropriately-sized  sector  translation  table  is 
          printed,  and  the joystick can be used to move the 
          cursor  to any of the sector numbers in  the  table 
          for editing.

               Once  the format has been edited,  ctrl-C will 
          return  to  the  main  menu  without  updating  the 
          database  in memory,  and ESC will return with  the 
          newly  edited format.  Once back at the main  menu, 
          the  X option must be chosen to actually write  the 
          database to disk.

               Note  that this is a  transient  command,  and 
          must be loaded from disk.

Examples:

          EDFORM
