fitr is a small program which emulates the functionality of
Installer's "startup" command, but works on any text file, and
can use something other than a semicolon to mark the start and
end of fitr-added data for an application.

It is fully compatible with Installer's user-startup modifications,
so any application commands added to user-startup can be modified
with fitr and vice-versa.

btw, "fitr" stands for "For Installer Text Replacement", it has
nothing to do with ending fasting, although a point could be made
involving Installer's textfile and startup commands and starvation.
(I have made a mental note to check Google before naming software
next time)

DISTRIBUTION
============

fitr can be freely distributed with installation scripts, provided
the following or similar text is included in the accompanying
documentation:

"The install script uses fitr by Chris Young,
see http://www.unsatisfactorysoftware.co.uk/fitr"

USAGE
=====

Command-line usage
==================

Template:
FILE/A,APPNAME,NEWTEXT,BUFSIZE/K/N,COM=COMMENT/K,CHECK/S,PRINT/S,
LIST/S,TOP/S

FILE    = File to modify[1]
APPNAME = Application name - case sensitive (pick something unique!)
NEWTEXT = File containing text to add (if not specified, section will
          be deleted from the file) [3]
BUFSIZE = Text buffer size, default 1K. [2]
COMMENT = Text to place in front of the BEGIN/END markers, default ";"
CHECK   = If specified, fitr will check for a section for that app and
          set RC 5 (WARN) if it is found, 0 otherwise.
PRINT   = Displays the text section in FILE for APPNAME
LIST    = Prints a list of applications that have sections in FILE
TOP     = If the section does not exist, add it to the top of the file
          (default is to add new sections to the end)

LIST cannot be specified with any other switches.  If APPNAME is not
provided, fitr will default to LIST mode.

Examples

1> fitr s:user-startup
will print a list of the applications that have added sections to
user-startup.

1> fitr s:user-startup MUI PRINT
will print the text section for MUI from s:user-startup

1> fitr s:user-startup MyApp
will DELETE the section for MyApp.  Be careful with this!

1> fitr s:startup-sequence NewSetPatch startup.txt TOP
will replace NewSetPatch section in s:startup-sequence with
the contents of startup.txt.  If it doesn't exist, startup.txt
will be added to the TOP of the file.

1> fitr ram:logfiles usblog t:usb.log COM="#"
will add the contents of t:usb.log to ram:logfiles, between the
markers #BEGIN usblog and #END usblog (ram:logfiles will be
created if it doesn't exist)

Suggested Installer usage
=========================

Use the p_fitr procedure in the fitr-test script, called as follows:
(p_fitr "filename" "text to add" "comment marker" "additional switches")

See fitr-test for more examples, including how to use the CHECK
option from Installer scripts.

VERY IMPORTANT!
===============
[1] The file being modified MUST BE TEXT, BINARY FILES WILL
    PROBABLY BE IRREPAIRABLY DAMAGED
[2] FITR MAY TRUNCATE LINES LONGER THAN BUFSIZE
[3] If a section has no END comment, replacing that section
    WILL REPLACE THE REST OF THE FILE

HISTORY
=======
1.3 18.08.2009
* Added TOP

1.2 06.05.2009
* Added CHECK, PRINT, LIST and ability to delete sections
* Fixed some problems with the Installer procedure (most notably
  with spaces in filenames etc)

----
Please note the primary download location for my software is Aminet
(http://www.aminet.net).  If you obtained this archive from anywhere
else, please check Aminet and/or Unsatisfactory Software
(http://www.unsatisfactorysoftware.co.uk) for newer versions.

As usual, I cannot and will not accept responsibility for any damage,
loss of data etc incurred through use of this software.  This archive
is provided "as-is" without warranty of any kind and all use is at
your own risk.

Please check the PGP signature in the Aminet readme against the
archive to ensure it has not been tampered with.