===========
BOTGEN.TXT
Copyright (c) 1995, 1996 Microsoft Corporation. All rights reserved.
===========

Routines to generate FrontPage WebBots inside strings.

Some of the main routines in BOTGEN.BAS and their responsibilities are:

CreateDateBot: given (output, type, format)
-------------

Puts a Date Bot into 'output' string. The 'type' is either
"EDITED" or "REGENERATED". The format is as in the Win32 function
strftime().  Page will show time of last edit or update. See Bot
documentation for more details.

CreateIncludeBot: given (output, incfile)
----------------

Puts an Include Bot into 'output' string. Causes 'incfile' to be
included into the current document; must be an HTML
file. Extracts only the text between BODY tags. See Bot
documentation for more details.

CreateMacroBot: given (output, varname)
--------------

Puts a Macro Bot into 'output' string. Page will show value of
named web variable.  See Bot documentation for more details.

CreatePlaceholderBot: given (output, authorText, userText)
--------------------

Puts a Placeholder Bot into 'output' string. Authors will see the
'authorText' in purple on the page. Browsers will see 'userText'.

CreateSearchBot: given (output, indexname, textsource)
---------------

Puts a Search Bot into 'output' string. Pass both parameters as
"" to get default values, which mean the search is over the
entire web. Browsers are able to type in words and get a list of
matching pages. See Bot documentation for more details.

CreateTimedImageBot: given (output, imgFile, elseImgFile,
-------------------         altText, elseAltText, startDate, endDate)
	
Puts a TimedImage Bot into 'output' string. Causes 'imgFile' to
appear within the interval 'startDate' to 'endDate'. Outside this
range, the 'elseImgFile' is shown if specified. For text-only
browsers, the 'altText' is shown instead of 'imgFile', and
'elseAltText' instead of 'elseImgFile'. See Bot documentation for
more details.

CreateTimedIncludeBot: given (output, incFile, elseIncFile,
---------------------         startDate, endDate)
	
Puts a TimedInclude Bot into 'output' string. Causes 'incFile' to
appear in the document within the interval 'startDate' to
'endDate'. Outside this range, the 'elseIncFile' is shown if
specified. See Bot documentation for more details.