home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / pinextend / !PinExtend / !Help < prev    next >
Text File  |  1996-03-04  |  18KB  |  350 lines
  1.  
  2.  ABOUT THIS PROGRAM
  3.  ---------------------------------------------------------------------------
  4.  Name    : PinExtend
  5.  Version : 1.17 (16 Feb 1996)
  6.  Purpose : Extra pinboard utilities
  7.  Author  : Andrew Berry
  8.  Licence : Freeware. Please see conditions at the end of this file.
  9.  
  10.  PinExtend supports Interactive Help.
  11.  
  12.  
  13.  PURPOSE
  14.  --------------------------------------------------------------------------- 
  15. PinExtend is a small utility designed to make using the pinboard slightly
  16.  easier. It can do the following:
  17.  
  18.       1) Enable the user to make backdrops without dropping the sprite file
  19.          onto the pinboard, selecting the backdrop position, and then
  20.          removing the icon.
  21.  
  22.       2) Place a blank TinyDirs icon on the icon bar without using the
  23.          command line. Although TinyDirs is built into the Pinboard in
  24.          RISC OS 3 there is no option on the Pinboard menu to use TinyDirs
  25.          on the icon bar. Acorn obviously decided that TinyDirs wasn't
  26.          needed because files can be dropped onto the pinboard. However,
  27.          this clutters up the desktop, and icons on the pinboard are harder
  28.          to get to than the icon bar, which can be brought to the front with
  29.          Shift-F12. 
  30.          
  31.       3) Send a dragged object to TinyDirs and put its icon on the icon bar.
  32.       
  33.       4) Automatically load backdrops, make TinyDirs and run an extra file
  34.          on startup.
  35.       
  36.       5) Automatically remove backdrops and TinyDirs on exit, and re-load
  37.          the backdrop selected with !Boot (RISC OS 3.5 or greater) or
  38.          !NewLook (RISC OS 3.1x).
  39.  
  40.  
  41.  THE MENUS
  42.  ---------------------------------------------------------------------------
  43.  The icon bar menu has six items. These are as follows:
  44.  
  45.       1) Info: This leads to a standard info box.
  46.       
  47.       2) Startup...: Selecting this will open a window enabling the startup
  48.          options to be selected. This window is described in detail later.
  49.       
  50.       2) Options...: This will open the options window, which is also
  51.          described later.
  52.  
  53.       3) Backdrop...: This opens the 'Make Backdrop' window which enables you
  54.          to make a backdrop. Clicking with SELECT on the PinExtend icon has
  55.          the same effect. The 'Make Backdrop' window is described in detail
  56.          later.
  57.          
  58.       4) Add TinyDir: Clicking on this will issue the command *AddTinyDir
  59.          which will add a TinyDir icon to the left of the icon bar. TinyDirs
  60.          is part of the pinboard application, and its use is described in the
  61.          user guide. Clicking with ADJUST on the PinExtend icon has the same
  62.          effect as selecting 'Add TinyDir'.
  63.  
  64.       5) Quit: Selecting this will quit the program. TinyDirs and backdrops
  65.          will be removed if the appropriate options are selected in the
  66.          options window. See later.
  67.  
  68.  
  69.  MAKING A BACKDROP
  70.  ---------------------------------------------------------------------------
  71.  To bring up the 'Make Backdrop' window select 'Backdrop...' from the
  72.  iconbar menu or click SELECT on the PinExtend icon on the iconbar. Select
  73.  the position for the backdrop by clicking on the appropriate radio icon.
  74.  Drag a sprite file from a filer window into the 'Make Backdrop' window. The
  75.  filename will appear in the long white box. If the file is dragged to the
  76.  icon bar then the action taken will depend on the setting in the options
  77.  window - see later.
  78.  
  79.  Click OK with SELECT to load the backdrop and close the window, or with
  80.  ADJUST to load the backdrop and keep the window open. The second option is
  81.  useful if you want to experiment with different positions. Closing the
  82.  window will retain the filename of the last sprite dragged into PinExtend
  83.  until the program is quit. This is so the same sprite can be reloaded later
  84.  if needed without the original filer window being needed. 
  85.  
  86.  Clicking on the View button will *Filer_Run the sprite file, causing it to
  87.  be loaded into a suitable application for viewing it, usually !Paint.
  88.  
  89.  Remove removes the current backdrop.
  90.  
  91.  On a pre-Risc PC machine Default loads the default !NewLook backdrop as
  92.  set up by the !NewLook application, providing the appropriate option has
  93.  been set in the options window. On RISC OS 3.5 or greater, the default
  94.  backdrop is reloaded by running Boot:Choices.Boot.Tasks.Configure. Please
  95.  note that this has only been tested with RISC OS 3.6 - if it causes
  96.  problems with 3.5 then please let me know.
  97.  
  98.  
  99.  ADDING A TINYDIR
  100.  ---------------------------------------------------------------------------
  101.  To add a blank TinyDir click ADJUST on the PinExtend icon on the icon bar.
  102.  Dragging a non-sprite object to the PinExtend icon will cause it to be
  103.  added to the TinyDirs application. The action taken when a sprite file is
  104.  dragged depends on the setting in the options window (see later).
  105.  
  106.  
  107.  OPTIONS
  108.  ---------------------------------------------------------------------------  PinExtend has a number of options which can be changed from two windows,
  109.  'Startup' and 'Miscellaneous'. These are opened by clicking on 'Startup...'
  110.  and 'Options...' on the icon bar menu. All options in the options windows
  111.  can be saved by clicking on 'Save' in either window. Clicking on 'Save'
  112.  will save the options for both windows. Selecting 'Exit' will close the
  113.  window and the new options will be remembered.
  114.  
  115.  
  116.  STARTUP OPTIONS
  117.  ---------------------------------------------------------------------------
  118.  The top section of this window is for selecting files, directories or
  119.  applications which will automatically be added to the icon bar (using
  120.  TinyDirs) when PinExtend is started up.
  121.  
  122.    Add TinyDirs from script file : If this is selected then the script file
  123.    will be examined and the filenames of any objects contained within it
  124.    will be added to the icon bar using TinyDirs. See later for a description
  125.    of the script file.
  126.  
  127.    Run extra file... : If this is selected then the file shown in the icon
  128.    will be *Filer_Run after all backdrops and TinyDirs have been set up.
  129.    This could be used to place icons on the pinboard, and should be an Obey
  130.    (or similar) file. Dragging a file to the white icon will insert the
  131.    filename, and clicking on the icon and selecting Clear from the menu will
  132.    clear it and deselect the option.
  133.  
  134.  The second section is used for automatically loading a backdrop on startup.
  135.  Dragging a sprite file to the long white icon will enter its filename, and
  136.  clicking in the box and selecting Clear will clear it. The currently
  137.  selected position for the backdrop is shown on the right and can be changed
  138.  by clicking on it and selecting from the menu. This option is for the
  139.  startup backdrop ONLY, and is independent of the 'Make backdrop' window.
  140.  
  141.  Clicking on 'Edit script file...' will load the script file into your
  142.  normal text editor. It can then be edited and re-saved. Alternatively, it
  143.  can be found within the !PinExtend application directory, named 'Script'.
  144.  
  145.  
  146.  MISCELLANEOUS OPTIONS
  147.  ---------------------------------------------------------------------------
  148.  The top section of this window is for selecting the action which PinExtend
  149.  will take when a sprite file is dragged to the icon bar. The options are as
  150.  follows, and are selected by clicking on the appropriate radio icon.
  151.  
  152.      1)  If 'Make backdrop...' is selected then the sprite will be put onto
  153.          the backdrop using the current options in the 'Make backdrop'
  154.          window. To make the best use of this option, ensure that it is
  155.          selected and set the required position in the 'Make backdrop'
  156.          window. Any sprite file now dragged onto the icon bar will now be
  157.          put on the backdrop without the need to use any windows or menus.
  158.          
  159.      2)  If 'Open backdrop window' is selected then the filename will be
  160.          passed on to the main window, which will be opened.
  161.             
  162.      3)  If 'Add TinyDir' is selected then the file will appear on the
  163.          TinyDirs application on the icon bar.
  164.          
  165.      4)  If 'Query' is selected then a query box will open, giving a choice
  166.          of the above three options.
  167.  
  168.  The white icon in the middle of the window is only needed if you intend
  169.