home *** CD-ROM | disk | FTP | other *** search
/ Tools en Utilities / CDASS_5.ISO / shell / comp / rcx10.arj / GETFNX10.ARJ / GETFNX.DOC < prev    next >
Encoding:
Text File  |  1993-01-29  |  6.0 KB  |  119 lines
  1. GETFNX File name - extension splitter by Jim Groeneveld, vs. 1.0, 29/1-93.
  2. --------------------------------------------------------------------------
  3.  
  4. ===DESCRIPTION===
  5.  
  6. Given an existing [drive][path]filename[.ext] the program generates a batch
  7. file with the given file specification split into the _name_ part and the
  8. eventual _extension_. Necessary for the RCX program (by me too).
  9.  
  10. ===PACKAGE===
  11.  
  12. GETFNX   BAT     8882   1-29-93   1:00a  File name - extension splitter
  13. GETFNX   B2C     9282   1-29-93   1:00a  Prepared version for BAT2EXEC compiler
  14. GETFNX   C0M     8107   1-29-93   1:00a  Compiled version of GETFNX.B2C
  15. GETFNX   EXE *   4763   1-29-93   1:00a  LZEXE compressed version of GETFNX.COM
  16. GETFNX   DOC     6169   1-29-93   1:00a  This documentation file
  17. GETFNX   HST     1572   1-29-93   1:00a  History of GETFNX
  18. $GETFNX$ AUX *     28   1-29-93   1:00a  Auxiliary file for GETFNX (see .DOC)
  19.  
  20. * = absolutely necessary
  21.  
  22. (*.COM files have been renamed to *.C0M in order to let DOS find and run
  23. the corresponding .EXE files.)
  24.  
  25. Furthermore FIND.EXE or FIND.COM of the concerning DOS version is necessary.
  26.  
  27. ===INSTALLATION===
  28.  
  29. Put GETFNX.EXE/COM/BAT in your UTIL directory, to be found via your DOS PATH.
  30. Recommended location for auxiliary file $GETFNX$.AUX: the same directory.
  31. Quickest way to use $GETFNX$.AUX: specify environment variable GETFNX from
  32. DOS prompt (or in AUTOEXEC.BAT) to point to its (full) directory path
  33. (eventually including a deviant file name).
  34.  
  35. ===Determination of location (and name) of auxiliary file $GETFNX$.AUX===
  36. The auxiliary file $GETFNX$.AUX will be searched for in the paths or as the
  37. full file specification (eventually with different, alternative filename and
  38. extension) from the data below in that order until it is found.
  39. a. the optional second parameter when calling GETFNX
  40.    1. the full _path_ only, incl. trailing '\' (e.g. 'GETFNX fn.x C:\UTIL\') or
  41.    2. the full _file_specification_ (e.g. 'GETFNX fn.x C:\UTIL\AUX-FILE.$$$')
  42. b. the environment variable %GETFNX% (specify environment variable GETFNX
  43.    either from the DOS prompt or in AUTOEXEC.BAT) (DOS 3.x and above only)
  44.    1. the full _path_ only, incl. trailing '\' (e.g. 'SET GETFNX=C:\UTIL\') or
  45.    2. the full _file_specification_ (e.g. 'SET GETFNX=C:\UTIL\AUX-FILE.$$$')
  46. c. the ROOT directory of C: (C:\) (or automatically any APPENDed path)
  47. d. the ROOT directory of the CURRENT drive (\)
  48. e. the CURRENT directory (.\)
  49. f. the PARENT directory of the current one (..\)
  50. g. the SAME directory where GETFNX.BAT is residing:
  51.    if EXPLICITELY specified when starting GETFNX (by path, DOS 3.x&up only)
  52.    (NOT if GETFNX.BAT can only be found via the PATH!) (e.g. 'C:\UTIL\GETFNX')
  53.    (compiled %0 includes the whole path to the program)
  54. h. the DOS 3.x PATH variable (this may take quite a while), new in version 1.1
  55.  
  56. So make sure to place or name $GETFNX$.AUX such that it can be found in one of 
  57. these ways. All this effort is done because the DOS ECHO command can not write 
  58. lines without CRLF, so an external auxiliary file is necessary that already 
  59. contains such a line.  
  60.  
  61. If using DOS 3.2&up and using the APPEND path utility do at least specify the
  62. '/X' parameter when calling APPEND for the first time or the auxiliary file
  63. still can not be found.
  64.  
  65. ===USAGE===
  66.  
  67. Syntax: GETFNX [d:][\][path\]filename.ext [[d:][\][path\][auxfilespec]]
  68. where d:           = drive: (of concerning file);
  69.       path         = absolute or relative path ([\]sub1\sub2.....\);
  70.       filename.ext = file specification to split into name and extension;
  71.       auxfilespec  = the eventual alt. auxiliary file name for $GETFNX$.AUX;
  72.  
  73. Output: batch file GETFNX2.BAT with contents:
  74.         echo off
  75.         %1 %2 %3 %4 %5 %6 %7 %8 filename extension
  76.                                  (extension may be 'none')
  77. to be called by application using:
  78.         call GETFNX2 ownbatch [par1..par7] fn ext
  79. User's batch file 'ownbatch.bat' may do anything with these parameters.
  80.  
  81. Help is being given by only entering: GETFNX, eventually followed by ?, /?, -?,
  82. /h or /H.
  83.  
  84. ===REMARKS===
  85.  
  86. Attention! Because of a bug in the batch compiler BAT2EXEC it may be possible
  87. that GETFNX locks up and tries to send output to the printer port(!).
  88. In that case do not use the compiled programs (.EXE, .COM), but only the batch
  89. (.BAT) files, by removing the .EXE and .COM files (see further BAT2EXEC.BUG).
  90.  
  91. WARNING:
  92. Avoid the use of path and file names having %-characters in them. These are
  93. being written literally into auxiliary files and the %-characters including
  94. their successive characters may be interpreted as batch file or environment
  95. variables. The results will be unpredictable, but certainly erroneous.
  96.  
  97. ===SYSTEM REQUIREMENTS===
  98. - IBM-PC (88/86/x86) or compatible
  99. - (MS)DOS 2.x or above
  100. With DOS 2.x the environment variable GETFNX can not be used. Besides,
  101. the DOS PATH can not be scanned for the auxiliary file. Another adaptation for
  102. DOS 2.x to include is to change .BAT file lines 'ECHO.' into 'ECHO @', in which
  103. '@' means the ascii-255 character, thus 'echo  ', or it prints "ECHO is off".
  104. Furthermore, with DOS«3.3 one might change '@echo off' into 'echo off'.
  105. The DOS 3.3&up CALL command may be changed into 'COMMAND/C' with DOS«3.3 or
  106. one might apply an external CALL command for the lower DOS versions (by me too).
  107.  
  108. - At least sufficient memory to load successive copies of COMMAND.COM (batch)
  109.   or nested copies of GETFNX (compiled) and FIND and other additional
  110.   temporary scratch batch files. It seems that using the .BAT files 64kb would
  111.   be sufficient, while using the .COM or .EXE files 128kb is needed.
  112.  
  113. Centrum voor Medische Informatica TNO       <Email>              |  |  |\/|
  114. TNO Center for Medical Informatics | GROENEVELD@CMI.TNO.NL  |  \_/  |  |  |
  115. ( CMI-TNO )    | Y. Groeneveld     | GROENEVELD@CMIHP1.UUCP | Jim Groeneveld
  116. P.O.Box 124    | Wassenaarseweg 56 | GROENEVELD@TNO.NL      | Schoolweg 14
  117. 2300 AC Leiden | 2333 AL Leiden    | ...@HDETNO51.BITNET    | 8071 BC Nunspeet
  118. Nederland.     | (+31|0)71-181810  | Fax (+31|0)71-176382   | 03412-60413
  119.