WrapGuide 1.1
Copyright © 1994,1995 Udo Schuermann
All rights reserved

This program is distributed with source code for your benefit.  I retain a
copyright on it but make it freely distributable.  I ask that any use of
this program as part of a project earns me a courteous mention in the docs.


PURPOSE
	Versions 34 and 39/40 of AmigaGuide® have experienced divergent
	paths of development.  The newer AmigaGuide® part of Workbench 3.0
	and 3.1 in particular supports proportional fonts, as well as word
	wrapping text, which can make for far more readable and flexible
	documentation, not to mention a more professional appearance!

	Unfortunately, compatibility with Kickstart 2.x remains an issue,
	and it is seldom feasible to maintain two separate sets of
	documentation to be shipped with a product, even though Installer
	could easily choose between two versions during installation.

	The solution is WrapGuide, which understands V39/V40 AmigaGuide®
	codes and can convert blank spaces in the usually over-long lines
	to newlines at particular intervals so as to make the text readable
	with the older AmigaGuide and a fixed-width font!

GETTING STARTED
	I have included WrapGuide-Demo.guide for you to try out the effects
	of WrapGuide.  There is really nothing to it, but you should be
	aware of the fact that WrapGuide modifies the file you give it as
	input.  This reduces the diskspace overhead (important when you are
	working with large documentation files!) and speeds things up as
	only part of the file needs to be modified.

USING WRAPGUIDE IN AN INSTALLER SCRIPT

	; DESTIN has the destination directory chosen by the user
	; Make Kickstart-dependent alterations
	(if (> (/ (getversion "dos.library" (resident)) 65536) 38)
	    ;THEN
	    ((working "Adjusting FOOBAR.guide icon for MultiView")
	     (tooltype
	        (dest (tackon DESTIN "FOOBAR.guide"))
	        (setdefaulttool "MultiView")))
	    ;ELSE
	    ((working "\nWord-wrapping FOOBAR.guide\nfor use with AmigaGuide V34")
	     (run ("WrapGuide %s 65" (tackon DESTIN "FOOBAR.guide")))))

	The essential command is:

		(run "WrapGuide FOOBAR.guide 65")

	which we've complicated a bit by introducing some variables in the
	script.  But that is merely one of those painful things we need to
	live with.

	Yes, Installer is based on the language LISP (Long Incomprehensible
	Strings of Parentheses) so that you must take great care to indent
	things properly or else things will get quite messy.  Having an
	editor that supports parentheses matching (such as GNUemacs) is a
	great help when writing LISP code or Installer scripts!

ENJOY!
	If you enjoy this program, I would like to hear from you.  Email is
	fine, a postcard would be great.  Cheers!

 ._.  Udo Schuermann
 ( )  walrus@wam.umd.edu