home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / FileMover / Dopus4 / ArexxScripts / hotwrite.lha / doc / AquaAdder.doc next >
Encoding:
Text File  |  1994-11-19  |  5.0 KB  |  143 lines
  1.  
  2.        _ _ ___/\______/\__ ____/\___/\__ _ _/\____ _/\_ __ __/\______
  3.       __ ________   __   /   _   ___   / ______   \___/__/     _____/
  4.          bIS/   /   /   /   //   //   /___/ __¬   /  /  /  /\__   \
  5.            /   /   /   /   //   //   /   /  \    /  /  /  /   /   /
  6.     __  _ _\____  /\____  //_  //_____  /___/\  /\_____  /\ _/   /___
  7.      _  ___ _   \/  _  _\/_  \/____ __\/ ___ _\/_______\/____   /_ _/
  8.                                                             \  /
  9.                                   present                    \/
  10.  
  11.                  >>> AquaAdder v1.0 by Aquarius/Outlaws <<<
  12.  
  13.  
  14.                           Copyright ©1994 Aquarius
  15.  
  16.                  Permission is granted to freely distribute
  17.                this product for non-commercial purposes only,
  18.                   as long as all files remain unmodified.
  19.  
  20.  
  21.  
  22. Archive (OTL-AA10.LHA) Contents
  23. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24. AquaAdder.doc                5085 bytes   This document file.
  25. AquaAdder.iff                2052 bytes   IFF picture of the output.
  26. BBS/FCheck/DOC.info           542 bytes   Icon for /X 3.x+.
  27. BBS/FCheck/DOK.info           542 bytes   Icon for /X 3.x+.
  28. BBS/FCheck/NFO.info           542 bytes   Icon for /X 3.x+.
  29. BBS/FCheck/TXT.info           542 bytes   Icon for /X 3.x+.
  30. C/AquaAdder                  3380 bytes   The executable.
  31. S/AquaAdder.Head              815 bytes   Sample header text.
  32. S/AquaAdder.Tail             1371 bytes   Sample tailer text.
  33.  
  34.  
  35. Introduction
  36. ~~~~~~~~~~~~
  37. AquaAdder is a text adder! It takes a text file and adds a header
  38. (S:AquaAdder.Head) and a tailer (S:AquaAdder.Tail) to it. It can be used both
  39. from shell and in BBS systems like AmiExpress.
  40.  
  41.  
  42. Features
  43. ~~~~~~~~
  44. It can insert time and date anywhere you like in the header and the tailer.
  45. There are two time formats available (HH:MM and HH:MM:SS), and two date
  46. formats (DD-MMM-YY and MM-DD-YY).
  47.  
  48. It is very FAST - as fast as a text adder can be!! Maybe even faster...
  49.  
  50. AquaAdder is completely system friendly and safe. No memory losses, Enforcer
  51. hits or any other crash risks.
  52.  
  53. If header + tailer + text file don't fit in memory, the tool enters
  54. "low-memory mode"; it tries to load only the tailer, to append it. The header
  55. won't be inserted then.
  56.  
  57. It is "pure" and can therefore be made resident.
  58.  
  59. The output is extremely cool! :) (Look at the IFF picture..)
  60.  
  61.  
  62. Requirements
  63. ~~~~~~~~~~~~
  64. AquaAdder requires an Amiga with OS 2.04 or higher.
  65.  
  66.  
  67. Usage
  68. ~~~~~
  69. The command syntax is:
  70.  
  71. AquaAdder <TextFile>
  72.  
  73.  
  74. Example:
  75.  
  76. AquaAdder dh3:tmp/god-bnbr.doc
  77.  
  78.  
  79. If you are going to use this tool with AmiExpress 3.x or higher, copy the
  80. provided icon 'TXT.info' to BBS:FCheck/ and duplicate it for every other text
  81. file extension: NFO.info, DOC.info, DOK.info etc.
  82.  
  83. There is just ONE error message that AmiExpress should recognize as an error
  84. that should move the file to HOLD, and that string is "ERROR: Failed to
  85. write" or just "Failed to write". The other possible error messages, for
  86. example "ERROR: Failed to open S:AquaAdder.Head!", should NOT cause the
  87. uploaded file to be put in HOLD.
  88.  
  89.  
  90. The Header and Tailer
  91. ~~~~~~~~~~~~~~~~~~~~~
  92. S:AquaAdder.Head is the file that will be put in front of the text file.
  93. S:AquaAdder.Tail will be put at the end. The header and the tailer may
  94. contain codes that will be replaced by the current time and date
  95. respectively. The possible codes are:
  96.  
  97. Code        Format      Example
  98. ---------   ---------   -------
  99. $TIME       HH:MM       14:52
  100. $TIMESEC    HH:MM:SS    14:52:45
  101. $DATE_DOS   DD-MMM-YY   29-Sep-94
  102. $DATE_US    MM-DD-YY    09-29-94
  103.  
  104. For example, if S:AquaAdder.Tail contains the string '$DATE_DOS', then that
  105. string will be replaced by the current date formatted as 'DD-MMM-YY', for
  106. instance '29-Sep-94'.
  107.  
  108.  
  109. Contact Me!
  110. ~~~~~~~~~~~
  111. If you have any cool ideas for improvement of this tool, questions, bug
  112. reports or whatever, leave me a message on one of the following boards:
  113.  
  114. NIGHTFALL ................ Whoosh ............ +46-90-120369  <---  Safest
  115. HALL OF FAME ............. Dansken ........... +46-910-26665      place to
  116. HYSTERIA ................. JAC ............... +46-21-842939     reach me!
  117. MASTURBATION STATION ..... Black Beard ....... +1-305-552-1192
  118. ZION'S HIDEOUT ........... Zion .............. +1-614-876-0807
  119. DARK TOWER ............... Shadower .......... +1-801-476-9068
  120. MORTUARY ................. Bloodwolf ......... +1-312-284-7577
  121. BOONDOCKS ................ Sal-One! .......... +31-548-040-653
  122.  
  123.  
  124. History
  125. ~~~~~~~
  126. 1.0  (11-19-94) First release version.
  127.  
  128.  
  129. Greetings
  130. ~~~~~~~~~
  131.                 Greetings must go to (in no special order):
  132.  
  133.            - Vegas/OTL - Biscrok/OTL - Toxic/OTL - AtomiX!/OTL -
  134.        - Whoosh/OTT^DVS^OTL^CLS - Snake/OTL - Nashua/OTL - SMS/OTL -
  135.    - Genghis Khan/OTL - Json/OTL - Jawlog/OTL - The Other OTL Members! -
  136.   - Dansken - CornFlake - Ace Caze - Firehawk! - fanta/THR - Static/THR -
  137. - JAz - FAX - Juan - Psychopath - Danzig - Sal-One - Metalbasher - BoneIdle -
  138.   - Wilsom/Obscene - Rize & Frosty - Norad - Doc Whoo - Zion! - MDR/OTT -
  139.      - WarDancer - Princip - Ezco - Vampire/PDY - The Ones I Forgot! -
  140.  
  141.  
  142. [EOF]
  143.