home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / util / wb / DosMan121.lha / man / Assign < prev    next >
Encoding:
Text File  |  1995-05-19  |  6.3 KB  |  176 lines
  1.  
  2.  
  3.  
  4.                  Assign(V1.3, 2.x, 3.x in C:)
  5.  
  6.  
  7.  
  8.      NAME
  9.             Assign - Binds a device name to a directory or file.
  10.  
  11.      SYNOPSIS
  12.         1.3
  13.           Assign Name Dir Etc/... LIST EXISTS REMOVE
  14.     
  15.         2.x/3.x
  16.           Assign Name Dir Etc/... LIST EXISTS DISMOUNT
  17.             DEFER PATH ADD REMOVE VOLS DIRS DEVICES
  18.  
  19.      DESCRIPTION
  20.             Assign causes NAME: to be a synonym for a directory 
  21.         or a pathname.  This is referred to as a "logical" 
  22.         device, since it appears to the Amiga and the user as a 
  23.         device, but is in fact a directory. You can use this as a 
  24.         convenient shorthand to refer to lengthy pathnames, or to 
  25.         refer to a variety of different directories by the same 
  26.         name (just change the assignment when you want the 
  27.         program to change directories).
  28.           
  29.             You can remove assignments by giving only NAME:, or 
  30.         by giving a single minus ('-') as the directory or device 
  31.         name.  There are also specifice keywords to remove 
  32.         assigns which will be covered later. In any case, all 
  33.         assigns are lost when the system is shut off or rebooted.    
  34.  
  35.             In 2.x/3.x you can assign a single device name to 
  36.         many directories by simply listing all of the directories 
  37.         after the device name.
  38.  
  39.             S:, L:, C:, FONTS:, DEVS:, LIBS:, T:, and SYS: are 
  40.         all made during normal startups. All these assigns 
  41.         directly relate with system operation. Therefor, they 
  42.         should not be tampered with unless you are prepared to
  43.         crash your system! So, don't mess with system assigns
  44.         unless you know absolutly what you are doing...
  45.  
  46.             If there is already a directory with an assignment, 
  47.         any new assignment will replace it. You cannot, however, 
  48.         assign the same name to a device that already exists. So 
  49.         an assign to device Work: if a disk whose name Work: is 
  50.         already mounted. 
  51.           
  52.  
  53.  
  54.      OPTIONS
  55.           LIST 
  56.             Lists the current assignments. Under 1.3, if you 
  57.         specify a single already assigned name on the command 
  58.         line with LIST, it will be removed from the device list. 
  59.         Under 2.x/ 3.x you can either make or remove assignments 
  60.         along with listing them.
  61.  
  62.           EXISTS
  63.             Takes a logical device name as an argument.  If the 
  64.         name exists, the device name and its assignment are 
  65.         displayed.  If the name does not exist, then the 
  66.         condition flag is set to WARN (return flag 5).  This will 
  67.         cause an IF WARN batch file statement to succeed.
  68.  
  69.           REMOVE
  70.             For 1.3: Takes a logical device name as an argument, 
  71.         and removes it from the device list.  This is useful 
  72.         largely to individuals writing handlers, careless use of 
  73.         this option can easily crash the Amiga. It will not, 
  74.         however free up the memory that was taken up with the 
  75.         assign.
  76.                 
  77.             For 2.x/3.x: It can be used to delete one directory 
  78.         from a list of assigns. Opposite of ADD (see below).
  79.  
  80.           DISMOUNT
  81.             2.X/3.X ONLY: Used exactly like the REMOVE keyword 
  82.         for 1.3 to remove a device from a list of mounted 
  83.         devices.
  84.  
  85.           DEFER
  86.             2.x/3.x Only: Postpones the assign until a command 
  87.         tries to access that device. Defer will not throw out an 
  88.         error if it searches for a directory and it does not 
  89.         exist.
  90.         
  91.  
  92.           PATH
  93.             2.x/3.x Only: This expands on the DEFER keyword. 
  94.         Whereas DEFER eventually binds the assign, PATH keeps the 
  95.         assign non-binding.  Not only will it wait for a command 
  96.         to access that device, but it will reevaluate the assign 
  97.         every other time that device is requested for. (NB: This 
  98.         is very convenient if you are a floppy only user. You 
  99.         will not have to replace the Workbench each time FONTS: 
  100.         is requested. Instead, you can insert different floppy 
  101.         named fonts: each time that device is scanned for.)
  102.  
  103.             PATH will not accept multi directory assigns.
  104.  
  105.           ADD
  106.             2.x/3.x Only: Let's you add new directories to an 
  107.         existing assign.  For instance, if you assign a device 
  108.         that is alread assigned you will lose your old assign. If 
  109.         you use the ADD keyword, you will add the new assign to 
  110.         the old assign.
  111.  
  112.           VOLS
  113.           DIRS
  114.           DEVICES
  115.             2.x/3.x Only: Limits the information that is 
  116.         displayed when you list your assigns. VOLS shows you only 
  117.         which volumes are assigned, DIRS shows you only which 
  118.         directories are assigned. DEVICES shows you only which 
  119.         devices are assigned. If none of these keywords are used 
  120.         then all three kind of information are displayed.
  121.           
  122.      CAUTIONS
  123.             Random or careless assignments of the Amiga's 
  124.         pre-assigned devices can cause mass confusion.
  125.  
  126.             Random or careless use of the REMOVE option can cause 
  127.         a GURU (and crash your sytem).
  128.  
  129.      SEE ALSO
  130.           Execute
  131.  
  132.      EXAMPLES
  133.   
  134.         1.
  135.              ASSIGN DICTIONARY: df1:usr/lib/dictionary
  136.  
  137.             DICTIONARY: may now be used as a synonym for the 
  138.         complete path df1:usr/lib/dictionary. If a program uses 
  139.         the logical device DICTIONARY: rather than a hardcoded 
  140.         directory name, then changing the DICTIONARY: assignment 
  141.         will change the dictionary that the program will use.
  142.  
  143.             Assign allows a practically infinite number of 
  144.         assignments or deletions to be made on one command line.  
  145.         You may remove an assignment by using a minus '-' sign 
  146.         instead of a logical directory or filename to subtract 
  147.         this assignment from the device list.
  148.  
  149.         2. To return all the assignments made to your system 
  150.         just enter:
  151.  
  152.             Assign
  153.           
  154.         3. 1.3 Only:
  155.  
  156.             To assign POOF: to the disk in DF0:, remove the 
  157.         assignments for PUF: and DUF: and assigns CRUFT: to HD0:.
  158.  
  159.             ASSIGN POOF: DF0: PUF: - DUF: - CRUFT: HD0:
  160.  
  161.  
  162.         4.2.x/3.x Only:
  163.  
  164.           To assign multiple paths to one device:
  165.  
  166.             Assign Music: Work:DeliTracker/Mods Work:OctaMed/Meds 
  167.  
  168.  
  169.           To assign Fonts: to df0:Fonts only when a program tries to
  170.           access Fonts:
  171.  
  172.             Assign Fonts: Df0:Fonts DEFER
  173.  
  174.  
  175.  
  176.