List Directory Requester Help File
                    ----------------------------------

The List Directory Requester allows you to format how each entry will appear
in a directory listing.

The LIST command allows you to send a list of the selected entries in the
active display to your printer or to a disk file.  Each entry will be printed
on a separate line and will include the information you determine in the List
Directory Requester.  Your goal is to create a List String (displayed in the
center of the requester) that SID will use to format each entry it prints.

Here is a list items that you can print for each entry:

    BITS (B)
        The eight protection bits associated with each Amiga file or
        directory.  These are listed below, along with a brief description of
        what it means when a file has that bit set:

            H - Hidden ....... file won't appear in a directory list
            S - Script ....... batch file can be executed as a program
            P - Pure ......... program can be made resident in RAM
            A - Archived ..... file has been saved by an archiving program
            R - Readable ..... file is readable
            W - Writable ..... file can be written to
            E - Executable ... file is an executable program
            D - Deletable .... file cannot be deleted

        The protection bits are printed as HSPARWED.  If the bit is set, its
        corresponding letter will appear.  If the bit is cleared, a hyphen
        will replace that letter.  For example, "H---RWE-" means that the
        file is hidden, readable, writable and executable, but NOT script,
        pure, archived or deletable.

    DATE (D)
        For files, this is the date and time that the file was created or
        last updated (or copied if the CopyDate configuration flag is
        cleared; see the "Copy Date" item in the "Flags" menu for more
        information).  For directories, this is the date that the contents of
        the directory were last changed (i.e. a file was added, changed, or
        deleted).

        Dates are printed in the same manner that they are displayed in the
        directory entries.  Based on the current configuration, dates will be
        printed in either month-day-year, day-month-year or year-month-day
        format.  Dates within the past week may be printed in English
        ("Today", "Yesterday", "Monday", "Tuesday", etc.) or in numeric
        format ("02/03/91, for example).  Times are printed as
        hours:minutes:seconds in either AM/PM or 24-hour format.  You can
        configure these formats with the EditPrefs program.

    DESC (?)
        The entry description which what type of file it is, for example,
        "WordPerfect Document", ".info Icon file", "Manx Object Module", etc.
        SID has the ability to identify files and execute commands based on
        the description of those files.  Supplied with SID is a library of
        file descriptions (the SID.desc file) used to identify files.  You
        can add to this library with the EditPrefs program.

    NAME (N)
        The name of the directory or file.

    NOTE (O)
        The filenote associated with that entry.  AmigaDOS allows you to
        attach notes of up to 70 characters long to files and directories.
        These filenotes can be used for any purpose--to identify the file
        contents, its author, intended use, etc.  SID preserves these
        filenotes for the entire life of a file, even if you change, copy,
        move or rename that file.  If there is no filenote, 70 blanks will be
        printed.

    SIZE (S)
        The size of each file in bytes.  There are no sizes associated with
        directories unless you execute the BYTES command, in which case SID
        will record the total size of the files contained within the selected
        directories.  All sizes are right justified.

Associated with each item of information above is a code (a letter listed in
parentheses above) that appears in the List String to indicate that item of
information is to be displayed for each entry.  Click on the desired button
or press the corresponding letter to add the code to the List String.  Notice
that there is also a button for newlines and blanks.  Whenever SID encounters
a newline in the List String, it will start printing at the beginning of the
next line.  When SID encounters a blank, it will simply print a blank space.

As an example, consider the following List String:

    N D B S/O/

The printed list may look like this:

    Directory.iff                  12/07/90  06:26:34pm ---ARW-D     11536
    Layout of the directory requester

    FileReq.iff                    Yesterday 11:55:16pm ---ARW-D      7242
    File requester layout

    Info.iff                       01/31/91  03:13:01pm ---ARW-D     11498
    INFO command requester

    Info.iff.info                  01/31/91  03:13:01pm H--ARW-D       458


    List.iff                       Today     12:05:44am ---ARW-D      9990
    List directory requester

Based on the List String, the name is printed first, followed by the date
(and time), the protection bits and the file size.  The filenote is printed
at the beginning of the next line.  The newline code at the end of the List
String prints a blank line between each entry.

You can erase the final code entered in the List String by clicking on the
BACKSPACE button or pressing the BACKSPACE key.  You can erase the entire
List String by clicking on the CLEAR button or pressing the DELete key.
There is a limit of 25 codes in the List String.

When you are satisfied with the List String you've created, click on the "OK"
button or press RETURN.  This List String will be saved for use the next time
you execute the LIST command.  You can permanently configure the List String
with the EditPrefs program.

If you decide not to print a directory list, click on the CANCEL button or
press the ESCape key.


LISTREQ  13-Feb-91
© Copyright 1991 Timm Martin
All Rights Reserved Worldwide