home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / c / modname.doc < prev    next >
Text File  |  1995-02-27  |  4KB  |  135 lines
  1.                              ModName V1.0
  2.                              ------------
  3.                                              written by BLOODROCK/SDC
  4.  
  5.  
  6. What is it ?
  7. ------------
  8.  
  9. Have you ever downloaded a ProTracker module, named on an MS-DOS PC, like
  10. e.g. "THISIS.MOD", and the real module name is "Mod.This is real tekkno" ??
  11.  
  12. -Well, checking and correcting hundreds of sound modules for the right name
  13. costs lotsa time and sometimes your HD contains identical modules with
  14. several different names.
  15.  
  16. ModName renames such files to it's original name.
  17.  
  18.  
  19. System Requirements:
  20. --------------------
  21.  
  22. ModName needs V37+ (OS 2.04 or higher), of course. ModName was written
  23. for AmigaDOS script/CLI usage only.
  24.  
  25.  
  26. Usage:
  27. ------
  28.  
  29. Format:
  30.  
  31. ModName [C|CAPITALIZE] [F|FORCE] [N|NOSPACES] [S|SILENT] {<name>}
  32.  
  33. Template:
  34.  
  35. ModName C=CAPITALIZE/S,F=FORCE/S,N=NOSPACES/S,S=SILENT/S,NAME/A
  36.  
  37.  
  38. The CAPITALIZE option capitalizes all words of the module name.
  39.  
  40. The FORCE option suppresses a module check. Normally, ModName checks a file
  41. for the "M.K." ID. If this ID is missing, the file won't be renamed.
  42. This option is for renaming old Soundtracker modules, too.
  43. Note: ModName always attempts to load the first 1084 bytes of a file.
  44. If the file is smaller, nothing will happen; only an error message is
  45. displayed.
  46.  
  47. Using the NOSPACES option has the effect that all spaces in the module name
  48. will be converted to underscore chars ("_") in the filename (you should
  49. use this).
  50.  
  51. The SILENT option is a QUIET-like option. There wont' be any text outputs,
  52. but error messages are still typed out. So, you may create an error script
  53. when processing hundreds of modules from a script via AmigaDOS redirection.
  54.  
  55. Example:
  56.  
  57. ModName >>Ram:Logfile SILENT Mod.Module1
  58.  
  59. ... and so on....
  60.  
  61. After running the script, you may return back from watching TV and check
  62. the logfile for any contents. Each present line will contain an error
  63. message and you don't need to search thru' a large file.
  64.  
  65.  
  66. ModName suppresses chars which are bad for file names, like "#", "?", ":",
  67. "*" etc. Also, unprintable characters, like ASCII 0-31 will be skipped.
  68.  
  69. Brackets ("(", ")"), square brackets ("[", "]") and angle brackets ("<", ">")
  70. are converted to braces ("{", "}"), dollar signs ("$") will be converted to
  71. "s".
  72.  
  73. Any Zero value between valid characters will be converted to space/underscore.
  74. Double Spaces/underscores/zeros (in any order) are skipped.
  75.  
  76. Spaces before or behind the name itself are skipped, too.
  77.  
  78. ModName always adds the prefix "Mod." at the beginning and cuts off the
  79. suffix ".Mod" at the end of the filename.
  80.  
  81.  
  82. Examples:
  83. ---------
  84.  
  85. You got a file named "MYGREATT.MOD".
  86. The real name is: "** my great tune !! **"
  87.  
  88.  
  89. ModName MYGREATT.MOD
  90.  
  91. renames the file to:
  92.  
  93. Mod.my great tune !!
  94.  
  95.  
  96. ModName NOSPACES MYGREATT.MOD
  97.  
  98. results in a file named
  99.  
  100. Mod.my_great_tune_!!
  101.  
  102.  
  103. ModName C N MYGREATT.MOD
  104.  
  105. renames the module to:
  106.  
  107. Mod.My_Great_Tune_!!
  108.  
  109.  
  110. Got it ?
  111.  
  112.  
  113. The following ASCII codes are skipped while creating a filename:
  114.  
  115.   - All codes at a range from 0 to 31
  116.  
  117.   - The following characters:  " # % * / : ; ? ` |
  118.  
  119.   - All codes from ASCII 126 to 191 and the codes 215 and 247
  120.  
  121.  
  122. That's all. Thanks must go to Sniper for the nice idea !
  123.  
  124.  
  125. Copyright:
  126. ----------
  127.  
  128. ModName is PUBLIC DOMAIN. Everybody may use, copy and spread this tool for
  129. free, as long as no profit was made by selling it and this documentation
  130. and the program itself are included and both unchanged.
  131.  
  132.  
  133. Signing off......
  134.                                                             BLOODROCK/SDC
  135.