BAGG101.ZIP includes

	README.TXT      1997-08-02      This file.
	BAGGAGE.EXE     1997-08-02      A WinHelp baggage handler, v. 1.01.
	BAGGAGE.PIF     1995-05-21      Program Information File for Windows.
	FILE_ID.DIZ     1997-08-02      Identification file.

BAGGAGE.EXE handles baggage sections in Windows help files. It can add
new baggage sections to the help files, extract baggage sections from help
files to files, or delete baggage sections. Note that adding and deleting
baggage is a delicate matter, and you should not use the BAGGAGE program
unless you know what you are doing.

Much of the information used to write this program is based on constructing
special help files and anlyzing them. This program may fail in situations
that have not been explored - or if analyses have been misinterpreted. Note
that the program is supplied without any warranties.

BAGGAGE is a DOS program. The command "baggage" used alone will list all the
help needed to use the program:

%<-------------------------------------------------------------------
BAGGAGE v. 1.01: Insert baggage into, or extract or delete from WinHelp file.
Copyright (C) 1995, 1997 Bent Lynggaard.

NOTE! This software is supplied without any warranties.

Syntax is:
    BAGGAGE <help file> [<baggage file>] [switches]
where <help file> is a WinHelp file (default extension = ".HLP") and the
optional <baggage file> is a file to insert into the help file as baggage, or
extract or delete from the help file (default extension = "."). Only the
name.ext parts are used inside the help file. If no <baggage file> is
specified, BAGGAGE lists the file's baggage sections (+ Windows 3.0 bitmaps)
to "stdout".

The optional switches are (-U/-E and -X/-V are mutually exclusive):
    -U: Upcase the baggage name (ASCII set). Default is convert to lower case.
    -E: Baggage name Exactly as entered.
    -X: EXtract baggage section to file <baggage file>.
    -V: View the baggage section (extract to "stdout").
    -D: Delete the baggage section from the help file.
    -Y: Yes (do not request insert/overwrite/delete confirmations).
The case of baggage name matters because the names internally in the help
file are case sensitive.
%<-------------------------------------------------------------------

A few hints are appropriate, though.

BAGGAGE will normally request confirmation before it inserts a baggage 
section, overwrites an existing file due to an eXtract command, or Deletes
a baggage section from a help file. The -Y switch overrides this request for
confirmation. Use the -Y switch only if you are absolutely sure that you
have entered the right command. The -Y switch is intended for use in
batch file commands or in DOS "for" loops.

The size of a help file is defined in the file's header. If the physical file
is longer than this size, BAGGAGE offers to truncate the file. BAGGAGE
cannot edit the file unless it is truncated. A 72 bytes appendix has been
observed to files compiled with RoboHelp. No problems have been observed
truncating such help files. However, truncation is irreversible, so be sure
to have a copy of your help file before you let BAGGAGE truncate it.

BAGGAGE is not a baggage editor. To edit a baggage section, you must first
extract and delete it from the help file, edit it in a proper editor, and
then reinsert it into the help file.

Most of the program's error messages are in plain launguage. However, some
are more cryptic and include an error number. If they occur, they are due
to matters I am unaware of - but prepared to analyze - and I will appreciate
to be notified if it happens.

Baggage section names are normally inserted in the help file's index[0]
(although not necessarily if there are many baggage sections, or in Windows
3.0 help files). BAGGAGE cannot add a baggage section if there is
insufficient space in the proper index block. BAGGAGE attempts to insert the
baggage in an unused part of the help file, otherwise it is appended to the
file. The command
    baggage <help file>
lists the baggage sections currently in the file, unused bytes in index[0],
and unused blocks in the help file. Index[0] tends to fill up if there are
90 - 100 bitmaps in the file, and, after splitting the index into two, again
if there are about 150 bitmaps - and then there should not be problems until
there are more than 1000 bitmaps. Most help files have no unused blocks.
However, deleting baggage from a help file will leave an unused block unless
the baggage was at the end of the file.

BAGGAGE can extract not only baggage sections from the help file, but any
section. As help files' sections have names starting with the pipe character
(|) (less the baggage sections and Windows 3.0 bitmaps), and as DOS will not
accept | as part of a file name, it is necessary to use the -V switch to
extract to stdout, and then redirect the output to a file. Furthermore, to
avoid appending a dot to the name, you must use the -E switch and enter the
name exactly as it appears in the help file, i.e. normally in uppercase.
Finally, to make DOS accept the name as a parameter rather than a pipe
command, it must be enclosed in quotes. Thus, to extract for example the
|FONT section from helpfile.hlp to file font, use
    baggage helpfile "|FONT" -ve>font
BAGGAGE will direct only the baggage section to stdout, and in a tranparent
way. The program's header, and messages, are written to stderr. Note that
the redirection character ">" will delete any current file with the same
name.

To facilitate extrcating also the help file's index, BAGGAGE will interpret
baggage name "| index." as a command to do so.

BAGGAGE is copyright (C) 1995, 1997 Bent Lynggaard. The program is freeware,
thus it can be used without any registering. It may be distributed from
Bulletin Board Services.

The program may not be included in any commercial software package or
shareware package without my permission. It may be included in public domain
and freeware software packages provided that:
     1. It is included in the original BAGG100.ZIP package together with this
	README file, and with my PKZIP authenticity verification code intact
	(KJO555).
     2. It is included in the package for a specific baggage handling purpose.
I would appreciate to be notified if BAGGAGE is included in a public domain
package.

BAGGAGE is supplied without any warranties.

Make backups of your help files before you pass them as parameters to BAGGAGE.

1997-08-02.
Bent Lynggaard <lynggaard@risoe.dk> on Internet.
