
CF VERSION 0.9X

KEYS:

           F1 = View small help      SHIFT-F1 = View large help
           F2 = NC menu
           F3 = Toggle size mode     SHIFT-F3 = Toggle date mode
           F4 = Toggle cursor lock
         F5,? = Information page
           F6 = Create list file     SHIFT-F6 = Create sorted list
           F7 = Create 'batch' file
           F9 = XTGOLD menu
          F10 = Change sort order    SHIFT-F10 = Re-load config file

                        SPACE = View duplicates
                       RETURN = Execute NC extension file entry

         Q,q,Alt-Q,Ctrl-Q,ESC = Clear the screen and exit to DOS
                    X,x,Alt-X = Exit to DOS (no clear screen)

  Home,C-PgUp = First page               PgUp = Page up
  End,C-PgDwn = Last page               PgDwn = Page down
        CsrUp = Previous line          CsrDwn = Next line
      CsrLeft = File left            CsrRight = File right
    C-CsrLeft = Sel mode left      C-CsrRight = Sel mode right

          V,v = View file                 E,e = Edit file
          O,o = Execute XTGOLD batch file

        Alt-V = Auto-view mode          Alt-E = Auto-edit mode
        Alt-O = Auto-batch mode

          T,t = Tag file                  U,u = Untag file
    Space,N,n = Invert file tag        Ctrl-T = Tag all in set
       Ctrl-U = Untag all in set       Ctrl-N = Invert all in set
        Alt-T = Tag all files           Alt-U = Untag all files
        Alt-N = Invert all files

PARAMETERS:

        -SE   Sort file records by extension
        -SL   Sort CF readable output by location (sets -TB)

        -TD   Toggle date display mode
        -TS   Toggle sizes display mode
        -TC   Toggle cursor lock mode
        -TO   Toggle use of mono 'colours'
        -TK   Toggle buffering of keys
        -TB   Toggle batch mode (set by -SL)

        -IL   Ignore locations (don't store them)
        -IM   Ignore EMS (don't use it)
        -IX   Ignore XMS (don't use it)
        -ID   Ignore date field when high-lighting files
        -IT   Ignore time field when high-lighting files
        -IS   Ignore size field when high-lighting files
        -IE   Ignore extensions when sorting file records
        -IU   Ignore duplicate details (don't store them)

        -C    Read file contents rather than storing its details
        -P    Pause until key-press (use before logging diskettes)
        -D    Descend any sub-directories encountered
        -W    Switch day and month order while processing next source

        -F<pattern> = File name patterns, separated by a semi-colon
        -Y<filename>= Change location of temporary file
        -M<letter>  = Switch selection mode (<letter> = ASDUONLHT; if letter is
                                             'T', then set number can follow)
        -V<mode>    = Flip to specified (decimal) video mode and back afterwards
        +           = Append files to last file set

        {<number>   = Loop start <number> times loop
        }           = End-of-loop indicator

ENVIRONMENT VARIABLES:

        (a)   CFTEMPNAME - This holds the name of the temporary file to be used
              by CF when carrying out certain operations.  Note that this string
              will be over-ridden by any '-Y' command that is encountered.

        (b)   CFCFGNAME - Holds the name of the config file.  If it does not
              exist, then a file of the name CF.INI will be sought in the
              directory from where CF was started.

        (c)   CFXTGOLDDIR - Tells CF in which directory to look for XTGOLD files
              that it wishes to access.

        (d)   CFNCDIR - Specifies which directory should be searched for Norton
              Commander files.  If this environment variable doesn't exist, then
              CF will use the standard NC variable, "NC".

CONFIG:

        (a)   PROGARCH <match> <progname> <beforeparams> <afterparams>
              PROGVIEW <match> <progname> <beforeparams> <afterparams>
              PROGEDIT <match> <progname> <beforeparams> <afterparams>

        (b)   PARAMETER <parameter>

        (c)   VARIABLE <environment-variable-name> <value>

        (d)   RECOGNISE <file-extension-with-dot>

NOTES:

        (a)   The -SL option automatically sets the -TB option

        (b)   CF can only access .ARC and .ZIP files to extract a list file or
              edit and view text files, if you have a relevant program on your
              search path.

        (c)   Certain parameters can be concatenated together.  Any from one
              'class' can be grouped.  For example, if you want to ignore file
              extensions and sizes, use '-IES' instead of '-IE -IS'.

        (d)   If you use a drive letter on its own (say, 'C:'), this is
              processed as if you'd specified a recursive descent of the
              corresponding root directory.  (In the previous example, it would
              act as if you had used '-D C:\'.)

        (e)   The emulation of the NC extension file system is not complete.
              However, it seems to work most of the time.  CF actually converts
              the special "!" entries, in the NC extension file, into XTGOLD "%"
              equivalents.  Also, the NC menu is handled by reading the NC menu
              file and creating a (temporary) XTGOLD menu file, so the XTGOLD
              limits (number of entries and number of lines per entry) also
              apply to NC menus displayed via CF.

        (f)   If the NC menu or extension files are editted from within CF, the
              changes take effect straight away.  I believe that this is NOT the
              case with Norton Commander itself, where it only appears to read
              these files at start-up.

        (g)   Environment varibles defined by using "VARIABLE" lines in the
              config file OVERRIDE the real MS-DOS environment defintions since
              CF searches the config file contents before looking in the MS-DOS
              environment.

        (h)   Graphics video modes, specified using the -V parameter, will NOT
              work because of the window libraries used by CF.

EXAMPLES:

        (a)   CF C: + D: + E: + F: -SE

              This will log all files on all drives (on my machine) into one
              file set.  The files will be in extension order.  Note that there
              will only be ONE file set.

        (b)   CF C: D: E: F: -MT2

              This will log all the files, as above, but the files on each drive
              will be in a separate file set.  The files will be sorted by file
              NAME rather than file extension.  At start-up, the mode will be
              such that all the files in file set two (that is, those of drive
              D:) will be shown.

        (c)   CF {3 -P A: }

              This will compare the files from three different diskettes.  CF
              will pause before each diskette is logged.

        (d)   CF -F*.DEF;*.MOD -D -C \*.ZIP

              Using an external program, examine the contents of all .ZIP files
              on the default drive, but, from these .ZIP files, only log .DEF
              and .MOD files.

        (d)   CF -F*A.* C:

              Find all files, on drive C:, where the "root" of the file name
              ends with an "A".  Note that if you try this in a normal MS-DOS
              command, you'll get ALL files - the -F parameter uses a much
              better string matching algorithm.

