home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR8 / RREAD202.ZIP / RRCONFIG.DOC < prev    next >
Text File  |  1993-04-27  |  14KB  |  314 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                            RRCONFIG Version 1.02
  7.                             *** DEMO Version ***
  8.  
  9.                          Configuration Program For
  10.                               The RaLin Reader
  11.  
  12.                        (C)Copyright 1993, Rand Nowell
  13.                              RaLin Enterprises
  14.                         "Putting Bits Together" (tm)
  15.  
  16.                       -All Rights Reserved Worldwide-
  17.  
  18.                  P R O G R A M   D O C U M E N T A T I O N
  19.  
  20.   
  21. Go Configure        Configuring The RaLin Reader - Manual           Page   1
  22.  
  23.  
  24. ┌─────────────────────────────────────────────────────────────────────────────┐
  25. │▒▒▒ NOTICE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  26. └─────────────────────────────────────────────────────────────────────────────┘
  27.  
  28.  This is the REGISTERED copy of RRCONFIG, and as such should not be
  29.  distributed, or given to anyone else. Only "YOU" are licensed to use this
  30.  copy of the program.
  31.  
  32.  All support, licensing, future version terms and information are identical
  33.  to those listed in RR.DOC, and are applied to all programs mentioned in
  34.  this document.
  35.  
  36.  RRCONFIG.EXE is the standalone program for configuring the editor used,
  37.  colors, printer codes etc. I don't figure everyone will like the default
  38.  colors.
  39.  
  40. ┌─────────────────────────────────────────────────────────────────────────────┐
  41. │▒▒▒ Real vs Demo ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  42. └─────────────────────────────────────────────────────────────────────────────┘
  43.  
  44.  There are two versions of RRCONFIG, a Registered version and a Demo version.
  45.  The Demo version is identical to the Registered, except that it will NOT
  46.  save a configuration file, though it goes through all the motions of doing
  47.  so.  This will give you an oppurtunity to see how the program works.
  48.  The Demo version, RRCONFIG.EXE is included in the Evaluation package. The
  49.  registered version RRCONFIG.EXE is included with your Registered package.
  50.  
  51. ┌─────────────────────────────────────────────────────────────────────────────┐
  52. │▒▒▒ The READCFG Program ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  53. └─────────────────────────────────────────────────────────────────────────────┘
  54.   REGISTERED ONLY!
  55.  
  56.   Included with RRCONFIG, is a companion program, READCFG.EXE which will
  57.   allow you to quickly view the settings of any RRSET.CFG.
  58.  
  59.   Simply log onto the directory of your choice and type READCFG. IF no file
  60.   is found, a message will be displayed.
  61.  
  62.   Otherwise, your configuration will be displayed in a format similar to
  63.   RRCONFIG's Edit screen.
  64.  
  65.   You can re-direct the listing to your printer by using a switch, this is
  66.   -p or -P.  ie READCFG = screen display  READCFG -p = write to printer.
  67.  
  68. ┌─────────────────────────────────────────────────────────────────────────────┐
  69. │▒▒▒ Help Screens ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  70. └─────────────────────────────────────────────────────────────────────────────┘
  71.  
  72.   Help is available via the F1 key, there are two screens. Pressing any key
  73.   other than ESC will toggle between them. Pressing ESC will exit the Help
  74.   Screens.
  75.   Another short screen is available from the Dos Prompt. Type RRCONFIG ? to
  76.   display a screen to refresh you on how to start RRCONFIG for different
  77.   purposes.
  78.  
  79.                            Have it "Your" Way....
  80.  
  81.  
  82. Go Configure        Configuring The RaLin Reader - Manual           Page  2
  83.  
  84.  
  85. ┌─────────────────────────────────────────────────────────────────────────────┐
  86. │▒▒▒ The Display ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  87. └─────────────────────────────────────────────────────────────────────────────┘
  88.  
  89.  When RRCONFIG starts up it searches for an existing RRSET.CFG file. If
  90.  found it will display all values as found in that file. If not found, the
  91.  values will all be set to the 'default' ones, which are the same as that
  92.  used in the Reader.
  93.  
  94.  The configuration program searches for an existing config file, RRSET.CFG.
  95.  It first checks the current directory and if one is not found, it will
  96.  search all directories listed in the Dos PATH statement. It will use the
  97.  first one found, if one exists.
  98.  
  99.  The complete PATH\FILENAME of the config file being used, will be displayed
  100.  at the top of the editing window. This also applies if you are creating a
  101.  new file.
  102.  
  103. ┌─────────────────────────────────────────────────────────────────────────────┐
  104. │▒▒▒ Creating a New Configuration File ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  105. └─────────────────────────────────────────────────────────────────────────────┘
  106.  
  107.  If you have one or more copies of RRSET.CFG and you wish to create a New
  108.  one, you must start RRCONFIG with the /N switch, the 'N' may be upper or
  109.  lower case. Example: RRCONFIG /N.
  110.  
  111.  If the /N switch is not used, RRCONFIG will "always" load an existing file
  112.  if found. The switch tells it to ignore any cfg file found and start from
  113.  scratch.
  114.  
  115.  If an existing RRSET.CFG exists in the current directory, and you use the
  116.  /N switch, that copy will be over written by the new one when you save it.
  117.  See the section "Saving Configuration" later on for more on this.
  118.  
  119. ┌─────────────────────────────────────────────────────────────────────────────┐
  120. │▒▒▒ The Editing Screen ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  121. └─────────────────────────────────────────────────────────────────────────────┘
  122.  
  123.  When RRCONFIG fires up, it will display the editing window, and list all
  124.  values as found, or the defaults....you are in view mode.
  125.  
  126.  Use your Up and Down keys to move through the fields. As you enter a field,
  127.  a short Help line will be displayed in the lower section of the display.
  128.  
  129.  The lower section of the screen contains the Help line, and all the Command
  130.  Keys available.
  131.  
  132.  Two Help/Information screens are available when the F1 key is pressed.
  133. ┌─────────────┐
  134. │Command Keys:│
  135. └─────────────┘
  136.  F1       : Calls the Help/Information screens.
  137.  F2       : Displays a color chart with the color values to enter.
  138.  F5       : Shows a sample of the readers display, with current colors.
  139.  
  140.                            Have it "Your" Way....
  141.  
  142.  
  143. Go Configure        Configuring The RaLin Reader - Manual           Page  3
  144.  
  145.             May be displayed at any time while entering the values.
  146.  F9/ENTER : Allows you to Edit the field you are in when pressed.
  147.  END      : Exits RRCONFIG. If changes have been made, you will be asked
  148.             if you wish to save them. Pressing 'Y' or Enter will save the
  149.             new configuration. Press 'N' to not save.
  150. ┌─────────┐
  151. │Editing: │
  152. └─────────┘
  153.  When you enter "Edit Mode" in any field, the following Editing keys are
  154.  available to you.
  155.  
  156.  Editing keys are -
  157.  DeleteKey        - Delete character at the cursor.
  158.  LeftArrow        - Nondestructive move cursor to the left.
  159.  RightArrow       - Nondestructive move cursor to the right.
  160.  End              - Move cursor to end of input string.
  161.  Home             - Move cursor to start of input string.
  162.  Backspace        - Delete character to the left of cursor.
  163.  Ins              - Toggles insert mode, cursor changes to block.
  164.  Esc              - Aborts Edit and uses the Default or existing value.
  165.  Enter/Return     - Accepts values as entered.
  166.  
  167. ┌─────────────┐
  168. │Description: │
  169. └─────────────┘
  170.  Type in a short description of this file, you may have several
  171.  configuration files for different situations, this will help you remember
  172.  just what you set it up for.
  173. ┌────────────────┐
  174. │Display Colors: │
  175. └────────────────┘
  176.  If you need to view the color chart with F2, you must do it before you
  177.  enter Edit mode, the chart is NOT available while you are editing the
  178.  field. This may be changed in a later version.
  179.  
  180.  You will only be allowed to enter color values from 1 to 127, and only
  181.  numeric characters are allowed.
  182.  
  183.  A note on the Blinking status color. The color you choose will be
  184.  automatically adjusted to create the blinking forground. If you want bright
  185.  yellow on red, then enter 78. RRCONFIG will set the yellow to blinking
  186.  automatically. The default is to use the same color as the Normal
  187.  Header/Status number, and cause it to blink.
  188.  
  189.  Colors for the Pick Lists and Dialog boxes are inherited from your color
  190.  settings for all other screen colors.
  191.  
  192.  Pick List, Frame and Text color: Same as that of Normal Header and Status.
  193.             The Highlight Bar: Same as your color for "Found" text.
  194.  
  195.  Dialog Boxes, Frame color: Same as the Highlight Color in Status and
  196.                Header.
  197.                Text: Same as the Header/Status Normal color.
  198.                Buttons: Unselected - same as Help Screen
  199.                         Selected -   same as Found color.
  200.  
  201.                            Have it "Your" Way....
  202.  
  203.  
  204. Go Configure        Configuring The RaLin Reader - Manual           Page  4
  205.  
  206.  
  207.  Samples of the Dialog Boxes and the Piclist colors are shown in the lower
  208.  screen when Display is called via F5.
  209.  
  210. ┌──────────────────────┐
  211. │Startup Border Color: │
  212. └──────────────────────┘
  213.  Some people like to have a contrasting border color around the screen.
  214.  This is only available on CGA and VGA monitors. EGA does not support border
  215.  colors.
  216.  Acceptable values are from 0 to 15, these are viewable on the first row of
  217.  the color chart, any other number will not be accepted.
  218.  When you enter a border color, the screen border will instantly change to
  219.  that color, so you can cycle through and view, simply by repeatedly
  220.  changing the color number.
  221.  
  222. ┌─────────────────────────────────────────────────────────────────────────────┐
  223. │▒▒▒ Editor Program ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  224. └─────────────────────────────────────────────────────────────────────────────┘
  225.  
  226.  Enter the Editor you would like to use. The entered program MUST exist in a
  227.  "PATH" directory in order for the reader to find it.
  228.  
  229.  Editor Parameters:
  230.  If your editor accepts any switches for special actions, enter them here.
  231.  If NOT, please enter (1)ONE space. This makes sure that no garbage is
  232.  included in the command line when the Editor is called.
  233.  These "switches" are sent "following" the file name when the editor is
  234.  invoked.
  235.  
  236.  The Editor defaults to RE.EXE, The RaLin Editor (under development).
  237.  To use "your" editor with the Shareware copy of the reader, you will have
  238.  to rename it to RE.EXE.
  239. ┌─────────────────────────────────────────────────────────────────────────────┐
  240. │▒▒▒ Printer Commands ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  241. └─────────────────────────────────────────────────────────────────────────────┘
  242.  
  243.  These fields allow you to specify control commands to be sent to your
  244.  printer for custom setup before printing any file you are viewing. In the
  245.  reader, the code may be sent by pressing the Alt key plus the number 1
  246.  through 6.  Use the number keys above the character keys.
  247.  
  248.  Please remember, any code you send to the printer will remain in effect,
  249.  even after exiting the reader, unless you clear it.
  250.  It is best to use two Printer commands for each special setting, one to
  251.  activate it and one to turn it off. Using this process, you can have 3
  252.  different setups for your printer.
  253.  
  254.  You do not need to use the ALT-# keys for setting or clearing COMPRESSED
  255.  print mode. That is always available in the reader. But, if for some reason
  256.  the readers command for this doesn't work (1 in a thousand) then you can
  257.  define the codes here.
  258.  
  259.  Codes must be entered in NUMERIC format, no characters. They should be
  260.  seperated by one space, NO space at beginning, and NO space at end.
  261.  
  262.                            Have it "Your" Way....
  263.  
  264.  
  265. Go Configure        Configuring The RaLin Reader - Manual           Page  5
  266.  
  267.  An example for Setting Graphics mode on a Panasonic 1124i would be:
  268.  27 116 1, remember NO begining or trailing spaces.
  269.  
  270.  Refer to your Printer Manual for the proper code sequences, use the
  271.  "Decimal" values.
  272.  
  273. ┌─────────────────────────────────────────────────────────────────────────────┐
  274. │▒▒▒ Saving The Configuration ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  275. └─────────────────────────────────────────────────────────────────────────────┘
  276.  
  277.  When you are done changing the configuration settings, or just want to
  278.  exit, press the END key. If any changes have been made you will be asked
  279.  if you want to save these changes. Pressing 'Y' =or= ENTER will save the
  280.  changes to the configuration file RRSET.CFG
  281.  
  282.  The configuration file is written to the same directory it was found in,
  283.  assuming you are modifying an existing file. Any old copy is overwritten.
  284.  If this is a NEW configuration file, with no other existing, it will be
  285.  written in the current directory.
  286.  
  287.  Also, if the /N switch was used, the "New" file will be written to the
  288.  current directory, overwriting any existing file.
  289.  
  290.  If you wish to have only one configuration file, or one that you will use
  291.  as a "standard", it should be created in a directory that is included in
  292.  your PATH statement.
  293.  
  294.  Again, multiple files may be used. The reader and the config program always
  295.  search the current directory, on startup, for a config file, before
  296.  searching the path.
  297.  
  298. ┌─────────────────────────────────────────────────────────────────────────────┐
  299. │▒▒▒ Closing Remarks ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│
  300. └─────────────────────────────────────────────────────────────────────────────┘
  301.  
  302.  RRCONFIG is a simple program, and really self-explanatory. You should have
  303.  no problem giving The RaLin Reader your own "special touch".
  304.  As features are added to the reader, RRCONFIG will be expanded to
  305.  accomodate the configuration of the new features.
  306.  
  307.  All credits and thanks follow those listed in RR.DOC.
  308.  
  309. <eof RRCONFIG.DOC>
  310.  
  311.  
  312.                            Have it "Your" Way....
  313.  
  314.