.**********************************************************************
.*  FLIX help file.                                                   *
.*                                                                    *
.*  Dot commands:                                                     *
.*                                                                    *
.*    .* Comment. Will not appear on screen.                          *
.*    .t The title. 1-8 Character Title.                              *
.*    .r Other references. Total of 9, 1 - 8 Characters each.         *
.*    .x Start and end of text description for this title.            *
.*                                                                    *
.*--------------------------------------------------------------------*
.t (c)1991
.x

   FLIX Version 1.10

   The program and help text are (c) Copyright 1990, 1991 by:

          HK Square Inc.
          24-16 Steinway Street, Suite 580.
          L.I.C., NY 11103
          (718) 728-5077

   Portions of the help text are
   (c) Copyright 1985, 1986, 1987 by Codecrafters.

   This program is dedicated to all our Beta Testers for their help
   in producing FLIX and the FLIX help system.

   Thanks guys !
.x

.**********************************************************************
.t FLIX=
.r Syntax
.x

 FLIX Environment variable settings

 A user can set the DOS Environment variable FLIX to contain the
 correct path to the FLIX.HLP and FLIX.PRO files.

 Please note that any FLIX.HLP and FLIX.PRO found in the current
 directory will always be used first.

 Example:

   SET FLIX=C:\FLIX\

 The ending backslash is not required.
.x

.**********************************************************************
.t Syntax
.r Commands Keys Profile Screen
.x

 FLIX command syntax and command line options


     FLIX [filespec] | options |

 Where:

     filespec is any valid DOS partial or full file name

     The usual DOS file specification characters like '*' and '?'
     are allowed. Omitting filespec defaults to the current
     sub-directory.

     options can be any of the following:

     /q             - Do not display that annoying initial
                      copyright screen.

     /h[help_file]  - Use the help file specified instead of the
                      one pointed to by the FLIX or PATH environment
                      variables.

     /p[profile]    - Use the profile file specified instead of the
                      one pointed to by the FLIX or PATH environment
                      variables.
.x

.**********************************************************************
.t Commands
.r Keys Function Profile
.x

 FLIX  Commands

 All the following commands may be entered at the FLIX command line or
 assigned to a F-Key or macro.

───────────────────────┬───────────────────────────────────────────────────────
                       │
   /                   │ Position Current File at top of display
   /nnn                │ Position File "nnn" at top of display
   /A   [filespec]     │ Append Group "filespec" To File List
   /B                  │ Scroll To Last Page Of File List
   /C                  │ Terminate All File List Levels Immediately
   /F   {name.ext | =} │ Find "name.ext" Or Next Occurance Of Previous Find
   /H                  │ Display The Helpfile
                       │
   /L{- | + | n}       │ Select Previous Level, Next Level Or Level "n"
   /L   [filespec]     │ Create New File List Level Using "filespec"
                       │
   /O   command        │ Do Not Append File Specification To This "command"
   /Q                  │ Terminate Current File List Level Immediately
   /R   [filespec]     │ Read Directory To Create File List Using "filespec"
                       │
   /SA                 │ Sort By file Attributes
   /SD                 │ Sort By Date/Time (D), Name, Group and Extension (A)
   /SE                 │ Sort By Extension, Name And Group (A)
   /SG                 │ Sort By Group, Name And Extension (A)
   /SN                 │ Sort By Name, Group And Extension (A)
   /SS                 │ Sort By Size (D), Name, Group And Extension (A)
   /SX                 │ Sort By File Description
                       │
   /T                  │ Scroll to First Page Of File List
   /X                  │ Execute Command Input Area
                       │
   /W                  │ Toggle the cursor between command line and file
                       │ description. If your screen does not show
                       │ the file descriptions then use this command !
                       │
   /=                  │ Position the cursor on column 1 of the next line
                       │ and insert a '=' there.
                       │
   =                   │ Repeat Last DOS Command
   ?                   │ Recall Last DOS Command
                       │
───────────────────────┴───────────────────────────────────────────────────────
.x

.**********************************************************************
.t Keys
.r Commands Function Profile Tab
.x

 FLIX Keyboard interface

 The following key sequences may be used to perform a variety of FLIX commands.
 These key sequences work in all the screen areas.

───────────────────────┬───────────────────────────────────────────────────────
                       │
   Tab                 │ Move cursor to the next editable field
   Shift-Tab           │ Move cursor to the previous editable field
                       │
   Home                │ Move cursor to the beginning of current field
   End                 │ Cursor to end of current screen area
   PgUp                │ Display previous page of file list
   PgDn                │ Display next page of file list
   Left                │ Cursor left
   Right               │ Cursor right
                       │
   Ctrl-Home           │ Cursor to first file of current page
   Ctrl-End            │ Erase to end of current screen area
   Ctrl-PgUp           │ Display first page of file list
   Ctrl-PgDn           │ Display last page of file list
   Ctrl-Esc            │ Erase all command input areas
   Ctrl-Right          │ Move to the beginning of the next word
   Ctrl-Left           │ Move to the beginning of the previous word
   Ctrl-Enter          │ Move to the beginning of the next line
                       │
   Up                  │ Cursor up
   Down                │ Cursor down
   Ins                 │ Toggle insert and replace mode
   Del                 │ Delete character
   Esc                 │ Restore field to original contents
   Backspace           │ Rubout character
   Scroll Lock         │ Toggle file list scroll and wrap-around mode
   Enter               │ Execute all commands in this list
                       │
