Short:        Intelligent AmigaGuide splitter
Author:       jason@fsel.com (Jason R. Hulance)
Uploader:     jason fsel com (Jason R  Hulance)
Type:         text/hyper
Architecture: m68k-amigaos

AGSplit
=======
AGSPlit is an intelligent AmigaGuide file splitter.  By "intelligent"
I mean that each of the resulting pieces is a complete, stand-alone
AmigaGuide file.  Needless to say, the pieces are all interlinked and
behave as if they were in one big AmigaGuide file.

Why would you want to split an AmigaGuide file?  Well, the smaller the
file is the faster it loads into AmigaGuide/Multiview.  The trade-off
is that it is marginally slower to go between links that are not in
the same AmigaGuide file (but this is hardly noticeable if the pieces
are small!).

In particular, I wrote this program to split up my "Beginner's Guide
to Amiga E" which I write in TeXinfo format and so produce using the
excellent MakeGuide utility (and the version of MakeGuide I use can
only make one large file).

Usage
-----
The template is:

  GUIDEFILE/A,SPLITFILE/A,DESTDIR

"GUIDEFILE" is the file to split.
"SPLITFILE" is a short file to show the split positions (see below).
"DESTDIR" is an optional directory name to store the pieces (default
          is the current directory).

Split Files
-----------
A split file consists of node/filename pairs which describe the
positions where the AmigaGuide file is to be split.  The nodes must be
specified in the order in which they appear in the AmigaGuide file.
For example:

Main
Contents.guide
FirstNode
Chapter1.guide
AnotherNode
Appendix.guide

This split file specifies that *all* nodes from "Main" up to
"FirstNode" (but not including "FirstNode") will be split into the
file "Contents.guide".

All nodes from "FirstNode" up to "AnotherNode" (but not including
"AnotherNode") will be split into "Chapter1.guide".

All nodes from "AnotherNode" to the end of the original AmigaGuide
file will be split into "Appendix.guide".

If this split file were called "mysplitfile" and the AmigaGuide file
to be split were called "myagfile.guide", then:

   AGSplit myagfile.guide mysplitfile ram:

would split "myagfile.guide" into the specified pieces
("Contents.guide", "Chapter1.guide" and "Appendix.guide") and put the
pieces into the "ram:" directory.

Examples
--------
Two supplied example split files can be used to split my "Beginner's
Guide to Amiga E" and the "E Reference Guide" (both available in the
current Amiga E distribution in dev/e).

To Do
-----
I might make a better interface than "split files", but they are
simple enough to use...

It's a bit slow at the moment (I'm using a quite general engine), but
it's not something you'd do very often...