home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD5.iso / workbench / tools / czesc_1 / assigns1.1 / docs / english.doc < prev    next >
Encoding:
Text File  |  1993-03-07  |  11.7 KB  |  367 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
  16. servers. If you want to distribute this program you *must* use the original
  17. distribution archive `Assigns1_0.lha'.
  18.  
  19.  
  20. Assigns v1.1
  21. *************
  22.  
  23.  
  24. Copyright and other legal stuff
  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
  44. servers. If you want to distribute this program you *must* use the original
  45. distribution archive `Assigns1_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.    Assigns is a preference editor that fills a lack of WorkBench.
  70.  
  71.    Using Assigns you don't need any more tens of assign lines in your
  72. "User-Startup", it's all made in a single line (or even less, *note
  73. Installation::.).
  74.  
  75.    Assigns is not an "Assign-Manager", it has to be used as an utility to start
  76. when booting the system, and it handles all your assigns. It can even add
  77. assigns and activate them just as c:assign (but these cannot be removed).
  78.  
  79.    I'm thinking about adding assign removal, to make of Assigns a complete
  80. independent substitutive utility, but this operation seems to be discouraged
  81. even by the operating system manual (*note Future develops::.).
  82.  
  83.    About this we may note that doesn't exists a system call meant to remove
  84. assignments, neither DEFER or PATH, and then there isn't a "legal" way to
  85. remove them.
  86.  
  87.    Assigns is the first program I made that I decided to leave of public
  88. domain, and I've been careful following all Commodore standards. Thus the
  89. window is an AppWindow font-sensitive, it works with iff files, accepts the
  90. command "version", can be used either from WorkBench or from CLI, and uses the
  91. same kind of menus of all the other prefs.
  92.  
  93.  
  94. Installation
  95. *************
  96.  
  97.    The installation is really easy:
  98.  
  99.    - Copy "Assigns" and "Assigns.info" in "SYS:prefs". If your processor is a
  100.      68030 or 68040 you may choose the optimized version named "Assigns.030".
  101.      Copy and rename it in place of normal "Assigns".
  102.  
  103.    - Copy in LOCALE:Catalogs/<language> the file of your language, if is
  104.      present in the archive. If not, you can fill the empty catalog
  105.      Assigns.ct: if you will send me, I'll include it in the next version.
  106.  
  107.    - Activate Assigns
  108.  
  109.    - use option "Read System List" from "Edit" menu
  110.  
  111.    - Delete with "Del" button all unmodified default system assignments in the
  112.      assign list, such as:
  113.  
  114.           C: CLIPS: DEVS: ENV: ENVARC: FONTS:
  115.           HELP: KEYMAPS: L: LIBS: LOCALE:
  116.           PRINTERS: REXX: S: SYS: T:
  117.  
  118.    - Did you add custom assigns in your User-Startup or Startup-Sequence?
  119.  
  120.         * If yes:
  121.  
  122.              - Save your list in "SYS:WbStartup" with "Save As..." from
  123.                "Project" menu
  124.  
  125.         * If no:
  126.  
  127.              - Save configuration with "SAVE" button
  128.  
  129.              - Add before the first call of your custom assign:
  130.  
  131.                     SYS:Prefs/Assigns USE
  132.  
  133.    The installation is completed.
  134.  
  135.  
  136. Use
  137. ****
  138.  
  139.    Assign has either CLI and WB interface.
  140.  
  141.    Activating the "EDIT" flag or executing Assigns from WorkBench editing
  142. window is opened.
  143.  
  144.    Opening the program by icon you can set some tooltypes similar to CLI
  145. parameters. Of course these tooltypes may be selected even in the project icons
  146. created by Assigns and used to load it.
  147.  
  148.    To add a new assignment just click on `ADD' gadget of the Assign-List.
  149. You'll be asked for a new Target.
  150.  
  151.    If desired target directory doesn't exists yet, exit from the file
  152. requester with "CANCEL". This will activate the gadget string for input.
  153.  
  154.    You may choose one of the following types:
  155.  
  156.                 ABSOLUTE
  157.                 DEFER
  158.                 PATH
  159.  
  160.    You may want to know whether or not an assignment is succesfully activated
  161. or not (WARN)
  162.  
  163.    Last you may need to activate immediately the assign, selecting "IMMEDIATE"
  164. button. This may be useful to add assigns referred to other assignments:
  165. Assigns handles fine even these. If you choose "ABSOLUTE" type you will can
  166. add more TARGETS by clicking on "ADD" button. "DEL" button delete the selected
  167. target.
  168.  
  169.    Assigns allows even to add targets by choosing the assign from the
  170. assign-list and then carry the path (directory o device) icon above Assigns
  171. window.
  172.  
  173.    This is useful to select several targets simultaneously.
  174.  
  175.    If the icon was a valid preference file, it'll be used.
  176.  
  177.    By a single click on a TARGET you can modify its path using the gadget
  178. string. With a double click you choose it from a file requester.
  179.  
  180.    From menu you can choose other options.
  181.  
  182.    The last three buttons:
  183.  
  184. *`SAVE'
  185.      Saves configuration on disk, executes the assignments and exits.
  186.  
  187. *`USE'
  188.      Saves configuration on RAM:, executes the assignments and exits. The
  189.      configuration won't be available after a reboot.
  190.  
  191. *`CANCEL'
  192.      Exits without saving or executing assignments.
  193.  
  194.    Obviously, as any preference editor, even Assigns may be started once a
  195. time: starting a second instance returns only a "popup" of the existent
  196. Assigns window and its activation.
  197.  
  198.  
  199. CLI Execution
  200. **************
  201.  
  202.    CLI syntax (available typing `Assigns ?'):
  203.  
  204.      FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,BOX3D/S
  205.  
  206.     -`FROM'
  207.           File to be load instead of "ENV:Sys/Assign.prefs". FROM key may be
  208.           omitted.
  209.  
  210.     -`EDIT' [Default]
  211.           Once loaded prefs file, opens editing window to allow changes
  212.  
  213.     -`USE'
  214.           Once loaded prefs file, executes assignments and exits.
  215.  
  216.     -`SAVE'
  217.           Once loaded prefs file, saves it on "ENVARC:Sys/Assign.prefs",
  218.           executes the assignments and exits.
  219.  
  220.     -`PUBSCREEN' <pub screen name>
  221.           Opens editing window on indicated public screen.
  222.  
  223.     -`BOX3D'
  224.           Around the two groups of gadgets "Assign" and "Target(s)" there is a
  225.           NeXT-like box. Selecting Yes or No you choose to use or not it.
  226.  
  227.  
  228.  
  229. ToolTypes
  230. **********
  231.  
  232.    The availables ToolTypes (usable even by Assigns's icons) are:
  233.  
  234.     -`EDIT' [Default]
  235.           Once loaded prefs file, opens editing window to allow changes
  236.  
  237.     -`USE'
  238.           Once loaded prefs file, executes assignments and exits.
  239.  
  240.     -`SAVE'
  241.           Once loaded prefs file, saves it on "ENVARC:Sys/Assign.prefs",
  242.           executes the assignments and exits.
  243.  
  244.     -`CREATEICONS=YES|NO' [Default = YES]
  245.           Choose Yes/No whether or not you want to create icons for the files
  246.           created with 'Save As...' from menu (*note Menu::.).
  247.  
  248.     -`PUBSCREEN' <pub screen name>
  249.           Opens editing window on indicated public screen.
  250.  
  251.     -`BOX3D=YES|NO' [Default = YES]
  252.           Around the two groups of gadgets "Assign" and "Target(s)" there is a
  253.           NeXT-like box. Selecting Yes or No you choose to use or not it.
  254.  
  255.    You may select EDIT,USE and SAVE even as:
  256.  
  257.      ACTION=EDIT | USE | SAVE
  258.  
  259.  
  260. Menu
  261. *****
  262.  
  263.     *`Project'
  264.          -`Open...'
  265.                Allows to load a previously saved prefs file.
  266.  
  267.          -`Save As...'
  268.                Saves assign-lists. If set CREATEICONS YES, an icon is added to
  269.                the file. The icon may be used to activate the assign-list
  270.                without starting Assigns. Default tooltype is `ACTION=USE'.
  271.  
  272.          -`Quit'
  273.                Quits the program.
  274.  
  275.     *`Edit'
  276.          -`Read System List'
  277.                Reads all present system or custom assignments. You lose the
  278.                currents eventually listed assignments.
  279.  
  280.          -`Last Saved'
  281.                Reads last saved assignments from ENVARC: You lose the currents
  282.                eventually listed assignments.
  283.  
  284.          -`Restore'
  285.                Loads last valid assignments from ENV: You lose the currents
  286.                eventually listed assignments.
  287.  
  288.     *`Settings'
  289.          -`Create Icons?'
  290.                (Flag) Tells whether or not to add an icon to the file generated
  291.                by Assigns with "Save As..." option. When starting takes
  292.                tooltype (*note ToolTypes::.) CREATEICONS value. Default is Yes.
  293.  
  294.  
  295. Distribution
  296. *************
  297.  
  298.    The complete distributed Assigns package includes:
  299.  
  300.      Assigns1.1.info
  301.      Assigns1.1/Assigns                      * 680X0 version
  302.      Assigns1.1/Assigns.030                  * 68030/881 version
  303.      Assigns1.1/Assigns.info
  304.      Assigns1.1/Docs.info
  305.      Assigns1.1/Docs/Italiano.doc
  306.      Assigns1.1/Docs/Italiano.doc.info
  307.      Assigns1.1/Docs/Italiano.guide
  308.      Assigns1.1/Docs/Italiano.guide.info
  309.      Assigns1.1/Docs/Italiano.dvi
  310.      Assigns1.1/Docs/Italiano.dvi.info
  311.      Assigns1.1/Docs/Italiano.texi
  312.      Assigns1.1/Docs/Italiano.texi.info
  313.      Assigns1.1/Docs/English.doc             * plain ASCII docs
  314.      Assigns1.1/Docs/English.doc.info
  315.      Assigns1.1/Docs/English.guide           * AmigaGuide docs
  316.      Assigns1.1/Docs/English.guide.info
  317.      Assigns1.1/Docs/English.dvi             * DVI docs
  318.      Assigns1.1/Docs/English.dvi.info
  319.      Assigns1.1/Docs/English.texi            * TeXinfo sources
  320.      Assigns1.1/Docs/English.texi.info
  321.      Assigns1.1/Locale/Catalogs/Italiano/Assigns.catalog
  322.      Assigns1.1/Locale/Catalogs/Assigns.ct
  323.  
  324.    These files MUST be present.
  325.  
  326.  
  327. Future develops
  328. ****************
  329.  
  330.    Now the program works fine and is reliable, next version will be optimized
  331. in memory usage.
  332.  
  333.    I intend to write the next version of Assigns in C++ and I'm beginning to
  334. study some objects for programming in AmigaDOS.
  335.  
  336.    Lastly: make of Assigns an "Assign-Manager", but there are some problems.
  337.  
  338.  
  339. Versions
  340. *********
  341.  
  342.    Assigns1.0: first release, full working. Only for betatesters
  343.  
  344.    Assigns1.1: first public release. Changes: localization and some bugs
  345. fixed, especially the wrong activation of some gadgets.
  346.  
  347.  
  348. Greetings
  349. **********
  350.  
  351.    My greetings for the help (tests and suggestions) are for: (1):
  352.  
  353.      Alessandro Borille    paride@sabrina.dei.unipd.it
  354.      Eugenio Castellani    aj2@sabrina.dei.unipd.it
  355.      Fabio D'Alessi        phobia@sabrina.dei.unipd.it
  356.      Sergio Fantinel       ik3fan@paola.dei.unipd.it
  357.      Jacopo Farinato       redi@sabrina.dei.unipd.it
  358.      Gianluigi Nusca       gigio@paola.dei.unipd.it
  359.      Emanuele Verza        alien@sabrina.dei.unipd.it
  360.  
  361.    Specially Alessandro and Eugenio for italian to english translation.
  362.  
  363.    ---------- Footnotes ----------
  364.  
  365.    (1)  alphabetically listed
  366.  
  367.