───────────────────────┴───────────────────────────────────────────────────────

 The following key sequences may be used only in the file description area.

───────────────────────┬───────────────────────────────────────────────────────
                       │
   Alt-L               │ Mark a line for copying.
   Alt-Z               │ Mark a line for copying. Used as an alias to Alt-L.
   Alt-C               │ Copy the marked line description to the current
                       │ description.
                       │
───────────────────────┴───────────────────────────────────────────────────────
.x

.**********************************************************************
.t Functions
.r Commands Keys Profile
.x

 FLIX command line functions/enhancements

 The following command sequences can be used to insert part (or all) of the
 current file specification to the command line.

───────────────────────┬───────────────────────────────────────────────────────
                       │
   //                  │ Insert a single slash at this position
                       │
   /                   │ Insert complete fileid at this position
   /D                  │ Insert "d:" component at this position
   /E                  │ Insert ".ext" component at this position
   /N                  │ Insert "filename" component at this position
   /P                  │ Insert "path" component at this position
                       │
   /O                  │ When put at the beginning of a command it will
                       │ indicate that no path component will be appended
                       │ to the command that follows.
                       │
───────────────────────┴───────────────────────────────────────────────────────
.x

.**********************************************************************
.t Profile
.r Commands Keys Function
.x

  FLIX profile commands

  The following commands can be used in the FLIX profile file.

───────────────────────┬───────────────────────────────────────────────────────
                       │
   *                   │ Insert a comment line on the profile
   ALTER   a a a ... a │ Define which screen fields can be altered
   ATTR    a a a ... a │ Define display attributes
   CHAR    c c c       │ Define command, concatenation and cursor characters
   DEFINE  k = [n] cmd │ Define function key with display name and command
   EXECUTE command     │ Execute flix or dos command during initialization
   FILEID  dpne        │ Define fileid components
   FIATTR  1 1 1 1     │ Define the file attributes used to select files
   MACRO   k = cmd     │ Define macro (alternate) key with command
   OPTION  opt1 ...    │ Set FLIX options
   SYNONYM alias cmd   │ Define synonym of dos command
                       │
───────────────────────┴───────────────────────────────────────────────────────
.x

.**********************************************************************
.t Screen
.r Commands
.x

  FLIX screen fields

  These are the fields in the FLIX screen. The TAB key can be used to move
  between the FILE, Command Line, File Data, and File Description areas.
  The Profile command: ALTER controls which fields can be TAB'ed into.

─────────────────────────────────────────────────────────────────────────────────
 Title Area
─────────────────────────────────────────────────────────────────────────────────

 File Selection Group Area

─────────┬──────────────┬──────────────┬─────────────────────────────────────────
         │              │              │
 File    │ Command line │ File data    │ File description
         │              │              │
 Area    │ Area         │ Area         │ Area
         │              │              │
         │              │              │
         │              │              │
         │              │              │
         │              │              │
         │              │              │
─────────┴──────────────┴──────────────┴─────────────────────────────────────────

 F-Key definition display Area

─────────────────────────────────────────────────────────────────────────────────
.x

