Amiga ISO Collection/AmigaUtilCD2.iso/Sound/Player/sid103.lha/ConfigDocs

Text File | 1989-09-23 | 19.8 KB | 485 lines

                                ConfigDocs
                                **********


This file describes in detail the setup, operation, and maintenance of the
SID configuration file.  You can completely customize SID to your needs and
environment with the configuration file.  Because the configuration changes
as often as SID does, I've opted to place the instructions in this separate
file.  This file assumes you have read the SID.docs and have used SID enough
to be familiar with the terms describing the SID functions.


Why the config file is needed
-----------------------------

SID will run on its own without the configuration file, though you will be
restricted to using the defaults that are hardcoded into the program.  I must
admit that I set these up for my system, but hopefully you will find that
many of these defaults will suit you as well.  Of course, once the program is
running, any of these default settings may be changed.

In all likelihood, however, there will be some defaults that you will need to
alter.  This is where the configuration file enters the picture.  This file
should contain all SID settings which differ from the hardcoded defaults.


Name and location of the config file
------------------------------------

The SID config file must be named SID.config and placed in the s: directory.
The s: directory is automatically assigned to the 's' directory on your boot
disk, though hard disk users often assign s: to a directory in the Workbench
partition of their hard drive.  Whatever the case, be sure place the config
file there, or SID will not find it.

If you are handy with your hex file editor, however, you can change the name
and location of the config file.  Do a search on the name "s:SID.config"
(without the quotes).  I've provided up to 30 characters in which to write
the entire name (including the absolute path) of the SID config file.  SID
will automatically strip any trailing blanks.  Be sure you do not overwrite
that final NULL, or nasty things will happen.  Also, do not attempt this
unless you are adept at this kind of thing.


Loading the config file upon startup
------------------------------------

SID automatically attempts to load the config file upon startup.  No error
message is displayed if SID does not find your config file.  Entries found in
the config file will overwrite the corresponding default settings, meaning
that only entries which differ from the default settings should be included
in your config file.  That way, SID will load the fastest possible.


Editing the config file
-----------------------

You can edit the config file with any ASCII text editor.  Just load the
config file into your favorite editor and enter the keywords and values as
described below.  I'm using the text-file configuration method so that almost
anyone can create and maintain their config file.  Eventually I plan to
release an interactive configuration editor which will not only explain in
detail the meaning of each keyword inside the program, but will also
interactively prompt you for the desired values.  Registered users will be
notified when this program is available.

You may also edit the config file from within SID by selecting the "Edit"
subitem from the "Configuration" item in the "Program" menu.


Format of the config entry
--------------------------

The standard format of an entry in the config file is:

    Keyword=value

The "keyword" is name of the setting that you are changing.  This must be
specified EXACTLY as listed in the docs for SID to recognize it, meaning that
there can be no imbedded blanks and that case (upper and lower) is important.
The keyword is then immediately followed by an equal sign.  Everything from
the equal sign to the end of the line (not including the equal sign or the
end-of-line character) is considered to be part of the value.

For example, consider the following entry:

    Preferences=sys:system/Preferences

The keyword is "Preferences", meaning that you want to change the setting for
the Preferences command.  Note that the first letter is capitalized exactly
as listed later in this doc file.  The value is "sys:system/Preferences",
meaning, in this case, that SID can find the Preferences program in the
"system" directory on the "sys:" disk.


Entries in the config file
--------------------------

The entries in the config file are divided into four categories based on the
values they require: flags, numbers, strings, and keys.  Flags require YES
or NO values, numbers require numerical values, strings require text string
values, and keys require specific key values.  The default value for each
keyword is listed in parentheses.


Flag entries
------------

All of the flag keywords require a YES or NO value.  Note that these values
must be capitalized and should not include any preceeding, imbedded, or
trailing blanks.

AbsolutePath=
  (YES is default).  Whether the path name will be converted to its absolute
  path name.  For example, the path name "c:" may be converted to its
  absolute path name "Workbench1.3:c".  Note that even if this flag is set to
  NO, if you enter a blank directory (which will give you the current
  directory), its absolute path name will be displayed.

BytesOccupied=
  (YES is default).  Whether you want the BYTES command to display the number
  of bytes the highlighted files occupy (YES) or the number of actual bytes
  in the files (NO).

