


                        YAFM  V2.1a
              Copyright (C) H.Snip 1991-1993




1. Introduction


     This manual is not complete yet. As it is now this manual
     briefly discusses all built in commands.
     This manual should be read as an addition to the help text.

     In the future this manual will be extended with background
     information, description of default macro's etc.

     For now you this is all there is for unregistered versions.

     Each command will be discussed in a separate chapter. The
     title of the chapter will have the name as it is used in
     the source code.
     The key to activate the command with is also included in
     the title between braces ().



2. RestoreDosScreen (' ')


     This command will restore the dos screen. The application
     screen (yafm screen) will be restored by pressing any key.



3. ToggleEgaMode (F12)


     This command toggles the screen between ega mode (50 lines
     of 80 charactes) and normal mode (25 lines of 80 characters).



4. Quit ('Q')


     This command will quit yafm unconditionally.



5. ToLeftPanel (KEY_LEFT)


     This command positions the cursor to the left panel when
     the cursor was positioned in the right panel.
     This command has no affect when the cursor was already
     positioned in the left panel.

     Yafm remembers the cursorposition within a panel when a
     panel is left and tries to restore that position when the
     panel is entered again.

     When the directory of the panel is not valid any more (eg.
     it is deleted from disk or a floppy disk has been removed)
     the program will perform a reload operation.



6. ToRightPanel (KEY_RIGHT)


     This command positions the cursor to the right panel when
     the cursor was positioned in the left panel. See
     "ToLeftPanel" command for a more detailed description of
     this command.



7. ToOtherPanel (KEY_TAB)


     This command positions the cursor to the opposite panel.
     This means that the cursor is positioned in the left panel
     when the right panel was the active panel and vice versa.

     See ToLeftPanel for a more detailed description of this
     command.



8. AttributeCmd ('A')


     This command lets you change the file attributes of a file
     or a list of marked files.

     When you activate the command a dialogue box will appear
     prompting you to specify the file attributes.

     The following file attributes can be changed:

          Read only attribute:  'R'
          Hidden attribute   :  'H'
          System attribute   :  'S'
          Archived attribute :  'A'

     You can change each attribute in a single command. The new
     values for the attributes are displayed in the input line
     of the dialogue box. The new values will be displayed as
     follows:

     Letter 'X'                              =>   Attribute is
                                                  not changed
     Uppercase letter ('R', 'H', 'S' or 'A') =>   Attribute is
                                                  SET
     Lowercase letter ('r', 'h', 's' OR 'a') =>   Attribute is
                                                  cleared

     Initially you will see four 'X' characters specifying that
     you do not want to change file attributes.

     To change an attribute you have to enter the letter
     corresponding to the attribute. The affect of this is that
     the letter in the dialogue box changes from 'X' (no change)
     to Uppercase letter (Set attribute) to Lowercase letter
     (Clear attribute).

     The attributes will be setup as specified when you press
     enter. The command can be cancelled by pressing escape.




9. CopyCmd ('C')


     The copy command copies a file or a list of marked files.
     When you activate this command a dialogue box appears
     prompting you to enter the destination for the file or
     marked files.
     By default the directory name of the opposite panel will be
     used since that is the most common way to copy files in
     yafm.

     When you have specified the target (or when the default
     suits your needs) you can simply press enter to start the
     copy action. You can press escape to abort the copy action.



10. DeleteCmd (KEY_DEL, 'D')


     The delete command deletes a directory tree, a file or a
     list of marked files. When you activate this command a
     dialogue box appears prompting you to confirm the delete
     action. This allows you to change your mind.



11. RenameCmd ('R')


     The rename command renames a file or a list of marked
     files. When you activate this command a dialogue box
     appears prompting you to enter the destination for the file
     or marked files. By default the directory name of the
     opposite panel will be used since that is the most common
     way to rename files in yafm.

     When you have specified the target (or when the default
     suits your needs) you can simply press enter to start the
     rename action. You can press escape to abort the copy
     action.

     When the target file specifies an other physical drive the
     file will first be copied and then be deleted from the
     source drive. The character 'M' (move) will be used by yafm
     instead of 'R' (rename) in that case.



12. ToSon ('V', KEY_ENTER)


     The ToSon command will change the default directory to the
     subdirectory that the cursor is located on. This command
     will result in an automatic reload (of course).

     When the cursor is located on the parent directory (..) the
     directory is  entered as if it was a sub directory.

     The toson command can only be performed when the cursor is
     on a directory.
     The keys to activate this command may have other meanings
     when the cursor is located on a file.