.**********************************************************************
.t Tab
.r Commands Keys
.x

  TAB key function description.


  The TAB key allows you to move the cursor to any editable field in the screen
  and make changes there.

  Editable fields are Name, Extension, Attribute, Date, Time and Description.
  Just type in the changes you wish to make and next time you hit the Enter
  key, the changes will be permanent ! The extent of changes can be fully
  controlled from the profile setting of the ALTER command.

  Example:

    TAB once and you will be put in the Attribute field. Now typing the letters
    A, S, R, or H will set those attributes for that file. Typing the letter
    again will toggle the attribute.

    The ESC key will reset the field to it's original contents. Hit the Enter
    key to make the changes permanent. It's that simple !

  Shift-Tab will Tab you backwards through the fields.

  A 'changed' field has different display attributes for easy viewing.

  As you can see, changing the name of a file is as simple as TAB'ing
  to the NAME field and just typing in the new name.
  ───────────────────────────────────────────────────────────────────────────────

  The profile command: ALTER, fully controls the changes made to a field
  after you TAB there. ALTER allows:

    a. No changes to a field if so desired. You can't TAB to a field that
       does not allow changes.

    b. Changes to a field but will prompt the user (if he's sure) when the
       user leaves the field. Good for name and extension fields.

    c. Changes to a field but will beep when the user leaves the field.
       Good for the Attribute, date and time fields.

    d. Changes to a field with no prompt whatsoever when the user leaves the
       field. Great for the description field.

  Note: When you are in the Name field, typing the '.' (period) character
        will TAB you to the Extension field.

  FLIX, with the TAB key, gives great power to the experienced DOS user.

  Caution is advised !!!
.x

.**********************************************************************
.t DOS
.r Commands
.x

  Shelling out to DOS from FLIX


  To shell out to DOS from FLIX, just type DOS on any command line. The
  current command processor (as defined by the COMSPEC environment variable)
  will be invoked.

  If the COMSPEC environment variable is not defined then an attempt is
  made to run COMMAND.COM from the root directory. If that fails an error
  message will be displayed.
.x

.**********************************************************************
.t /
.r Commands
.x
 Syntax

   /

 Description

   Position current file at top of display.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /nnn
.r Commands
.x
 Syntax

   /nnn

 Description

   Position file "nnn" at top of display.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /A
.r Commands
.x
 Syntax

    /A   [filespec]

 Description

   Append group "filespec" to current file list.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /B
.r Commands
.x
 Syntax

   /B

 Description

   Scroll to last page of file list.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /C
.r Commands
.x
 Syntax

   /C

 Description

   Terminate all file list levels and exit from FLIX immediately !

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /F
.r Commands
.x
 Syntax

   /F {name.ext | =}

 Description

   Find "name.ext" or next occurance of previous find.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /H
.r Commands
.x
 Syntax

   /H

 Description

   Invoke Help.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /L
.r Commands
.x
 Syntax

   /L{- | + | n}

 Description

   Select Previous Level, Next Level Or Level "n".


   or


   /L   [filespec]

 Description

   Create New File List Level Using "filespec".

 Comments

   Both forms of the command can be issued from the flix command line
   area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /O
.r Commands
.x
 Syntax

   /O

 Description

   Do not append file specification to this "command".

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /Q
.r Commands
.x
 Syntax

   /Q

 Description

   Terminate current file list level immediately.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /R
.r Commands
.x
 Syntax

   /R   [filespec]

 Description

   Read directory to create file list using "filespec". When "filespec"
   is ommited this command becomes a refresh command.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /SA
.r Commands /SE /SD /SG /SN /SS /SX
.x
 Syntax

   /SA

 Description

   Sort by Attribute, Date/Time, name, group and extension.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /SD
.r Commands /SA /SE /SG /SN /SS /SX
.x
 Syntax

   /SD

 Description

   Sort by Date/Time (d), name, group and extension.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /SE
.r Commands /SA /SD /SG /SN /SS /SX
.x
 Syntax

   /SE

 Description

   Sort by extension, name and group.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /SG
.r Commands /SA /SD /SE /SN /SS /SX
.x
 Syntax

   /SG

 Description

   Sort by group, name and extension.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /SN
.r Commands /SA /SD /SE /SG /SS /SX
.x
 Syntax

   /SN

 Description

   Sort by name, group and extension.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /SS
.r Commands /SA /SD /SE /SG /SN /SX
.x
 Syntax

   /SS

 Description

   Sort by size (d), name, group and extension.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /SX
.r Commands /SA /SD /SE /SG /SN /SS
.x
 Syntax

   /SX

 Description

   Sort by file description.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /T
.r Commands
.x
 Syntax

   /T

 Description

   Scroll to first page of file list.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /X
.r Commands
.x
 Syntax

   /X

 Description

   Execute Command Input Area.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /W
.r Commands Screen
.x
 Syntax

   /W

 Description

   /W stands for sWitch. This command toggles the cursor between command
   line and file description. If the screen is not wide enough to show
   the file descriptions, then the file stats will be hidden and the
   file descriptions will be shown in their place. /W will then toggle
   between descriptions and file stats.

   The OPTION profile command controls whether the file stats or the file
   descriptions will be shown if the screen is not wide enough to show
   both.

   One of the most usefull commands when working with file descriptions.

   Try it !

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t /=
.r Commands = ?
.x
 Syntax

   /=

 Description

   Position the cursor on column 1 of the next line and insert a '=' there.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
   Most usefull when assigned to a F-Key to easily repeat a command
   on most of the files in the current list. Try this one !

   Note: To avoid potential hazardous situations, files that begin
         with '.' will not get the equal sign inserted there !
.x

.**********************************************************************
.t =
.r Commands /= ?
.x
 Syntax

   =

 Description

   Repeat last DOS command or command issued from the Command Line Area.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x

.**********************************************************************
.t ?
.r Commands = /=
.x
 Syntax

   ?

 Description

   Recall last DOS command or command issued from the Command Line Area.

 Comments

   Issued from the FLIX Command line area or assigned to an F-key or macro.
.x