CopyOverwrite=
  (YES is default).  Whether you want to overwrite existing files in the
  destination directory when you copy files.  If YES, all highlighted files
  will be copied to the destination directory, regardless of whether they
  exist.  If NO, only the files which do not exist in the destination
  directory will be copied.  Uncopied files will remain highlighted.  You can
  toggle this flag on and off from within SID by using the "Flags" menu.

DeleteCheck=
  (YES is default).  Whether a requester will appear at the beginning of each
  delete command, asking you if you are sure you want to delete the
  highlighted files.  This is different than DirDelete because this keyword
  causes a requester to appear only once everytime you execute the DELETE
  command, whereas the DirDelete keyword causes a requester to appear for
  each directory selected for deletion.

DirDelete=
  (YES is default).  Whether a requester should appear every time you try to
  delete a non-empty directory, asking you if you are sure you want to delete
  that directory.  Though this can be annoying at times, it will save you
  from the possible catastrophic results of deleting an entire directory you
  wanted to save.

EnglishDates=
  (YES is default).  Whether file dates in the DATE and TIME entry display
  will be displayed in English for recent dates (such as "Today",
  "Yesterday", "Tuesday", etc.)  If this is NO, all dates will be displayed
  in the MM/DD/YY format.

ErrorStop=
  (YES is default).  Whether the Error requester will be displayed when SID
  encounters an error while trying to perform a command.  This allows you to
  retry the file, skip the file, or stop the command altogether.  If you
  don't wnat to be bothered each time a command fails, set this flag to NULL.
  The files for which a command fails will be left highlighted after the
  command has finished executing.

QuitCheck=
  (NO is default).  Whether a requester will appear when you click on the
  window close gadget asking you if you are sure you want to quit.  This is
  provided for people with itchy trigger fingers.

ReadTiny=
  (NO is default).  Whether the READ window displays the file in the tiny
  text (YES) or in the normal Topaz-80 text (NO).  This may also be changed
  in the program by clicking on the FONT button in the READ window's title
  bar.

Requester=
  (NO is default).  Whether a requester will appear for each command allowing
  you to change the command or its arguments.  You can toggle this on and off
  by clicking on the REQ gadget located in SID's window title bar.  The text
  you enter in the requester will be saved for the next time you execute that
  command.  This can be handy for temporarily changing a command without
  having to edit and reload the config file.

ShowOutput=
  (NO is default).  Whether a CLI window will appear for every program you
  run from SID, allowing you to view that program's output.  This can be
  toggled on and off later with the OUTPUT gadget in the SID window's title
  bar.  Note that if you are running SID from the CLI window, the output of
  programs launched from SID will be displayed in that CLI window anyway.

