home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / GWINDOWS / lfmaker.lzh / readme < prev   
Text File  |  1996-04-13  |  6KB  |  155 lines
  1.                Lfmaker - Copyright 1996 by Stephen Carville
  2.         Creates and edits Application Information Files for G-Windows
  3.  
  4.             ----------------------------------------------------
  5.               This program requires G-Windows 3.0 and will not
  6.               work with earlier version of G-Windows.
  7.             ----------------------------------------------------
  8.  
  9.  This archive should contain the following files:
  10.  
  11.           readme - this file
  12.          Lfmaker - executable
  13.   aif_recognizer - a text file recognizer subroutine module
  14.       AIF_Sample - sample Application Information File.
  15.            aif.c - Ultra-C source code for aif_recognizer
  16.        aif_icons - source code definitions for the icons
  17.  
  18.  This program will create and edit small text files to launch applications
  19.  from anywhere in the G-Windows directory structure.  It is a very simple
  20.  program to use and, though it doesn't add any new abilities to G-Windows,
  21.  it does make some of the Desktop capabilities much easier to take advantage
  22.  of.
  23.  
  24.  The file "aif_recognizer is a text file recognizer module and must be
  25.  entered in the "config" file of your GWINDOWS/DESKTOP directory for Lfmaker
  26.  to work.  If you are not familiar with how to enter a new file recognizers
  27.  detailed instructions are provided in the section labeled "Step by Step In-
  28.  structions."
  29.  
  30.                                 Using Lfmaker
  31.  
  32.  To start the program type the name "Lfmaker" at the shell prompt or double
  33.  click on the program icon.  This will open a window where you will edit the
  34.  AIF.
  35.  
  36.  The "Command Line"  Entry.
  37.  
  38.       The "Command Line" entry will be passed to the Desktop for execution
  39.       when the AIF file icon is double clicked from within a directory win-
  40.       dow.  It will act exactly as if you double clicked the program icon
  41.       and gives you some extra capabilities as well.  The entry follows the
  42.       format described in the G-Windows manual.
  43.  
  44.       For example, to change to the directory "/dd/GAMES" and start up the
  45.       program CyberWar the entry would look like"
  46.  
  47.            chd /dd/GAMES;cyberwar <>>>%
  48.  
  49.       To change the window environment and start up a shell in the current
  50.       data directory use a command line like:
  51.  
  52.            profile /dd/shell_start;shell -l <>>>%
  53.  
  54.       The file "/dd/shell_start" contains any special "setenv" commands
  55.       needed to configure the window or other system environment variables.
  56.  
  57.  The "File Type"  Entry.
  58.  
  59.       The "File Type" entry is passed to Desktop whenever "Information..."
  60.       is requested from the "File" option of the Desktop menu.
  61.  
  62.  "Select Icon" Button.
  63.  
  64.       The "Select Icon" button opens a window showing the available icons.
  65.        To select an icon just click on it.  To cancel the operation, click on
  66.       the close button on the window Title Bar.
  67.  
  68.  Menu Entries.
  69.  
  70.       "Open..."      Opens an existing AIF.
  71.  
  72.       "New File"     Allows creation of a new AIF.
  73.  
  74.       "Save"         Saves the current file with the name displayed in the
  75.                      window title bar.
  76.  
  77.       "Save As..."   Allows saving the current file with a different name.
  78.  
  79.       "Quit"         Quits Lfmaker.  Equivalent to clicking the close button
  80.                      in the program window.
  81.  
  82.  ---------------------------------------------------------------------------
  83.  
  84.  To simplify the process of adding or creating Lfmaker files it may be use-
  85.  ful to add the program as an entry to the Custom option of the main Desktop
  86.  Menu.  This facilitates creating new files from anywhere in the directory
  87.  tree.  You can also just click on an existing AIF, pull down the entry in
  88.  your Custom menu and edit the file.  The "menu" file entry will look some-
  89.  thing like:
  90.  
  91.       "Launch File Editor"  Lfmaker @ <>>>%
  92.  
  93.  ---------------------------------------------------------------------------
  94.  
  95.                           Step by Step Instructions
  96.  
  97.  Installing "aif_recognizer"
  98.  
  99.    1. Copy the module "aif_recognizer" to the directory "GWINDOWS/CMDS".
  100.  
  101.    2. Change to "GWINDOWS/DESKTOP"
  102.  
  103.    3. Load the file "config" into your text editor
  104.  
  105.    4. Locate the line that starts with ":text" (Note the leading colon).
  106.  
  107.    5. Move the cursor (or insertion point) till it is to the right of the
  108.       letters ":text".
  109.  
  110.    6. Insert the text: ":/dd/GWINDOWS/CMDS/aif_recognizer".  Pay attention
  111.       the the leading colon (:) and be certain there is at least one space
  112.       before and after the inserted text.
  113.  
  114.    7. Save the edited file and exit the text editor.
  115.  
  116.             ----------------------------------------------------
  117.               You will have to quit and restart G-Windows for
  118.               this change to take effect though you may con-
  119.               tinue with the installation without restarting.
  120.               A sample AIF file called "Shell" has been in-
  121.               cluded in so that you may verify that the recog-
  122.               nizer is installed correctly.
  123.             ----------------------------------------------------
  124.  
  125.  Adding Icons to aif_recognizer
  126.  
  127.    1. Edit the file "aif_icons" to add the source definition of the new
  128.       icon.  Consult your GWINDOWS manual for a complete description of how
  129.        icons are defined or use the provided icons as a guide.
  130.  
  131.    2. Compile and link the new version of aif_recognizer.
  132.  
  133.    3. Copy the new aif_recognizer into /dd/GWINDOWS/CMDS if necessary.
  134.  
  135.             ----------------------------------------------------
  136.               You will have to quit and restart G-Windows for
  137.               any changes to take effect.
  138.             ----------------------------------------------------
  139.  
  140.  Adding Lfmaker to your custom menu.
  141.  
  142.    1. Change to the directory "GWINDOWS/DESKTOP"
  143.  
  144.    2. Load the file "menu" into your text editor.
  145.  
  146.    3. Decide where you want the new entry to go and add the line:
  147.       "Launch File Editor" Lfmaker @ <>>>%
  148.       (Type the quotation marks as entered).
  149.  
  150.    4. Save the edited file and exit the text editor.
  151.  
  152.    5. Pull down "Refresh Custom Menu" from "Services" in the main Desktop
  153.       menu.
  154.  
  155.