home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / SPITFIRE / TICMAN11.ZIP / SFTICMAN.DOC < prev    next >
Text File  |  1994-03-20  |  11KB  |  257 lines
  1.      ╓─────┐ ╓─────┐ ╓─────┐ ╓───┐ ╓─────┐ ╓───────┐ ╓──────┐ ╓───┐  ╓─┐
  2.      ║ ┌───┘ ║ ┌───┘ ╙─╖ ┌─┘ ╙╖ ┌┘ ║ ┌─╖ │ ║ ┌╖ ┌╖ │ ║ ┌──╖ │ ║   └┐ ║ │
  3.      ║ └───┐ ║ └─┐     ║ │    ║ │  ║ │ ╙─┘ ║ │║ │║ │ ║ └──╜ │ ║ ├╖ └┐║ │
  4.      ╙───╖ │ ║ ┌─┘     ║ │    ║ │  ║ │ ╓─┐ ║ │╙─┘║ │ ║ ┌──╖ │ ║ │╙╖ └╢ │
  5.      ╓───╜ │ ║ │       ║ │   ╓╜ └┐ ║ └─╜ │ ║ │   ║ │ ║ │  ║ │ ║ │ ╙╖   │
  6.      ╙─────┘ ╙─┘       ╙─┘   ╙───┘ ╙─────┘ ╙─┘   ╙─┘ ╙─┘  ╙─┘ ╙─┘  ╙───┘
  7.                                
  8.                                Version 1.10
  9.  
  10.                      Copyright (C) 1994 By Matt Blythe
  11.                            SHAREWARE By MATTWare
  12.  
  13.                                Support At:
  14.                              
  15.                              ABSOLUT SpitFire
  16.                                (317)257-9295
  17.                        FIDO 1:231/490 ■ CNFD 169:317/0
  18.                              CircuitNET 317000
  19.  
  20.  
  21. NOTE!!: If you're like me, you don't like long, lengthy DOCS.  These DOCS
  22.         are designed to get you up and running in a hurry.  If you have any
  23.         more questions, please contact me at ABSOLUT SpitFire (I'm the
  24.         SysOp), through NetMail, through FIDO in the SpitFire Conference,
  25.         or through CircuitNET in the SPITFIRE or DOORS conference.  If you
  26.         like this program, PLEASE see the end of the DOC for registration
  27.         information.  You are entitled to use this program for 30 days
  28.         without registering it.  After that, please register it or
  29.         discontinue using it.  Thank you for using this MattWare product!
  30.  
  31.  
  32. ┌────────────────┐
  33. │ -= ABSTRACT =- │
  34. └────────────────┘
  35.  
  36. SFTICMAN is a fully configurable Smiley And Comma Adder, File Area Sorter,
  37. and File Area Capitilizer.  SFTICMAN can be run on as many file areas as
  38. you want, and can use all, two, or only one of the above features based on
  39. command line options.  SFTICMAN is very fast and can handle SFFILES.BBS's
  40. that are up to 150k in size!  Other features will be added in future releases
  41. based on user demand and support.  SFTICMAN works great with any version of
  42. SpitFire 3.0+ (including version 3.5!).  SFTICMAN DOES NOT HAVE TO BE USED
  43. to process TICK entries.  In fact, it will do many things if it NEVER sees a
  44. TICK entry in your SFFILES.BBS!
  45.  
  46. Now for some more detail on each of the features:
  47.  
  48.  - Simley and Comma Adder:  This feature will take any enteries that TICK
  49.    has made into the SFFILES.BBS, add the comma where necessary, and add
  50.    smiley faces if the description passes one line.  It will leave alone
  51.    any enteries that are already correct.  SFTICMAN will make new TICK
  52.    entries ready for use by SpitFire.  You must be using the following
  53.    options in the TIC.CFG file for the SFFILES.BBS file type for SFTICMAN
  54.    to work:
  55.                     ListFmt %3:-13%4:8 %5:9.3  %1
  56.                     ListName SFFILES.BBS
  57.    If SFTICMAN encounters a TICK entry that is longer than 256 characters,
  58.    it will crop the end off at 256 characters.  This is to prevent any
  59.    conflict with SpitFire's 256 characters-per-line requirement.
  60.  
  61.  - File Area Sorter (Registered Versions Only!):  This feature will sort
  62.    your SFFILES.BBS by name, ascending date, or descending date.  It sorts
  63.    the SFFILES.BBS after all new TICK entries have been fixed.  SFTICMAN
  64.    uses a very fast C QuickSort to sort the file areas.  See the config
  65.    file section to learn how to change the sort type.
  66.  
  67. -  Capitilizer:  This feature capitilizes the first letter of every word
  68.    in the SFFILES.BBS description.  It uses the same rules that SpitFire
  69.    does to descriptions that are entered online.  Nice for making your
  70.    file areas look neat!  This feature will work on newly fixed TICK
  71.    entries too.
  72.  
  73. ┌────────────────────┐
  74. │ -= REQUIREMENTS =- │
  75. └────────────────────┘
  76.  
  77.   -- SpitFire 3.0+
  78.   -- DOS 3.3 or better.
  79.   -- 80386 Processor or better.
  80.  
  81. ┌─────────────┐
  82. │ -= USAGE =- │
  83. └─────────────┘
  84.  
  85. Running SFTICMAN is really simple.  All SFTICMAN needs is a configuration
  86. file, which is a regular text file, and any command line options that you
  87. want to add.  A sample configuration file, SAMPLE.CFG, is included.
  88.  
  89. The format for the configuration file is as follows:
  90.  
  91. ────────────────────────────────────
  92.  
  93. Line 1: Matt Blythe       <--- Your name as entered in SpitFire.
  94. Line 2: 0000000000        <--- Your registration code (if you have one).
  95. Line 3: DATE-D            <--- Sort Type (DATE-D, DATE-A, NAME)
  96. Line 4: C:\FILES\AREA1\   <--- Path to first file area to be processed.
  97. Line 5: C:\FILES\AREA2\   <--- [Lines 5 to End of File contain
  98. .                         <---  the rest of the file areas you want
  99. .                         <---  processed on that run.]  
  100. Line N: C:\FILES\AREAN\   <--- Last file area.
  101.  
  102. ────────────────────────────────────
  103.  
  104. Line 3 is your sort type selection.  There are currently three choices:
  105.  
  106.         DATE-D: Sort by descending date. (Latest date first)
  107.         DATE-A: Sort by ascending date. (Earliest date first)
  108.         NAME: Sort by name. (Alpha Order)
  109.  
  110. If you make an invalid entry on this config line, SFTICMAN will default to
  111. Sort by Name. (Registered feature only!)
  112.  
  113.  
  114. ──────────────────────────────
  115.  
  116. Usage:
  117.  
  118. SFTICMAN [CONFIG FILE] [COMMAND LINE OPTIONS]
  119.  
  120. (SFTICMAN can be run unattended in any batch file including as a nightly
  121. event)
  122.  
  123. ──────────────────────────────
  124.  
  125. Where [CONFIG FILE] is the name of the above configuration file & 
  126. [COMMAND LINE OPTIONS] are any of the following:
  127.  
  128. /NS - No Sort: The Sorting feature is turned off. (Registered Version Only)
  129. /NT - No TICK: The TICK processing feature is turned off.
  130. /NC - No Caps: The capitilization routines are turned off.
  131. /NB - No BackUp: SFTICMAN will not create backup files.
  132.  
  133. Examples of possible usages:
  134.  
  135. ──────────────────────────────
  136.  
  137. SFTICMAN SFTICMAN.CFG /NS
  138.         This would run SFTICMAN with no sorting.
  139.  
  140. SFTICMAN SFTICMAN.CFG /NT /NC
  141.         This would run SFTICMAN with no tick processing and no capitilization
  142.         routines.  It would only sort.  (Great as a nightly event just to
  143.         sort your file areas.  Works with SpitFire Version 3.5!)
  144.         (REGISTERED VERSION ONLY!)
  145.  
  146. SFTICMAN SFTICMAN.CFG /NS /NT /NB
  147.         This would run SFTICMAN with no sorting, no tick processing, and no
  148.         backup files created.  It would only capitilize.
  149.  
  150. ──────────────────────────────
  151.  
  152. That is all there is to it.
  153.  
  154. ┌──────────────────────────────────┐
  155. │ -= NOTES ON HOW SFTICMAN RUNS =- │
  156. └──────────────────────────────────┘
  157.  
  158. SFTICMAN relies on the paths you enter in the CONFIG file.  If the paths
  159. are not valid, SFTICMAN will not process that files area.  SFTICMAN makes
  160. backup files of your orignal SFFILES.BBS called SFFILES.SFT in each
  161. area that it works on.  If you do not want SFFILES.SFT to be created, use
  162. the /NB option.  An included file called BKTICDEL.EXE will erase all of the
  163. SFFILES.SFT created.  The usage for BKTICDEL.EXE is:
  164.  
  165. BKTICDEL [CONFIG FILE]
  166.  
  167. Where [CONFIG FILE] is the name of the config file you use to run SFTICMAN.
  168.  
  169. SFTICMAN creates temporary files so if it is interupted for some reason,
  170. the original SFFILES.BBS will still be intact.
  171.  
  172. ┌────────────────────────────────────┐
  173. │ -= NOTES FOR MULTI-NODE SYSTEMS =- │
  174. └────────────────────────────────────┘
  175.  
  176. SysOps that run multiple nodes and want to take full advantage of file
  177. sharing need to have DOS's SHARE loaded.  If you are running a multi-node
  178. system and another program tries to access to the SFFILES.BBS while SFTICMAN
  179. is running, a file sharing error will occur if SHARE is not loaded.  DOS's
  180. SHARE is the only sharing program that SFTICMAN has been tested on.  Other
  181. sharing programs may work, but no others have been tested.
  182.  
  183.  
  184. ┌─────────────────────────┐
  185. │ -= REGISTRATION INFO =- │
  186. └─────────────────────────┘
  187.  
  188. SFTICMAN is not FREE!!  It is SHAREWARE requiring registering if you use it
  189. longer than 30 days.  SFTICMAN is ONLY * $1.00 *  This registration gets
  190. rid of the annoying message at the beginning and allows the file sorting
  191. feature to be used!  To register send * $1.00 * and the form to:
  192.  
  193.                         SFTICMAN Registrations
  194.                         c/o Matt Blythe
  195.                         8045 Broadway
  196.                         Indianapolis, IN 46240-2502
  197.  
  198. For $1.00 I will place the registration code in a message to you on my BBS
  199. (The registration form has the information necessary for me to create an
  200. account for you) or I will place it in a Netmail message for you and set
  201. it on hold in my mailer.
  202.  
  203. If you would like me to Netmail it or Mail it (US Postal Service) to you,
  204. please send * $1.25 * (the extra .25 to cover the stamp or the phone call).
  205. I will send it to you AS SOON AS I receive you CASH, CHECK, or MONEY ORDER.
  206. Don't Forget to include your Netmail address!
  207.  
  208. The SHAREWARE version of program is NOT crippled in anyway (except
  209. that it will not sort the SFFILES.BBS).
  210.  
  211. Thank You for your support of the SHAREWARE idea!!
  212.  
  213. ┌─────────────┐
  214. │ DISCLAIMERS │
  215. └─────────────┘
  216.  
  217.  = Warranty =
  218. This product is provided "As Is" without warranty of any kind.  The entire
  219. risk as to the results and performance of the program is assumed by you.
  220. Furthermore, we the authors do not warrant, guarantee, or make any 
  221. representations regarding the use of, or the results of the use of this
  222. program.  You rely on the program and results solely at your own risk.
  223. We the authors cannot accept responsibility for system damage, either
  224. directly or indirectly, from the use of this product.
  225.  
  226.  = Disclaimer =
  227. The Authors of this program, ABSOLUT SpitFire, and its SysOps
  228. are in no way responsible for any damages sustained either directly
  229. or indirectly from the use of SFTICMAN.  Also, if the file has been
  230. modified in any way we will take no responsibility for it's use WHATSOEVER!
  231. The .EXE file has been tested on several machines, from 386's to 486's and
  232. has worked perfectly on all. If you should have any problems with this file
  233. please call ABSOLUT SpitFire ((317)257-9295) to download a new copy.
  234.  
  235. ┌───────────────────┐
  236. │ -= FINAL NOTES =- │
  237. └───────────────────┘
  238.  
  239. - SFTICMAN will be changed and upgraded as needed.  If you have any
  240.   suggestions or problems, please contact me through one of the above (start
  241.   of DOC) methods to let me know.
  242.  
  243. - SPECIAL THANKS:
  244.         
  245.     - To Mike Woltz for writing SpitFire.  Without him, I probably
  246.       would not be BBSing at all!
  247.  
  248.     - To David Pontius for providing the SFFILES.BBS loading code and for
  249.       helping in anyway he could.  (Note if you are looking for a file area
  250.       manager, pick up a copy of SF-FAM!  It is great!)
  251.  
  252. - Thank you and enjoy the program!!
  253.  
  254.  
  255. Matt Blythe
  256. Author Of SFTICMAN
  257.