Wait=
  (NO is default).  Whether programs launched with the RUN command will be
  interactive (I know, "Wait" is a funny name, but you'll see my logic).  If
  Wait=NO, then a program launched with the RUN command will be run in the
  background, and SID can go on about its business (the program is launched
  asynchronously, for all you tech buffs).  The problem with this is that the
  program will not be interactive from the CLI.  If Wait=YES, then the
  program will be run in the foreground, meaning SID will wait until the
  program finishes.  The advantage of this method is that the program is
  interactive in the CLI, allowing you to enter input if it's a command-line-
  based program.  Note that this option works only when the OUTPUT window
  option is also specified.

WindowStay=
  (YES is default).  When you change the size of the SID window, if
  WindowStay=YES, SID will save the window's location in the Workbench screen
  so that if you ever return to that size window, it will be right where you
  left it last.  If WindowStay=NO, however, then the window will always be
  placed in the position according to the config values.


Value entries
-------------

All of these keywords require a numerical value.  Invalid values will be
corrected or ignored.

FullLeft=
  (0 is default).  This is the left edge of the Full window.

FullTop=
  (0 is default).  This is the top edge of the Full window.

HalfLeft=
  (0 is default).  This is the left edge of the Half window.  Note that on a
  standard Workbench screen, a left edge value other than zero for all but
  the Shrink window will be meaningless since both the SID window and the
  Workbench screen are the same width.  This value was placed here for future
  expansion (I'm sure we'll all have a 1024 x 1024 monitor some day) or for
  vScreen users ("BigSID").

HalfTop=
  (0 is default).  This is the top edge of the Half window.

LaceLeft=
  (0 is default).  This is the left edge of the Lace window.

LaceTop=
  (0 is default).  This is the top edge of the Lace window.

OutputHeight=
  (120 is default).  This is the height of the CLI output window.

OutputLeft=
  (0 is default).  This is the left edge of the CLI output window opened when
  programs are launched from SID and the ShowOutput flag is on.

OutputTop=
  (80 is default).  This is the top edge of the CLI output window.

OutputWidth=
  (640 is default).  This is the width of the CLI output window.

ShrinkLeft=
  (344 is default, which will place the shrink window flush right with the
  Workbench screen).  This is the LeftEdge of the Shrink window.

ShrinkTop=
  (0 is default).  This is the TopEdge of the Shrink window.

SpecifyLeft=
  (0 is default).  This is the left edge of the Specify window.

SpecifyRows=
  (10 is default).  This is the number of rows with which the specify window
  will open.  This value is only used if you specify WindowHeight=SPECIFY.

SpecifyTop=
  (0 is default).  This is the top edge of the Specify window.


String entries
--------------

These are the strings used to execute the commands.  Everything from the
equal sign after the keyword to the end of the line, including imbedded and
trailing blanks, will be recognized.

Arc=
  (c:arc a is default).  The Arc program you use for archiving files.  Notice
  that four different archival methods are supported: Arc, Pak, Warp, and Zoo.
  Therefore, this value should contain the command to summon the Arc program,
  not the Pak, Warp, or Zoo program.  They have their own separate keywords,
  as shown below.

Button1=
Button2=
Button3=
Button4=
Button5=
Button6=
Button7=
Button8=
  (The default is NOT to list them in the config file).  The eight Button
  keywords listed above correspond to the eight device buttons associated
  with the two directory lists (see the DeviceButtons= keyword).  The
  Button1= keyword corresponds to the leftmost device button, Button8= to the
  rightmost, and so on.  If a device button has a button path specified, then
  instead of appending a colon to the button name, the button path is used.
  That means you must supply any necessary colons and slashes.  That also
  means that the button name is ignored and you can name it anything you
  want.  Note that you do not have to specify a button path for each device
  button.  For example, using the DeviceButtons= keyword default, the third
  button is named DH0.  Instead, you could change the name to WKB (with the
  DeviceButtons= keyword), and set the path with Button3=Workbench1.3:

Calculator=
  (c:calculator is default).  The name and location of the calculator program
  that you like to use.

DiskEdit=
  (c:DiskX is default).  The name and location of your favorite disk
  editor.  This is not supported by the current version of SID.

Execute=
  (there is no default).  The arguments for batch files executed from SID.
  Though this will likely be blank for most users, you may find sometime that
  you are often executing the same batch file which requires a certain set of
  arguments.

FileEdit=
  (c:ue is default).  The name and location of your favorite ASCII text
  editor.

FileXEdit=
  (c:newzap is default).  The name and location of your favorite hex editor
  (that allows you to edit binary files).

Hear=
  (c:hear is default).  The name and location of the program you use to play
  digitized sounds.

ListArc=
  (c:arc l is default).  The Arc program you use for listing the contents of
  arc'd files.

ListPak=
  (there is no default).  The command you use for listing the contents of
  pak'd files.  Even though the current version of the Pak program does not
  have the ability to display the contents of pak'd files, this was provided
  for upward compatability.

ListWarp=
  (there is no default).  The Warp program you use for listing the contents
  of warp'd files.  Note that the current version of the Warp program does
  not have a command to display the contents of a warp'd file.  This was
  provided for upward compatability.

ListZoo=
  (c:zoo l is default).  The Zoo program you use for listing the contents of
  zoo'd files.

NewCLI=
  (c:NewSHELL "NEWCON:0/0/640/96/Type ENDCLI to Quit" is default).  The
  command used to create a new CLI window.  Note how I am using the Shell
  provided with Workbench 1.3 in the default.

Other=
  (c:cc is default).  This is a user-definable key which you can set to do
  anything you want.

Pak=
  (c:pak is default).  The Pak program you use for archiving files.

Pattern=
  (#?.c is default).  The first time you run the PATTERN command (which
  highlights all files in the active list based on the AmigaDOS wildcard
  pattern you specify), this pattern appears in the requester.

Preferences=
  (sys:system/Preferences is default).  Where to find the Preferences program.

Print=
  (c:print is default).  The name and location of the program you use to
  print files.  A file printing program with C source is included on the disk
  of goodies sent to registered SID users.

Run=
  (there is no default).  The arguments for programs run from SID.  Though
  this will likely be blank for most users, you may find sometime that you
  are often running the same program which requires a certain set of
  arguments.

UnArc=
  (c:arc x is default).  The Arc program you use for unarchiving arc'd files.

UnPak=
  (there is no default).  The program you use for unarchiving pak'd files.
  For the current version of the Pak program, just typing the name of the
  pak'd file will cause it to unpak itself, therefore no command needs to be
  specified.

UnWarp=
  (c:warp write is default).  The Warp program you use for unarchiving Warp'd
  disks.  Be careful with this command.

UnZoo=
  (c:zoo x is default).  The Zoo program you use for unarchiving zoo'd files.

View=
  (c:superview -c is default).  The name and location of your favorite IFF
  graphic display program.  Notice that you can attach program arguments.  In
  this case, I added a "-c" argument to surpress color cycling.

Warp=
  (c:warp read 0 79 is default).  The Warp program you use for archiving
  disks.

Zoo=
  (c:zoo a is default).  The Zoo program you use for archiving files.


Special entries
---------------

These keywords require one of the special flags listed.

ArchiveMethod=
  (ARC is default).  This flag allows you to specify which archive method you
  want to use when archiving files.  You can specify: ARC to use Arc, ZOO to
  use Zoo, WARP to use Warp, and PAK to use Pak.  Of course, you can change
  this at any time with the "Archival Method" item in the "Flags" menu.
  Also, this flag has nothing to do with unarchiving or listing the contents
  of archived files.  SID automatically determines which archival method to
  use in those cases.

ArrowDirection=
  (FLOW is default).  The direction in which the arrow (in the center of the
  SID window) will point.  If ArrowDirection=FLOW, the arrow will point in
  the direction of file flow, i.e. from the active side to the inactive side.
  If ArrowDirection=ACTIVE, the arrow will point to the currently active
  side.  Requires one of the following:
    FLOW
    ACTIVE

DeviceButtons=
  (DF0DF1RAMRADDH0DH1DH2DH3 is default).  These are the names of the eight
  device buttons which appear under each window.  Notice how they are
  listed in succession with no imbedded blanks.  The colons are implied and
  will be added by SID.  Each button name must be exactly three characters
  long, and you must specify all eight button names or strange things will
  happen.  You can override the directories loaded when clicking on the
  device buttons by specifying alternate path names with the Button1=,
  Button2=, etc. entries.  See those keyword definitions below for more
  information.

EntryType=
  (SIZE ONLY is default).  The manner in which the entries will be displayed.
  Requires one of the following:
    SIZE ONLY ....... just the size; this is by far the fastest method
    DATE AND TIME ... also displays file creation date and time
    DESCRIPTION ..... displays the description of the file

ScreenType=
  (WORKBENCH is default).  The screen on which the SID window will open when
  the program begins.  Requires one of the following:
    CUSTOM ...... SID will open on its own non-interlaced custom screen
    INTERLACE ... SID will open on its own interlaced custom screen
    WORKBENCH ... SID will open on the Workbench screen

Set=
  (*******- is default).  The protection bit pattern used by the SET
  requester.  This string should be eight characters long, each character
  representing the bit in the corresponding protection string HSPARWED.  A
  letter indicates that the bit is to be set, a dash (-) indicates that the
  bit is to be cleared, and an asterik (or any other character) indicates
  that the bit is to be ignored.  Thus, the default setup will ignore all but
  the Delete bit which will be cleared, meaning if you execute the SET
  command without changing the bit pattern, all highlighted files will have
  their Delete bits cleared (making them Not Deletable).

WindowHeight=
  (FULL is default).  The size at which SID's window will open when the
  program begins.  Requires one of the following:
    FULL ..... SID will open with a 640x200 pixel window, if possible
    HALF ..... SID will open with a 640x100 pixel window
    LACE ..... SID will open with a 640x400 pixel window, if possible
    SHRINK ... SID will open shrunk
    SPECIFY .. SID will open with the number of rows you specified with the
               SpecifyRows keyword


ConfigDocs v1.03 09/02/89
© Copyright 1989 Timm Martin
All Rights Reserved Worldwide

/*-- END --*/