home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 335.lha / PathAssign_v1.1 / README.1.1 < prev    next >
Text File  |  1990-01-10  |  10KB  |  272 lines
  1.  
  2.                  PathAssign V1.1
  3.                  ~~~~~~~~~~~~~~~
  4.              Written by Anders `ALi' Lindgren
  5.  
  6.  
  7.                    Introduction
  8.                    ~~~~~~~~~~~~
  9.     This is a program which increases the flexibility of the AmigaDOS
  10.     system. The basic idea is to replace the old standard assignments
  11.     with new which can read from a several different (i.e. a path) of
  12.     directories. This operation is totaly transparent to the user and to
  13.     normal programs.
  14.  
  15.     To use the program, read and follow the instructions found in the
  16.     `Installation' paragraph below. Then read the `Function' and `Usage'
  17.     section, or the supplied manual file `PathAss.man'
  18.  
  19.     If you are a novice, this text may seem a little `complicated', but
  20.     don`t panic. The AmigaDOS and CLI is not so difficult, just try it
  21.     and you will LOVE it. As a last resort, I can only recomend you to
  22.     read one of the many books on the topic.
  23.  
  24.  
  25.                 Function:
  26.                 ~~~~~~~~~
  27.     A PathAssignemnt works like a normal assignment, the difference lies
  28.     in the fact that is can contain several directories. For example,
  29.     the direcory HELLO: can be assignmed to `DF0:hi' AND `DF1:goodbye'.
  30.     This is very helpful if there is useful files in several different
  31.     disks and you would like to access them like they here stored in one
  32.     single directory.
  33.  
  34.     The main reason to use this program is to gain more flexibility out
  35.     of already existing programs. For examples the AmigaDOS make six
  36.     different assignments at the startup. These are C:, S:, L:, LIBS:,
  37.     DEVS: and FONTS:. These can be replaces by ekvivialent Path-
  38.     Assignments so vd0:, df0: and df1: will be searched, for example.
  39.  
  40.     Everybody can benifit from this program, from one disk owners to
  41.     people who has 300 Mb HDs, only your imagination will stop you!
  42.     Here are some tips:
  43.  
  44.       - One drive (and two drive owners) with a shortage of RAM can
  45.         place a few of their favorite commands on every disk. No
  46.         irritating diskswapping will occoure.
  47.  
  48.       - Some comands and libraries can be placed in RAM: (or VD0:), the
  49.         rest can be kept on a diskett.
  50.  
  51.       - HD owners sometimes don`t want to fill up their HD with several
  52.         program (they do get filledup.) They simply can make a
  53.         assignment to hd0:,RAD:,df0:,df1:,df2:,df3: and to every other
  54.         device they own...
  55.  
  56.       - Lattice C and assembler programmers can place some often used
  57.         headerfiles and libraries in RAM and place the rest on disk.
  58.  
  59.  
  60.     The order of the directories are significant. The program scans the
  61.     directories from the beginning so put the references to ram based
  62.     devices first.
  63.       NOTE: Files that don`t exist in any directory will be written to
  64.     the first dir in the list!
  65.  
  66.     Note alse that PathAss doesn`t put put out any filerequesters, so if
  67.     a file isn`t found, PathAss will return an error immediatley.
  68.  
  69.     Another feuture of this program is that it doesn`t consider
  70.     assignments volume-relative, as the AmigaDos assignment command
  71.     does. PathAss consider them device-relative. This means when an
  72.     assignment is made to df0: PathAss will look at the volume currently
  73.     is df0:, while Assign would check the volume that was inserted in
  74.     df0: at the time of the assignment.
  75.  
  76.                To the advanced user:
  77.           PathAssignments is implemented as normal AmigaDOS devices. The
  78.           handler program is `Path-Handler'. This program handles almost
  79.           every packet type existing on the Amiga. This code will search
  80.           each specified directory in turn.
  81.  
  82.           To programmers: Don`t assume that the standard Amiga logical
  83.           devices ARE assignments (i.e. DLT_DIRECTORY), they aren`t! (At
  84.           least not on my system.)
  85.  
  86.  
  87.                   Usage:
  88.                   ~~~~~~
  89.       To make a assigement write for examples:
  90.         PathAss name: df1:,df0:
  91.  
  92.     If `name:' exists as a device or volume, the operation will fail,
  93.     otherwise the system will have a new PathAssignment. If `name:' is
  94.     a normal assignment or a PathAssignment it will be replaced with
  95.     the new one. The PathAssignment will stay activated until it is
  96.     deleted or replaced with an other PathAssignment.
  97.  
  98.     The dirs is separated with a comma. No blanks can be inserted
  99.     between dirs. If a blank is embedded in a dirname, quote the whole
  100.     string. Example:
  101.         PathAss name: "hello:,hi there:"
  102.  
  103.     To list all current PathAssignments write:
  104.         PathAss -l
  105.  
  106.     To delete an assignment write:
  107.         PathAss -d name:
  108.          or PathAss name:
  109.  
  110.      (Note: This also deletes old AmigaDos assignments)
  111.  
  112.     You can see a short help text by writing:
  113.         PathAss -h
  114.  
  115.     If no arguments are specified, the PathAssignments will be listed if
  116.     there exist any, otherwise the help text will be typed.
  117.  
  118.     Important: Because the komplexity (.Hmmm.) of AmigaDos and CLI, C:
  119.     must be an assignment, I recommend the following workaround:
  120.  
  121.          Make a PathAssign to another device with the path that normally
  122.          would have been the C: path. Then assign C: to that device.
  123.  
  124.         Example:
  125.         PathAss CX: vd0:c,df0:c,df1:c
  126.         Assign    C: CX:
  127.  
  128.     I strongly suggest that you insert the PathAssignments in your
  129.     startup-sequence file.
  130.  
  131.  
  132.     Normal examples:
  133.     PathAss devs:     vd0:devs,df1:devs,df0:devs
  134.     PathAss include: vd0:myinc,lattice5.0.2:CompactH
  135.     PathAss fonts:     vd0:fonts,df0:fonts,df1:fonts
  136.     PathAss fonts:
  137.     PathAss -l
  138.     PathAss -h
  139.     PathAss
  140.     (Please note:)
  141.     PathAss cx:     vd0:c,df0:c,df1:c
  142.     Assign    c: cx:
  143.  
  144.  
  145.                    Insallation:
  146.                    ~~~~~~~~~~~~
  147.  
  148.     To use the program you put the file `path-handler' in your L:
  149.     directory and the PathAss command in C:. For you non-CLI masters
  150.     I have included the script `Install' to do this for you.
  151.     (Type `Execute Install' at the CLI prompt.)
  152.  
  153.  
  154.                 Contents
  155.                 ~~~~~~~~
  156.     The following files are included in the .zoo archive:
  157.         PathAss         - The actual command. Place it in C:
  158.         Path-Handler        - The device-handler. -----"----- L:
  159.         PathAss.man        - A manual file in UNIX-format.
  160.         ReadMe.1.1        - This file
  161.         Install         - Script file to install PathAss.
  162.         PathAll         - Example Script file. PathAssigns
  163.                     all AmigaDos assignments to
  164.                     vd0:, df0: and df1:
  165.  
  166.  
  167.                   Current Satus
  168.                   ~~~~~~~~~~~~~
  169.     The PathAss program is shareware. To become a registred user just
  170.     pay the fee, $10, to the address below. I will accept payment in
  171.     any currency, like swedish crowns, new PD/SW programs, clean disks
  172.     and so on. All registred users will recieve the lastest version of
  173.     the program and the sourcecode. All registed users can send in an
  174.     empty disk and return postage to get the absolute latest version of
  175.     the program and source.
  176.  
  177.     To pay the fee, ask any question, complain, bug reports,
  178.     suggestions, ask for autograps etc. Please write to:
  179.  
  180.         SNAIL-MAIL:   Anders `ALi' Lindgren
  181.               Mälarblick 8
  182.               S-161 51
  183.               Bromma Sweden
  184.  
  185.         PHONE:      No thanks, no calls at 3 AM.......
  186.  
  187.     Or contact me on the swedish Amiga base `Camelot'.
  188.  
  189.     The author takes no responsibility what so ever!
  190.     Use the program on your own risk!
  191.  
  192.  
  193.                  Credits:
  194.                  ~~~~~~~~
  195.     I here give a big thanks for all of you who has sent is a ShareWare
  196.     registrartion, it was beyond my wildest dreams that anyone would do
  197.     that. I will also apologize for those who hasn`t heard of me while I
  198.     was develloping V1.1. (I told my self next week, next week... But
  199.     now it`s finally finished, I hope. You know, it takes a month to
  200.     repair a broken computer here in Sweden :-( )
  201.  
  202.     A big thank goes to they who tested the prereleases, sent in
  203.     bugreports, and to they who supported me morally by saying that they
  204.     actually used my product, and liked it. (Hmmm, how about the SW
  205.     notice.... :-) )
  206.  
  207.     Another big thanks goes to all other PD/SW devellopers around the
  208.     world. Their effort has made the Amiga was it is today, i.e. a FUN
  209.     machine to use.
  210.  
  211.  
  212.                    Background
  213.                    ~~~~~~~~~~
  214.     The idea to this program first popped into my mind when I was
  215.     thinking of an alternate method of storing the fonts in the Fonts:
  216.     The reason why it become a complete program was because a friend of
  217.     mine claimed that it couldn`t be done.
  218.  
  219.     The program was develloped om my Amiga 500 with 2 drives and a 2Mb
  220.     memory expansion unit. It was developped using Lattice V 4.0, but
  221.     the progran is now compiled with V 5.02.
  222.  
  223.  
  224.                   Future Fixes
  225.                   ~~~~~~~~~~~~
  226.     In the occourance of free time, and user response, I have a few
  227.     extra implementations to work on, these are among else:
  228.  
  229.         - Put out system requesters for volume relative access.
  230.           (I maybe add a flag for this.)
  231.  
  232.         - Fix the memory bug in the release process of the resident
  233.           segment. (Sorry, but this version is _late_ already).
  234.  
  235.         - Make the executable shorter, I might use the Arp librarys
  236.           Printf() and Assign( ,NULL) functions. (So far I have written
  237.           everything on my own.) I migth even rewrite some parts in
  238.           Assembler.
  239.  
  240.         - Make the PathAss code pure. (Mabye it is, I don`t know.)
  241.  
  242.         - Multiple assignments and/or file (script) assignments.
  243.  
  244.         - Make the PathAssignments DLT_DIRECTORY`s, which in turn
  245.           has locked a separate PATH:-device. This will fix the
  246.           C: feature
  247.  
  248.         - Start the process only when accessed. This would save _some_
  249.           memory. (At least 3Kb per device :-) )
  250.  
  251.                  Release History
  252.                  ~~~~~~~~~~~~~~~
  253.  
  254.     0.9x    Prerelease.
  255.         Use on your own risk :-)
  256.  
  257.     1.0     (88-11-21) Release
  258.         Full program. Delete. Replace.
  259.  
  260.     1.0b    (88-12-29) Very small release
  261.         Only minor fixes and cleanups.
  262.  
  263.     1.1     (89-09-08) Release.
  264.         - Handler code made resident!
  265.         - L: bug fixed!
  266.         - Protection bit support added. (Sorry, forgot it in V1.0)
  267.         - Comment code added.
  268.         - Code cleanup and several small bug fixed.
  269.         - several small bug fixed. (i.e. more relaiable program.)
  270.  
  271.  
  272.