13. ExecuteDosCmd ('X')


     The executedoscmd command will execute a dos command from
     within yafm.
     You may specify file jokers as arguments to the dos
     command.

     This command behaves somewhat different than other
     commands. The behaviour of this command depends on wether
     or not there were marked files and wether or not you have
     specified file jokers in the dos command.

     Ŀ
      Marked files  File jokers  Behaviour                 
     Ĵ
      NO            NO           Command will be executed  
                                 as is                     
      NO            YES          Command will be executed  
                                 for current file          
      YES           NO           Command will be executed  
                                 as it is                  
      YES           YES          Command will be executed  
                                 for marked files          
     

     When the cursor was located on an executable file (.com,
     .exe, .btm or .bat) the name of that file will be used as
     default.

     This command can be tuned by the user as if it is a macro.
     You can specify wether or not YAFM should swap to disk before
     executing the command.
     Swapping to disk before executing a command allows you to
     preserve as much memory as possible for the command (program)
     to be executed.

     To tune the behaveiour of this command you simply define a
     macro and press 'X' as the macro hot key.



14. First (KEY_HOME)


     This command will locate the cursor to the first entry in
     the panel.




15. Last (KEY_END)


     This command will locate the cursor to the last entry in
     the panel.



16. Previous (KEY_UP)


     This command will locate the cursor to the previous entry
     in the panel.
     This command has no affect when the cursor is already
     located at the first entry



17. Next (KEY_DN)


     This command will locate the cursor to the last entry in
     the panel.
     This command has no affect when the cursor is already
     located at the last entry.



18. PrevPage (KEY_PGUP)


     This command will locate the cursor one page back in the
     panel.
     This command has no affect when the cursor is located on
     the first entry.



19. NextPage  (KEY_PGDN)


     This command will locate the cursor one page ahead in the
     panel.
     This command has no affect when the cursor is located on
     the last entry.





20. ToggleStatusDisplay (KEY_F9)


     This command will toggle the status display. The status
     display is the area below the panel.
     The status can be toggled between:

     DateTimeStatus  :   The filename and its date and time is
                         displayed.
     SizeAttrStatus  :   The filename and its size and
                         attributes is displayed.
     DiskStatus      :   The number of free bytes and used bytes
                         is displayed.
     ListSta         :   The number and size of files in the
                         current panel is displayed.



21. ToggleListDisplay (KEY_F10)


     This command will toggle the list display. The list display
     is the area that contains the list of files for a panel.
     The list display can be toggled between:

     DateTime  :    The filenames plus dates and times are
                    displayed.
     SizeAttr  :    The filenames plus sizes and attributes are
                    displayed.



22. ReLoad  ('L')


     Reloads (refreshes) information in the panel. The disk is
     reread.



23. ToggleMark ('KEY_INS)


     The marker of the file under the cursor is toggled. When
     the file was not marked it is marked. It is unmarked
     otherwise.
     This command only works for files.
     Files that are marked will have the marker '*' before the
     filename.



24. MarkAll (KEY_GR_PLUS)


     Marks all displayed files in the panel. Files in the panel
     that are filtered out are not marked and will not be
     referred to.




25. UnMarkAll (KEY_GR_MINUS)


     UnMarks all files in the panel.



26. InvertMarks ('I')


     Works like the "ToggleMark" command but it works on all
     files in the panel. Files that are unmarked will be marked,
     files that were not marked will be marked.



27. RestoreMarks ('O')


     Restores old marks (indicated by a '.' before the
     filenames) to a normal mark ('*').



28. ToParent (KEY_ESC, KEY_ENTER, 'V')


     The ToParent command will change the default directory to
     the parent.
     This command will result in an automatic reload (of
     course).

     The ToParent command can only be performed when the cursor
     is on a directory when keys KEY_ENTER or 'V' are used.
     The keys to activate this command may have other meanings
     when the cursor is located on a file.

     The escape key should work always.



29. FilterCmd ('F')


     This command temporarily hides files that you are not
     interested in.
     This command is useful when you have a long directory
     listing and you are only interested in a group of specific
     files. Eg. you can use the filter command to display only
     .txt files.
     It is also possible to specify multiple groups. Filter
     specifications have to be separated by a ' ', ',' or a ';'
     in that case. Eg "*.cpp,*.h" will display only .cpp and .h
     files.

     When you activate this command a dialogue box appears which
     prompts you to enter a filter specification. As a default
     "*.*" is used.




30. SortCmd ('S')


     The sort command allows you to sort the files in the panel.

     The following sort modes are available:

     D,T ==>   Date / Time,   Newest entries are displayed
                              first.
     S   ==>   Size       ,   Smallest files are displayed
                              first.
     N   ==>   Name       ,   As you should expect, 'A' comes
                              before 'Z'
     E   ==>   Extension  ,   Within extension entries are
                              sorted by name
     U   ==>   Unsorted   ,   For fastest reload.



31. NewDiskCmd ('N')


     Allows you to specify a new drive and / or directory for
     the panel.
     The panel will be reloaded after that to show the contents
     of that new drive and / or directory. The file filter
     specification will not be changed however.



32. MakeDirCmd ('M')


     Creates a new directory under the current one. When the
     directory was created successfully it is entered.


