home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga 13 / MA_Cover_13.bin / source / c / stefanb_src / dospath / dospath.txt
Encoding:
Text File  |  1996-10-02  |  5.0 KB  |  156 lines
  1. Documentation for DOSPath V1.0                                25-Aug-1996
  2.  
  3.  
  4.    Permission is granted to make and distribute verbatim copies  of  this
  5. manual provided the copyright  notice  and  this  permission  notice  are
  6. preserved on all copies.
  7.  
  8. COPYRIGHT
  9.  
  10.    Copyright (C) 1996 Stefan Becker
  11.  
  12.    No program, document, data file or  source  code  from  this  software
  13. package, neither in whole nor in part, may be included or used  in  other
  14. software packages unless it is authorized by a  written  permission  from
  15. the author.
  16.  
  17.  
  18. NO WARRANTY
  19.  
  20.    There is no warranty for this software package.  Although  the  author
  21. has tried to prevent errors he can't guarantee that the software  package
  22. described in this document is 100% reliable. You are therefore using this
  23. material at your own risk. The author cannot be made responsible for  any
  24. damage which is caused by using this software package.
  25.  
  26.  
  27. DISTRIBUTION
  28.  
  29.    This software package is freely distributable. It may be transfered to
  30. any media which is used for the distribution of free software like Public
  31. Domain disk collections, CDROMs, FTP servers or bulletin board systems.
  32.  
  33.    In order to ensure the integrity of this software package distributors
  34. should use the original archive file DOSPath1_0.lha (file name on Aminet:
  35. DOSPath.lha). The author cannot be  made  responsible  if  this  software
  36. package has become unusable due to modifications of the archive  contents
  37. or of the archive file itself.
  38.  
  39.    There is no limit on the fee taken by distributors, e.g. for the media
  40. costs of floppy disks, streamer tapes or compact discs, or the process of
  41. duplicating. Such limits have proven to be harmful to the idea of  freely
  42. distributable software, e.g. the software package was removed instead  of
  43. reducing the price of a floppy disk below the limit.
  44.  
  45.    Although the author does not impose any limit on these fees  he  would
  46. like to express his personal opinions on this matter:
  47.  
  48.    * This software package should be made available to everyone  free  of
  49.      charge whenever this is possible.
  50.  
  51.    * If you have purchased this software package under normal  conditions
  52.      from a Public Domain dealer on a floppy disk and have paid more than
  53.      5DM or US $5 then you have definitely paid too  much.  Please  don't
  54.      support this improper profit making  any  longer  and  switch  to  a
  55.      cheaper source as soon as possible.
  56.  
  57.  
  58. USAGE RESTRICTIONS
  59.  
  60.    No program, document, data file or  source  code  from  this  software
  61. package, neither in whole nor in part, may be used on any  machine  which
  62. is used
  63.  
  64.    * for the research, development, construction, testing  or  production
  65.      of weapons or other military applications. This  also  includes  any
  66.      machine which is  used  in  the  education  for  any  of  the  above
  67.      mentioned purposes.
  68.  
  69.    * by people who accept, support or use violence against other  people,
  70.      e.g. citizens from foreign countries.
  71.  
  72.  
  73.  
  74. I. What is the purpose of this software package?
  75. ================================================
  76.  
  77. Each CLI process created by AmigaDOS has a so called "command path  list"
  78. a list of directories which is used to  find  the  commands  the  process
  79. wants to run. It can be controlled from  scripts  with  the  CLI  command
  80. "path".
  81.  
  82. Programs can also supply a path list to a CreateNewProc() call  which  is
  83. used to create new CLI processes. Unfortunately the data  structures  for
  84. AmigaDOS path lists don't appear anywhere in the official  documentation.
  85. Also no support routines for handling path lists  are  available  in  the
  86. dos.library.
  87.  
  88. If you need to handle path lists in your program then the dospath.library
  89. can help you. It offers support routines for:
  90.  
  91.   - Copying an existing path list
  92.   - Building a path list from a list of directory names
  93.   - Copying the path list of the Workbench process
  94.   - Freeing a path list
  95.   - Remove a directory from a path list
  96.   - Set and get the path list of a process
  97.   - Find a file using a path list
  98.  
  99. Please read the Autodoc and the example source code on  how  to  use  the
  100. library.
  101.  
  102.  
  103.  
  104. II. Installation
  105. ================
  106.  
  107. Just copy the file libs/dospath.library into your LIBS: directory.
  108.  
  109.  
  110.  
  111. III. Contents of this software package
  112. ======================================
  113.  
  114. dev/         Autodoc, FD and C header files for dospath.library. It  also
  115.              contains the C source code for the DOSPath examples and  the
  116.              DICE link libraries.
  117.  
  118. libs/        dospath.library. Copy this file to LIBS:
  119.  
  120. src/         Source code for the dospath.library. It has been written for
  121.              DICE 3.0 and is included for educational purposes only.  Use
  122.              the command "DMake" to compile it.
  123.  
  124. DOSPath.txt  This documentation.
  125.  
  126.  
  127.  
  128. IV. History
  129. ===========
  130.  
  131. ?.? (??-???-199?)
  132.  
  133.    - Added GCC support file
  134.  
  135. 1.0 (25-Aug-1996)
  136.  
  137.    - Initial release
  138.  
  139.  
  140.  
  141. V. Contact addresses
  142. ====================
  143.  
  144. Send comments, suggestions or bug reports to:
  145.  
  146.  Postal address:
  147.  
  148.                   Stefan Becker
  149.                   Bonner Ring 68
  150.           D-50374 Erftstadt
  151.                   GERMANY
  152.  
  153.  EMail:           stefanb@yello.ping.de
  154.  
  155.  World Wide Web:  http://www.ping.de/sites/yello/
  156.