This is the README file for PB-GNU BULETMAN, version 1.15. The complete
manual is in the BULETMAN.MAN file. View with tabstops at 4 characters.

NOTE!
	The command-line option have changed! (since version 1.14)
	The INI file format has changed! (since version 1.14)
	If you are using BULETMAN version 1.14 or earlier, be sure
	to update the configuration files and the command-lines for
	the new version: 1.15 or greater.
NOTE!

See the file PBGNU for interesting info!

Unpack the archive somewhere. You need two files for the basic
operation: BULETMAN.PEX and BULETMAN.INI. The only requirement
is that those reside in the same directory.  If you need to
change the name of the PEX file, be sure to do the same with the
INI. BuletMan expects to find its configuration file in its own
directory, under the its name, with extension INI. Thus, if you
decide to change the PEX to BULLETIN.PEX, the INI should be named
BULLETIN.INI and should be in the same directory.

The INI file is very well documented. Its settings will not be
discussed here.

After you edit that INI file, you're ready to set up your
bulletins. If you are going to use the Menu mode (i.e.: you
have 'AutoRead = False' in the INI or you will use the -m
switch), then you need to create a ASCII/ANSI menu. It is a
simple screen which should reside in your TXTFILES directory
as defined in your ProCFG. This menu should list the names of
the available bulletins with optional information. Note that
in the menu and in the bulletins, ProBoard's A?? file control
code are supported! This menu will be displayed if AutoRead
is not set.

Next, you need to create your own bulletins. You need to place
them in your TXTFILES directory too. They should have extensions
ASC/ANS for ASCII and ANSI versions. The names of the files are
formed like that: BLT-x.A??, where 'BLT-' is the same for all
bulletins and 'x' is the number of the bulletin. Do not put
leading zeroes in those numbers! Thus, you can have:

                           BLT-1.ASC
                           BLT-1.ANS
                           BLT-20.ASC
                           BLT-20.ANS...

You don't need to have the numbers in sequential order. You
might be missing bulletins too, doesn't matter. The maximum
number of bulletins is 999. This should be more than enough.

Note that since BuletMan v1.12 you can change the root name
of the bulletins from BLT- to whatever you like as long as it
is not more than 5 characters in length. See the INI file
entry 'RootName' for more information.

Also, since BuletMan v1.13, you can specify a subdirectory
there too! See 'RootName' for more information.

Next, go to your Menu Editor in ProCFG and create an entry for
the BuletMan: Function 60 (Run ProBoard SDK) with the name of
the PEX for its data (BULETMAN, if you placed it in your PEX
directory). You don't need to specify the extension.

If you have any problems, make sure you have the following set
correctly:

BULETMAN.PEX and BULETMAN.INI (or the names you chose)
   - should be in the same directory (PEX directory)
     if you're not specifying the -f parameter on the
     command line.

The menu defined in BULETMAN.INI and
all the bulletins
   - should be in the TXTFILES directory or in a
     subdirectory below it.

The bulletin file names
   - should have the form BLT-x.A??, where 'x' is a number
     with _no_ leading zeroes and 'A??' is either ASC or
     ANS. You should have both files if you want correct
     operation.
   - should follow te above rule, except substitute your
      defined root name for BLT-.

Updated/new bulletins:
   - BuletMan uses the file date and time to determine
     if a bulletin has been updated since user's last
     call. You can 'touch' bulletins to force them to
     'Updated' status.

If your prompts seem messed up, try the defaults and read
BULETMAN.INI notes carefully.

For advanced uses, see the command-line section in the manual and read
the configuration file comments.
