home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / utilities / misc / paths1.0 / docs / english.doc next >
Text File  |  1993-03-10  |  12KB  |  371 lines
  1. Permission is granted to make and distribute verbatim copies of this manual
  2. provided the copyright notice and this permission notice are preserved on all
  3. copies.
  4.  
  5.    We don't guarantee that the programs described in this document are 100%
  6. reliable. You are using this material at your own risk. The author *can not*
  7. be made responsible for any damage which is caused by using these programs.
  8.  
  9.    This package is freely distributable, but still copyright by Enrico Fedrigo.
  10. This means that you can copy it freely as long as you don't ask for a more
  11. than nominal copying fee. This fee *must not* be more than US $5.
  12.  
  13.    Permission is granted to include this package in Public-Domain collections,
  14. especially in Fred Fish Amiga Disk Library (including CD ROM versions of it).
  15. The distribution file may be uploaded to Bulletin Board Systems or FTP servers.
  16. If you want to distribute this program you *must* use the original
  17. distribution archive `Paths1_0.lha'.
  18.  
  19.  
  20. Paths v1.0
  21. ***********
  22.  
  23.  
  24. Copyright
  25. **********
  26.  
  27.    Copyright (C) 1993
  28.  
  29.    Permission is granted to make and distribute verbatim copies of this manual
  30. provided the copyright notice and this permission notice are preserved on all
  31. copies.
  32.  
  33.    We don't guarantee that the programs described in this document are 100%
  34. reliable. You are using this material at your own risk. The author *can not*
  35. be made responsible for any damage which is caused by using these programs.
  36.  
  37.    This package is freely distributable, but still copyright by Enrico Fedrigo.
  38. This means that you can copy it freely as long as you don't ask for a more
  39. than nominal copying fee. This fee *must not* be more than US $5.
  40.  
  41.    Permission is granted to include this package in Public-Domain collections,
  42. especially in Fred Fish Amiga Disk Library (including CD ROM versions of it).
  43. The distribution file may be uploaded to Bulletin Board Systems or FTP servers.
  44. If you want to distribute this program you *must* use the original
  45. distribution archive `Paths1_0.lha'.
  46.  
  47.  
  48. Address
  49. ********
  50.  
  51.    Author may be reached at:
  52.  
  53. Postal Address
  54.  
  55.               Enrico Fedrigo
  56.               via Giacomo Leopardi, 6
  57.               31033 Castelfranco Veneto (Treviso)
  58.                     ITALY
  59.  
  60. Electronic Mail (InterNet):
  61.  
  62.           fedro@sabrina.dei.unipd.it
  63.           fedro@paola.dei.unipd.it
  64.  
  65.  
  66. Introduction
  67. *************
  68.  
  69.    Paths is a preference editor that fills a lack of WorkBench.
  70.  
  71.    Using Paths you don't need anymore tens of path lines in your
  72. "User-Startup", it's all made in a single line (or even less, *note
  73. Installation::.).
  74.  
  75.    Paths may be useful both for the boot and for adding or removing global or
  76. local paths during your works.
  77.  
  78.    Paths is the second program I made that I decided to leave of public domain,
  79. and I've been careful following all Commodore standards. Thus the window is an
  80. AppWindow font-sensitive, it works with iff files, accepts the command
  81. "version", can be used either from WorkBench or from CLI, and uses the same
  82. kind of menus of all the other prefs.
  83.  
  84.  
  85. Installation
  86. *************
  87.  
  88.    The installation is really easy:
  89.  
  90.    - Copy "Paths" and "Paths.info" in "SYS:prefs". If your processor is a
  91.      68030 or 68040 you may choose the optimized version named "Paths.030".
  92.      Copy and rename it in place of normal "Paths".
  93.  
  94.    - Copy in LOCALE:Catalogs/<language> the file of your language, if is
  95.      present in the archive. If not, you can fill the empty catalog Paths.ct:
  96.      if you will send me, I'll include it in the next version.
  97.  
  98.    - Activate Paths
  99.  
  100.    - use option "Read System List" from "Edit" menu
  101.  
  102.    - Delete with "Del" button all unmodified default system path assignments
  103.      in the path list, such as(1):
  104.  
  105.           C: S: SYS:Tools SYS:Tools/Commodities SYS:Utilities
  106.           SYS:Rexxc SYS:System SYS:Prefs SYS:WbStartup
  107.  
  108.    - Did you add custom paths in your User-Startup or Startup-Sequence?
  109.  
  110.         * If not:
  111.  
  112.              - Save your list in "SYS:WbStartup" with "Save As..." from
  113.                "Project" menu
  114.  
  115.         * If yes:
  116.  
  117.              - Save configuration with "SAVE" button
  118.  
  119.              - Add before the first call of your custom paths:
  120.  
  121.                     SYS:Prefs/Paths USE
  122.  
  123.    The installation is completed.
  124.  
  125.    ---------- Footnotes ----------
  126.  
  127.    (1)  Warning: you won't find symbolic devices C:, S: etc., but their full
  128. name
  129.  
  130.  
  131. Use
  132. ****
  133.  
  134.    Paths has either CLI and WB interface.
  135.  
  136.    If you start the program from WB you will be able to change only global
  137. paths, while starting it from shell you will be able to change even shell's
  138. own local paths without interfering with global workBench paths. In
  139. "Preferences" mode you will modify the path list for the next boot or even the
  140. current (local or global) list. You can change mode from "Preference" option
  141. in the "Project" menu.
  142.  
  143.    Important: when changing paths from "Preferences" mode, they will be added
  144. (without double paths) to the currents ones; otherwise they will entirely
  145. substitute the old ones.
  146.  
  147.    Activating the "EDIT" flag or executing Paths from WorkBench editing window
  148. is opened.
  149.  
  150.    Opening the program by icon you can set some tooltypes similar to CLI
  151. parameters. Of course these tooltypes may be selected even in the project
  152. icons created by Paths and used to load it.
  153.  
  154.    To add a new path just click on `ADD' gadget. You'll be asked for a new
  155. Target. "DEL" button deletes selected destination.
  156.  
  157.    List order is really important: the directory that includes the common use
  158. commands should be first in list. You may change the order simply by selecting
  159. one by one the paths and chosing "First", "Up", "Down", "Last". These actions
  160. allow to move the selected path to top of list, up/down of one place and at
  161. bottom of list.
  162.  
  163.    Paths allows even to add targets by carrying the path (directory or device)
  164. icon above Paths window. This is useful to select several targets
  165. simultaneously.
  166.  
  167.    If the icon was a valid preference file, it'll be used.
  168.  
  169.    By a single click on a TARGET you can modify its path using the gadget
  170. string. With a double click you choose it from a file requester.
  171.  
  172.    From menu you can choose other options.
  173.  
  174.    The last three buttons:
  175.  
  176. *`SAVE'
  177.      Saves configuration on disk (ENVARC:), executes the changes and exits.
  178.  
  179. *`USE'
  180.      Saves configuration on ram (ENV:), executes the changes and exits. The
  181.      configuration won't be available after a reboot.
  182.  
  183. *`CANCEL'
  184.      Exits without saving or executing assignments.
  185.  
  186.    Obviously, as any preference editor, even Paths may be started once a time:
  187. starting a second instance returns only a "popup" of the existent Paths window
  188. and its activation.
  189.  
  190.  
  191. CLI Execution
  192. **************
  193.  
  194.    CLI syntax (available typing `Paths ?'):
  195.  
  196.      FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,BOX3D/S,PREFERENCE/K,GLOBAL/K
  197.  
  198.     -`FROM'
  199.           File to be load instead of "ENV:Sys/Path.prefs". FROM key may be
  200.           omitted.
  201.  
  202.     -`EDIT' [Default]
  203.           Once loaded prefs file, opens editing window to allow changes
  204.  
  205.     -`USE'
  206.           Once loaded prefs file, executes paths and exits.
  207.  
  208.     -`SAVE'
  209.           Once loaded prefs file, saves it on "ENVARC:Sys/Path.prefs",
  210.           executes the paths and exits.
  211.  
  212.     -`PUBSCREEN' <pub screen name>
  213.           Opens editing window on indicated public screen.
  214.  
  215.     -`BOX3D'
  216.           The gadgets have a contour, there is a NeXT-like box. Selecting Yes
  217.           or No you choose to use or not it. (This is not an Amiga standard)
  218.  
  219.     -`PREFERENCE'
  220.           By default the program allows to change a preference file and add
  221.           paths. Selecting this flag you get the exact image of all present
  222.           system paths (local and global) and you can change, add or remove.
  223.  
  224.     -`GLOBAL'
  225.           By default a shell starting Paths works on local paths. Selecting
  226.           this flag you can edit global paths.
  227.  
  228.      You may change local/global mode even from the program, changing it with
  229.      the CYCLE-gadget.
  230.  
  231.  
  232. ToolTypes
  233. **********
  234.  
  235.    The availables ToolTypes (usable even by Paths's icons) are:
  236.  
  237.     -`EDIT' [Default]
  238.           Once loaded prefs file, opens editing window to allow changes
  239.  
  240.     -`USE'
  241.           Once loaded prefs file, executes assignments and exits.
  242.  
  243.     -`SAVE'
  244.           Once loaded prefs file, saves it on "ENVARC:Sys/Path.prefs",
  245.           executes the assignments and exits.
  246.  
  247.     -`CREATEICONS=YES|NO' [Default = YES]
  248.           Choose Yes/No whether or not you want to create icons for the files
  249.           created with 'Save As...' from menu (*note Menu::.).
  250.  
  251.     -`PUBSCREEN' <pub screen name>
  252.           Opens editing window on indicated public screen.
  253.  
  254.     -`BOX3D=YES|NO' [Default = YES]
  255.           The gadgets have a contour, there is a NeXT-like box. Selecting Yes
  256.           or No you choose to use or not it. (This is not an Amiga standard)
  257.  
  258.    You may select EDIT,USE and SAVE even as:
  259.  
  260.      ACTION=EDIT | USE | SAVE
  261.  
  262.  
  263. Menu
  264. *****
  265.  
  266.     *`Project'
  267.          -`Open...'
  268.                Allows to load a previously saved prefs file.
  269.  
  270.          -`Save As...'
  271.                Saves paths-lists. If CREATEICONS is YES, an icon is added to
  272.                the file. The icon may be used to activate the paths-list.
  273.                Default tooltype is `ACTION=USE'.
  274.  
  275.          -`Quit'
  276.                Quits the program.
  277.  
  278.     *`Editor'
  279.          -`Read System List'
  280.                Reads all present system or custom assigned paths. You lose the
  281.                currents eventually listed assignments.
  282.  
  283.          -`Preference'
  284.                Switch from Preference mode, in which you can edit preference
  285.                file and paths will be added to the selected environnement, to
  286.                the second mode in which you can modify actually present paths
  287.                in the selected environnement.
  288.  
  289.          -`Last Saved'
  290.                Reads last saved assignments from ENVARC: You lose the currents
  291.                eventually listed assignments.
  292.  
  293.          -`Restore'
  294.                Loads last valid assignments from ENV: You lose the currents
  295.                eventually listed assignments.
  296.  
  297.     *`Settings'
  298.          -`Create Icons?' (Flag)
  299.                Tells whether or not to add an icon to the file generated by
  300.                Paths with "Save As..." option. When starting takes tooltype
  301.                (*note ToolTypes::.) CREATEICONS value. Default is Yes.
  302.  
  303.  
  304. Distribution
  305. *************
  306.  
  307.    The complete distributed Paths package includes:
  308.  
  309.      Paths1.0.info
  310.      Paths1.0/Paths                      * 680x0 version
  311.      Paths1.0/Paths.030                  * 68030/881 version
  312.      Paths1.0/Paths.info
  313.      Paths1.0/Docs.info
  314.      Paths1.0/Docs/Italiano.doc
  315.      Paths1.0/Docs/Italiano.doc.info
  316.      Paths1.0/Docs/Italiano.guide
  317.      Paths1.0/Docs/Italiano.guide.info
  318.      Paths1.0/Docs/Italiano.dvi
  319.      Paths1.0/Docs/Italiano.dvi.info
  320.      Paths1.0/Docs/Italiano.texi
  321.      Paths1.0/Docs/Italiano.texi.info
  322.      Paths1.0/Docs/English.doc           * plain ASCII docs
  323.      Paths1.0/Docs/English.doc.info
  324.      Paths1.0/Docs/English.guide         * AmigaGuide docs
  325.      Paths1.0/Docs/English.guide.info
  326.      Paths1.0/Docs/English.dvi           * DVI docs
  327.      Paths1.0/Docs/English.dvi.info
  328.      Paths1.0/Docs/English.texi          * TeXinfo sources
  329.      Paths1.0/Docs/English.texi.info
  330.      Paths1.0/Locale/Catalogs/Italiano/Paths.catalog
  331.      Paths1.0/Locale/Catalogs/Paths.ct
  332.  
  333.    These files MUST be present.
  334.  
  335.  
  336. Future develops
  337. ****************
  338.  
  339.    Now the program works fine and is reliable, next version will be optimized
  340. in memory usage.
  341.  
  342.    I intend to write the next version of Paths in C++ and I'm beginning to
  343. study some objects for programming in AmigaDOS.
  344.  
  345.  
  346. Versions
  347. *********
  348.  
  349.    Paths1.0: first public release.
  350.  
  351.  
  352. Greetings
  353. **********
  354.  
  355.    My greetings for the help (tests and suggestions) are for: (1):
  356.  
  357.      Alessandro Borille    paride@sabrina.dei.unipd.it
  358.      Eugenio Castellani    aj2@sabrina.dei.unipd.it
  359.      Fabio D'Alessio       phobia@sabrina.dei.unipd.it
  360.      Sergio Fantinel       ik3fan@paola.dei.unipd.it
  361.      Jacopo Farinato       redi@sabrina.dei.unipd.it
  362.      Gianluigi Nusca       gigio@paola.dei.unipd.it
  363.      Emanuele Verza        alien@sabrina.dei.unipd.it
  364.  
  365.    Specially Alessandro and Eugenio for italian to english translation.
  366.  
  367.    ---------- Footnotes ----------
  368.  
  369.    (1)  alphabetically listed
  370.  
  371.