home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / util / misc / mhsutil5.lha / Prefs / Manual < prev    next >
Text File  |  1995-09-25  |  11KB  |  290 lines
  1.     -------------------------------------------------------------------------
  2.     INTRODUCTION
  3.     -------------------------------------------------------------------------
  4.  
  5.     -----------
  6.     SoftConfig:
  7.     -----------
  8.     The requirements of a program can change as the user learns more
  9.     about their system and software.  A program that uses requestors
  10.     to walk a new user thru certain functions, for instance, can become
  11.     a hinderance to a more advanced user: enter software configuration.
  12.     The 'SoftConfig' program allows setting the environment used by
  13.     all programs located on the utility disk series (except disk #1)
  14.     available from MIKE HURT SOFTWARE!.  This environment could range
  15.     from using the default public screen for all windows opened as
  16.     opposed to using the screen requested by the program, to
  17.     automatically advancing to the top of the next page before or
  18.     after printing text, to setting the program's expert user level
  19.     (some programs will walk you through at novice level).  The
  20.     software configuration system is expandable as new functions are
  21.     added and shared between programs.  All currently supported
  22.     configuration variables (or 'flags') are displayed in the
  23.     'SoftConfig' preferences window by description.  'SoftConfig'
  24.     allows the user to taylor the programs' environment to suit
  25.     their individual needs or preferences.
  26.  
  27.  
  28.     -----
  29.     CCFQ:
  30.     -----
  31.     'CCFQ' allows easy 'communication' with currently running programs
  32.     using the 'ccfq' standard/ convention.  For example: if 'PC',
  33.     'DiskMonitor', & 'MemMonitor' are currently running and no
  34.     preferences windows are being displayed, the programs are considered
  35.     to be 'hidden'.  You would need to enter the name of the program
  36.     followed by the command (ie., '-p' or '-q') from the CLI/ Shell
  37.     to display the programs preferences window or 'exit' the program
  38.     entirely.  The 'CCFQ' program allows a single program or interface
  39.     to pass program specific commands like 'pref' & 'quit' directly to
  40.     any program supporting this convention: unlike using the dash ('-')
  41.     options for each program.  'CCFQ' sends commands to a specific
  42.     program.  For example, if you've started two 'PC' programs, then
  43.     use the 'PC -q' command trying to exit one of them, both programs
  44.     would quit.  'CCFQ' allows you to select the specific program
  45.     you'd like to quit: 'CCFQ 1 quit'.  Thereby exiting the unwanted
  46.     'PC' program while leaving the other currently running 'PC'
  47.     program undisturbed.
  48.  
  49.  
  50.     -------------------------------------------------------------------------
  51.     FEATURES
  52.     -------------------------------------------------------------------------
  53.  
  54.     --------------------------
  55.     Standard features include:
  56.     --------------------------
  57.     o - Multitasks.
  58.     o - Uses standard INTUITION interfaces.
  59.     o - Adjusts to different WORKBENCH environments.
  60.  
  61.  
  62.     -------------------------
  63.     Special features include:
  64.     -------------------------
  65.     Uses the 'SOFTCONFIG' environment.
  66.  
  67.  
  68.     -------------------------
  69.     Program features include:
  70.     -------------------------
  71.     o - Modify the special SOFTCONFIG environment.
  72.     o - 'Talk' to programs using the CCFQ convention.
  73.  
  74.  
  75.     -------------------------------------------------------------------------
  76.     USING SOFTCONFIG
  77.     -------------------------------------------------------------------------
  78.  
  79.     ----------------
  80.     Getting Started:
  81.     ----------------
  82.     You can start 'SoftConfig' from either the CLI/ Shell or from WORKBENCH
  83.     by double-clicking on the supplied icon.
  84.  
  85.     To start 'SoftConfig' from the CLI/ Shell enter:
  86.  
  87.     >Run SoftConfig
  88.  
  89.  
  90.     --------------------------
  91.     Understanding the options:
  92.     --------------------------
  93.     There are 200 independant configuration variables that exist in the
  94.     software configuration file.  Each one of these variables can have
  95.     a value ranging from 0 - 255.  By changing these values, you can alter
  96.     the way a program behaves.  For example, you can specify graphics
  97.     printing programs to print graphics at 50% normal size or open
  98.     windows on the default public screen instead of the WORKBENCH screen
  99.     etc.,.
  100.  
  101.     To understand what each configuration variable (also called 'flags')
  102.     will do, click on the "[ ? ]" (flag query description) button next
  103.     to the configuration flag you need more information on.  You will be
  104.     presented with a short description of what purpose the variable will
  105.     serve other programs.
  106.  
  107.     Be sure to check this information to see what values are correct for
  108.     a specific 'flag' before changing it:  wrong values can cause
  109.     unpredictable results!
  110.  
  111.     The window's title bar will display general configuration information
  112.     such as which program's features will be effected by the 'flags'
  113.     currently being displayed.
  114.  
  115.  
  116.     -------------
  117.     Project Menu:
  118.     -------------
  119.     ABOUT ........ Program's info & credits.
  120.     QUIT ......... Exit 'SoftConfig'.
  121.  
  122.  
  123.     -----------------------------
  124.     Checking the value of a flag:
  125.     -----------------------------
  126.     You can check the value of a specific flag from the CLI/ Shell by
  127.     using:
  128.  
  129.     >Run SoftConfig -v15
  130.  
  131.     ... this will display the current value of flag #15.
  132.  
  133.  
  134.     ---------------
  135.     Setting a flag:
  136.     ---------------
  137.     You can set the value for a specific flag from the CLI/ Shell by
  138.     using:
  139.  
  140.     >Run SoftConfig -f15:80
  141.  
  142.     ... this will set the value flag #15 to 80.  The flag and it's
  143.     new value MUST BE SEPERATED BY A COLON (':')!  By setting a flag
  144.     this way, the change will only be temporary.  When your system
  145.     is rebooted, the prior value for the flag will be restored.
  146.  
  147.  
  148.     If you change the value of a flag from within the 'SoftConfig'
  149.     window, you can:
  150.  
  151.       Temporarily apply the change by selecting "[ USE ]"
  152.  
  153.                                  ... or ...
  154.  
  155.       Permanently apply the change by selecting "[ SAVE ]"
  156.  
  157.     ... by selecting "[ SAVE ]", the values specified will also become
  158.     the currently used values.
  159.  
  160.  
  161.     -------------------------------------------------------------------------
  162.     USING CCFQ
  163.     -------------------------------------------------------------------------
  164.  
  165.     ----------------
  166.     Getting Started:
  167.     ----------------
  168.     'CCFQ' should only be started from the CLI/ Shell.  If 'CCFQ'
  169.     exits without displaying any programs or information, then
  170.     there are no programs running or have been programs running that
  171.     use the 'ccfq' convention.  You can start 'CCFQ' from the CLI/
  172.     Shell by:
  173.  
  174.     >Run CCFQ
  175.  
  176.     ... this will display all 'ccfq' programs currently running, and
  177.     prompt you for the command to be taken.  Pressing [RETURN] will
  178.     exit 'CCFQ' without taking any action.
  179.  
  180.     Each currently running 'ccfq' program is assigned a task number
  181.     associated with it's position in the 'ccfq' task list.  If a
  182.     'ccfq' task exits, another 'ccfq' program can take it's place
  183.     in the task list using the same task number.  Therefore, if you
  184.     exit a program using 'CCFQ', be sure to check the 'ccfq' task
  185.     list before re-issuing the same 'ccfq' exit command!
  186.  
  187.     If you know the task number associcated with the 'ccfq' program
  188.     you can send commands to it directly from the CLI/ Shell using:
  189.  
  190.     >Run CCFQ <task #> <command>
  191.  
  192.     ... this will send the <command> like 'quit' directly to the
  193.     program associated with <task #>.
  194.  
  195.  
  196.     ---------------------
  197.     Understanding 'CCFQ':
  198.     ---------------------
  199.     Basically, the 'ccfq' convention is a random access file located
  200.     in your current ENV: directory.  Each record in the file corrosponds
  201.     to a task: record #1 is task #1, etc.,.  Any time a program is
  202.     started that 'logs' itself in this file (this is called using the
  203.     'ccfq' convention) a free record is selected to contain the program
  204.     name and system task address for that particular program.  The
  205.     currently running program will, if 'hidden', check for the presence
  206.     of it's personal 'ccfq' file which is 'ID-ed' by the system
  207.     task address for the program.  Therefore, when you issue a command
  208.     via 'CCFQ', the record associated with the <task #> is read, the
  209.     system address of the program is extracted and a new file is created
  210.     in the ENV: directory containing the command passed to 'CCFQ'.
  211.  
  212.     When entering commands via programs that use the 'ccfq' convention,
  213.     this random access file is read sequentially, and all programs that
  214.     are 'logged' in with the same name as the program issuing the command
  215.     will be sent the command.  Therefore, in the example in the
  216.     introduction, both 'PC' programs, using this technique, would exit.
  217.  
  218.  
  219.     -------------------------------------------------------------------------
  220.     FOR ADVANCED USERS
  221.     -------------------------------------------------------------------------
  222.  
  223.     ---------------------
  224.     Configuring software:
  225.     ---------------------
  226.     The extended printer preferences is an ASCII text file that
  227.     contains escape sequence commands to enable certain printer
  228.     functions that are not directly available using the standard
  229.     system printer preferences program(s).  For example, setting
  230.     expanded or double width text printing, etc.  If enabled,
  231.     this file will be sent to the printer before any text has
  232.     been printed, therefore causing all text printed to be
  233.     in the expanded format.  This file 'printersys.cfg' can be
  234.     editing using a standard text editor.
  235.  
  236.  
  237.     --------------------------
  238.     Commanding other Programs:
  239.     --------------------------
  240.     Place 'CCFQ' in your c: directory or path providing access to all
  241.     programs using the 'ccfq' convention from any CLI/ Shell without
  242.     having all the programs located in your current c: directory or
  243.     path and using the '<program> -<?>' command syntax for each one.
  244.     Most 'ccfq' commands are exactly the same for all programs using
  245.     that convention.  See the online help for 'CCFQ' for more
  246.     information.
  247.  
  248.  
  249.     -----------
  250.     Final Note:
  251.     -----------
  252.     'FKEY' can be used to 'launch' this program via pre-determined
  253.     keystroke(s).
  254.  
  255.  
  256.     -------------------------------------------------------------------------
  257.     CREDITS
  258.     -------------------------------------------------------------------------
  259.  
  260.     This program was designed and coded by Michael Thomas Hurt  of
  261.     MIKE HURT SOFTWARE!, coded in & compiled using Blitz Basic 2.0
  262.     available from Acid Software.
  263.  
  264.     Software testing was done using:
  265.  
  266.       o - Amiga 500 : AmigaDOS 2.1, GVP HD 500+ w/ 2MEGS.
  267.  
  268.       o - Amiga 2000: AmigaDOS 2.1, Microbotics VXL030 w/MMU,
  269.           Microbotics VXLRAM 2MEGS, Microbotics 8-UP! 4MEGS,
  270.           GVP Series II hard card w/ 100MEG HD.
  271.  
  272.       o - Amiga 3000: AmigaDOS 2.1, 6MEGS.
  273.  
  274.       o - Amiga 4000: AmigaDOS 3.0
  275.  
  276.  
  277.     -------------------------------------------------------------------------
  278.     PROGRAM HISTORY
  279.     -------------------------------------------------------------------------
  280.  
  281.     -----------
  282.     SoftConfig:
  283.     -----------
  284.     v1.0    07/16/1995    Original program.
  285.  
  286.  
  287.     -----
  288.     CCFQ:
  289.     -----
  290.     v1.0    07/20/1995    Original program.