@!345678901234567890123456789012345678901234567890123456789012345678901234567890
@!******************************************************************************

@t vskip 50 mm
@t title titlefont centre "FunnelWeb Pages"
@t vskip 10 mm
@t title smalltitlefont centre "by Ross N. Williams"
@t title smalltitlefont centre "15 January 1997"
@t vskip 10 mm
@t title smalltitlefont centre "Copyright (C) Ross N. Williams 1997."
@t new_page
@t vskip 20 mm
@t title titlefont centre "Contents"
@t vskip 10 mm
@t table_of_contents
@t new_page

@!******************************************************************************
@!******************************************************************************

@A@<FunnelWeb Web@>

This document contains the FunnelWeb source for a web.
When processed by FunnelWeb, this file will
generate all the @{.html@} files in the web.

@!******************************************************************************

@B@<Copyright Notice@>

This FunnelWeb source file and all works derived from it (including, but
not limited to, the output files and printed documentation that can be
extracted using the FunnelWeb preprocessor) are copyright as shown below,
and the copyright message in the copyright macro
applies to all of these works. The enclosing macro is called at the start of
each FunnelWeb output file so that the copyright message appears in each
output file as well as in this FunnelWeb source file.

@$@<Copyright notice@>@Z@M@{@-
Copyright (C) Ross N. Williams 1992,1999. All rights reserved.@}

@$@<Copyright notice/HTML@>@Z@M@{@-
Copyright @<(C)@> Ross N. Williams 1992,1999. All rights reserved.@}

Permission is granted to make and distribute verbatim copies of this
FunnelWeb manual provided that all notices (including, without
limitation, the copyright notice, this permission notice, any record
of modification, and all legal notices) are preserved on all copies.
Modified versions of this manual, including translations to other
languages, may be distributed under the same terms, provided that each
modification made to the manual since its original release by Ross N.
Williams (www.ross.net) is identified on the page on which it occurs,
and the front page of the manual carries a notice notifying the reader
that changes have been made, and referring the reader to the official
FunnelWeb website at www.ross.net/funnelweb/.

To the extent permitted by law there is ABSOLUTELY NO WARRANTY.

@!******************************************************************************

@p maximum_input_line_length = 500
@p maximum_output_line_length = 500

@!******************************************************************************

@B@<Change Log@>

@$@<Change log@>@Z@{
15-Jan-1997: Created this web.
21-Jan-1997: This FunnelWeb web was first placed online.
29-Sep-1997: Adrian Corston changed the FunnelWeb mailing list to
             ...@@ross.net. The old addresses will work too.
29-Sep-1997: Updated Tony Coates URLs.
29-Sep-1997: Added code to suppress hyperlink underlining.
06-Mar-1998: I added Glauber Ribeiro's Win32 executable.
25-Apr-1998: faq.html: Modified the UNTAB program.
05-Aug-1998: Added user manual in PDF form.
05-Aug-1998: Added XML to links page.
24-Apr-1999: Reworked the entire web.
15-May-1999 RNW Uploaded the new improved web.
15-Jun-1999 RNW Added AIX executable.
30-Jun-1999 RNW Eliminated reference to non-existence background.gif file.
29-Sep-1999 RNW Updated mailing list page for new mailing list addresses.
29-Dec-1999 RNW Added sidebar image strut to stop it collapsing.
30-Dec-1999 RNW Amended the Tony Coates links on the links page.
03-Jan-2000 RNW Added Paul Wanis quote to testimonial page and sidebar quotes.
03-Jan-2000 RNW Changed the wording on the home page a little.
@}

@!******************************************************************************

@B@<Things To Do@>

@$@<Things to do@>@Z@{

Publicity
---------
* Register with search engines.
* Add to the Literate Programming Web Ring.
   http://www.tummy.com/LiterateProgramming/

Later
-----
* Put up DVI forms of the user manuals.

History
-------
09-Jul-1992 Work on FunnelWeb abandoned.

Shipping
--------
$ zip -v fw.zip fw.exe
  adding: fw.exe
                .....   (in=196608) (out=78447) (deflated 60%)
total bytes=196608, compressed=78447 -> 60% savings

@}

@!******************************************************************************

@B@<Graphic Design Notes@>

Sometimes when one needs to modify or duplicate the style of the original
graphics, it's very hard to remember how they were originally made. This
section contains notes on graphics in the FunnelWeb web.

@$@<Graphic Design Notes@>@Z@{
Title
   Bookman SSi 60pt Black
   Glass: Little lumps
Logo
   Take Macintosh FunnelWeb Icon
   Enlarge it
   Glass: Big Lumps (I think).

Labels
   Start with 100x25. Fill it in with (204,204,204).
   Bookman SSi, 18pt, Bold, Anti.
      Color=(0,0,0)
      Color=(255,0,0)
   Veracity shadow with blur=1
   Convert to SYSTEM colour pallete in Photoshop.
   (If you convert using adaptive, the grey background gets
    set to 206 instead of 204 and netscape dithers it when it
    displays it).

Front page ticks
   11-Jul-1999 I'm pretty sure these came from Web Explosion:Bullets.
@}

@!******************************************************************************
@!******************************************************************************
@!******************************************************************************

@$@<Body@>@M@{@-
<BODY BGCOLOR=@<White@>
      TEXT="#000000"
      VLINK="#660000"
      LINK="#FF0000"
      ALINK="#CC0000">@}

@$@<FunnelWeb WWW@>@Z@M@{@}
@$@<FunnelWeb Reference WWW@>@Z@M@{reference/@}
@$@<FunnelWeb Tutorial WWW@>@Z@M@{tutorial/@}
@$@<FunnelWeb Developer WWW@>@Z@M@{developer/@}

@$@<Page border colour@>@M@{#CCCCCC@}

@! The following macro is used in strings and so must be on one line.
@! @$@<Body/PERL@>@Z@M@{<BODY BGCOLOR=\"#FFFFFF\" TEXT=\"#000033\" VLINK=\"#660000\" LINK=\"#FF0000\" ALINK=\"#CC0000\">@}

@$@<FormWidth@>@Z@M@{35@}

@!******************************************************************************

@B@<Page Macros@>

The following macros provide macros to set up the top and bottom of pages.

@!------------------------------------------------------------------------------

@$@<Go to any page bar@>@M@{@-
<FORM ACTION=none>
<SELECT NAME="apage" SIZE=1
onChange="location.replace(this.options[this.selectedIndex].value); return true;">
@<FWOption@>@(@,Find any page.@)
@<FWOption@>@(@<Index FILE@>@,_______________@)
@<FWOption@>@(@<Index FILE@>@,HOME@)
@<FWOption@>@(@<Copyright FILE@>@,Copyright@)
@<FWOption@>@(@<Overview FILE@>@,_______________@)
@<FWOption@>@(@<Overview FILE@>@,OVERVIEW@)
@<FWOption@>@(@<Stability FILE@>@,Stability@)
@<FWOption@>@(@<FAQ FILE@>@,FAQ@)
@<FWOption@>@(@<Testimonials FILE@>@,Testimonials@)
@<FWOption@>@(@<Install FILE@>@,_______________@)
@<FWOption@>@(@<Install FILE@>@,INSTALL@)
@<FWOption@>@(@<Manuals FILE@>@,_______________@)
@<FWOption@>@(@<Manuals FILE@>@,MANUALS@)
@<FWOption@>@(@<Support FILE@>@,_______________@)
@<FWOption@>@(@<Support FILE@>@,SUPPORT@)
@<FWOption@>@(@<Mailing_list FILE@>@,Mailing List@)
@<FWOption@>@(@<Links FILE@>@,_______________@)
@<FWOption@>@(@<Links FILE@>@,LINKS@)
@<FWOption@>@(@<FunnelWeb_search FILE@>@,_______________@)
@<FWOption@>@(@<FunnelWeb_search FILE@>@,SEARCH@)
</SELECT>
</FORM>
@}

@$@<FWOption@>@(@2@)@M@{<OPTION VALUE="@1">@2@}

@!------------------------------------------------------------------------------

Page = Sidebar + Body + Rightline
Body = leftmargin + text + rightmargin

@$@<Page WIDTH@>@M@{535@}
@$@<Sidebar WIDTH@>@M@{120@}
@$@<Body WIDTH@>@M@{405@}
@$@<Rightline WIDTH@>@M@{10@}

@$@<Body leftmargin WIDTH@>@M@{20@}
@$@<Body text WIDTH@>@M@{365@}
@$@<Body rightmargin WIDTH@>@M@{20@}

@$@<Begin FunnelWeb generic page@>@(@3@)@M@{
<HTML>

@<Header comment@>

<HEAD>
<TITLE>@1</TITLE>
@<Suppress hyperlink underlining@>
@2
</HEAD>

@<Body@>

<CENTER>

<TABLE WIDTH=@<Page WIDTH@> BORDER=0 CELLSPACING=0 CELLPADDING=0>

<TR>
<TD COLSPAN=3 BGCOLOR=@<Page border colour@> VALIGN="bottom">@<Banner IMAGE/left@>
@<BR@>
@<BR@>
@<BR@>
@<Go to any page bar@></TD>
</TR>

<TR>
<TD BGCOLOR=@<Page border colour@> ROWSPAN=2 WIDTH=@<Sidebar WIDTH@> VALIGN=top ALIGN=left>
@<HStrut@>@(@<Sidebar WIDTH@>@)@<BR@>
@<Space(w,h)/left@>@(7@,1@)@<RossNet linklogo IMAGE@>@<BR@>
@<BR@>
<CENTER>
@3
</CENTER>
@<Dynamic sidebar note@>
</TD>
<TD BGCOLOR=@<Page border colour@> ALIGN=CENTER>
@<_@>
</TD>
<TD BGCOLOR=@<Page border colour@>>@<_@></TD>
</TR>

<TR>
<TD WIDTH=@<Body WIDTH@> BGCOLOR=#FFFFFF>

<TABLE WIDTH=@<Body WIDTH@> BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR><TD WIDTH=@<Body leftmargin WIDTH@>>&nbsp;</TD><TD WIDTH=@<Body text WIDTH@> VALIGN="top">
<BR>
@}

@!------------------------------------------------------------------------------

@$@<End FunnelWeb page@>@M@{
@<P@>
@<Go to any page bar@>
@<P@>
@<Begin size2@>
<A HREF="@<Index FILE@>">HOME</A>
@<_@>@<_@>
<A HREF="mailto:@<Ross webmaster EMAIL@>">Webmaster</A>
@<_@>@<_@>
<A HREF="@<Copyright FILE@>">@<Copyright notice/HTML@></A><BR>
<BR>
@<End size2@>
</TD>
<TD WIDTH=@<Body rightmargin WIDTH@>>&nbsp;</TD>
</TABLE>

</TD>

<TD WIDTH=@<Rightline WIDTH@> BGCOLOR=@<Page border colour@>>&nbsp;</TD>

</TR>

<TR><TD COLSPAN=3 BGCOLOR=@<Page border colour@>>&nbsp;</TD></TR>

</TABLE>


</CENTER>
</BODY>

@<Trailer comment@>

</HTML>
@}

@$@<Buttons/home@>@M@{
@<Begin size5@>
@<Label_home_b IMAGE@>@<BR@>
@<Label_overview_a IMAGE@>@<BR@>
@<Label_install_a IMAGE@>@<BR@>
@<Label_manuals_a IMAGE@>@<BR@>
@<Label_support_a IMAGE@>@<BR@>
@<Label_links_a IMAGE@>@<BR@>
@<Label_search_a IMAGE@>@<BR@>
@<End size5@>
@}

@$@<Buttons/overview@>@M@{
@<Begin size5@>
@<Label_home_a IMAGE@>@<BR@>
@<Label_overview_b IMAGE@>@<BR@>
@<Label_install_a IMAGE@>@<BR@>
@<Label_manuals_a IMAGE@>@<BR@>
@<Label_support_a IMAGE@>@<BR@>
@<Label_links_a IMAGE@>@<BR@>
@<Label_search_a IMAGE@>@<BR@>
@<End size5@>
@}

@$@<Buttons/install@>@M@{
@<Begin size5@>
@<Label_home_a IMAGE@>@<BR@>
@<Label_overview_a IMAGE@>@<BR@>
@<Label_install_b IMAGE@>@<BR@>
@<Label_manuals_a IMAGE@>@<BR@>
@<Label_support_a IMAGE@>@<BR@>
@<Label_links_a IMAGE@>@<BR@>
@<Label_search_a IMAGE@>@<BR@>
@<End size5@>
@}

@$@<Buttons/manuals@>@M@{
@<Begin size5@>
@<Label_home_a IMAGE@>@<BR@>
@<Label_overview_a IMAGE@>@<BR@>
@<Label_install_a IMAGE@>@<BR@>
@<Label_manuals_b IMAGE@>@<BR@>
@<Label_support_a IMAGE@>@<BR@>
@<Label_links_a IMAGE@>@<BR@>
@<Label_search_a IMAGE@>@<BR@>
@<End size5@>
@}

@$@<Buttons/support@>@M@{
@<Begin size5@>
@<Label_home_a IMAGE@>@<BR@>
@<Label_overview_a IMAGE@>@<BR@>
@<Label_install_a IMAGE@>@<BR@>
@<Label_manuals_a IMAGE@>@<BR@>
@<Label_support_b IMAGE@>@<BR@>
@<Label_links_a IMAGE@>@<BR@>
@<Label_search_a IMAGE@>@<BR@>
@<End size5@>
@}

@$@<Buttons/links@>@M@{
@<Begin size5@>
@<Label_home_a IMAGE@>@<BR@>
@<Label_overview_a IMAGE@>@<BR@>
@<Label_install_a IMAGE@>@<BR@>
@<Label_manuals_a IMAGE@>@<BR@>
@<Label_support_a IMAGE@>@<BR@>
@<Label_links_b IMAGE@>@<BR@>
@<Label_search_a IMAGE@>@<BR@>
@<End size5@>
@}

@$@<Buttons/search@>@M@{
@<Begin size5@>
@<Label_home_a IMAGE@>@<BR@>
@<Label_overview_a IMAGE@>@<BR@>
@<Label_install_a IMAGE@>@<BR@>
@<Label_manuals_a IMAGE@>@<BR@>
@<Label_support_a IMAGE@>@<BR@>
@<Label_links_a IMAGE@>@<BR@>
@<Label_search_b IMAGE@>@<BR@>
@<End size5@>
@}

@!------------------------------------------------------------------------------

@$@<Begin FunnelWeb page/index@>@(@1@)@Z@M@{
@<Begin FunnelWeb generic page@>@(@1@,@<FunnelWeb keywords and decription@>@,@<Buttons/home@>@)
@}

@!------------------------------------------------------------------------------

@$@<Begin FunnelWeb page/home@>@(@1@)@Z@M@{
@<Begin FunnelWeb generic page@>@(@1@,@,@<Buttons/home@>@)
@<FunnelWeb heading@>@(@1@)
@}

@!------------------------------------------------------------------------------

@$@<Begin FunnelWeb page/overview@>@(@1@)@Z@M@{
@<Begin FunnelWeb generic page@>@(@1@,@,@<Buttons/overview@>@)
@<FunnelWeb heading@>@(@1@)
@}

@!------------------------------------------------------------------------------

@$@<Begin FunnelWeb page/install@>@(@1@)@Z@M@{
@<Begin FunnelWeb generic page@>@(@1@,@,@<Buttons/install@>@)
@<FunnelWeb heading@>@(@1@)
@}

@!------------------------------------------------------------------------------

@$@<Begin FunnelWeb page/manuals@>@(@1@)@Z@M@{
@<Begin FunnelWeb generic page@>@(@1@,@,@<Buttons/manuals@>@)
@<FunnelWeb heading@>@(@1@)
@}

@!------------------------------------------------------------------------------

@$@<Begin FunnelWeb page/support@>@(@1@)@Z@M@{
@<Begin FunnelWeb generic page@>@(@1@,@,@<Buttons/support@>@)
@<FunnelWeb heading@>@(@1@)
@}

@!------------------------------------------------------------------------------

@$@<Begin FunnelWeb page/links@>@(@1@)@Z@M@{
@<Begin FunnelWeb generic page@>@(@1@,@,@<Buttons/links@>@)
@<FunnelWeb heading@>@(@1@)
@}

@!------------------------------------------------------------------------------

@$@<Begin FunnelWeb page/search@>@(@1@)@Z@M@{
@<Begin FunnelWeb generic page@>@(@1@,@,@<Buttons/search@>@)
@<FunnelWeb heading@>@(@1@)
@}

@!******************************************************************************

@B@<Images@>

@$@<Banner IMAGE/left@>@M@{@-
<A HREF="@<Index FILE@>"><IMG SRC="@<Bin@>title.gif"
 WIDTH="300" HEIGHT="60" ALT="FunnelWeb" BORDER="0" HSPACE=10 VSPACE=5 ALIGN="left"></A>@}

@!******************************************************************************

@B@<General FunnelWeb Macros@>

@$@<FunnelWeb Webmaster@>@M@{@-
@<Link@>@(mailto:@<Ross webmaster EMAIL@>@,FunnelWeb Webmaster@)@}

@$@<FunnelWeb heading@>@(@1@)@Z@M@{@-
@<P@>@<BR@>@<Size6@>@(@1@)@<BR@>@}

@$@<FunnelWeb heading/nospace@>@(@1@)@Z@M@{@-
@<Size6@>@(@1@)@<BR@>@}

@$@<FunnelWeb subheading@>@(@1@)@Z@M@{@-
@<P@>@<BR@>@<Size4@>@(@<B@>@(@1@)@)@<BR@>@}

@$@<FunnelWeb subsubheading@>@(@1@)@Z@M@{@-
@<P@>@<BR@>@<Size3@>@(@<B@>@(@1@)@)@<BR@>@}

@$@<FunnelWeb heading/center@>@(@1@)@Z@M@{@-
@<P@>@<BR@>
@<Begin center@>
@<Size5@>@(@<B@>@(@1@)@)@<BR@>
@<End center@>@}


@$@<Bar30@>@Z@M@{<P><CENTER><HR WIDTH="30%"></CENTER>@}

@$@<Back to the home page@>@Z@M@{
@<P@>
@<BR@>
@<B@>@(<A HREF="@<Index FILE@>">Back to the FunnelWeb Home Page</A>@)@<BR@>
@}

@$@<Label_home_a IMAGE@>@M@{@<VLabel@>@(Home@,label_home_a.gif@,@<Index FILE@>@)@}
@$@<Label_home_b IMAGE@>@M@{@<VLabel@>@(Home@,label_home_b.gif@,@<Index FILE@>@)@}

@$@<Label_overview_a IMAGE@>@M@{@<VLabel@>@(Overview@,label_overview_a.gif@,@<Overview FILE@>@)@}
@$@<Label_overview_b IMAGE@>@M@{@<VLabel@>@(Overview@,label_overview_b.gif@,@<Overview FILE@>@)@}

@$@<Label_install_a IMAGE@>@M@{@<VLabel@>@(Install@,label_install_a.gif@,@<Install FILE@>@)@}
@$@<Label_install_b IMAGE@>@M@{@<VLabel@>@(Install@,label_install_b.gif@,@<Install FILE@>@)@}

@$@<Label_manuals_a IMAGE@>@M@{@<VLabel@>@(Manuals@,label_manuals_a.gif@,@<Manuals FILE@>@)@}
@$@<Label_manuals_b IMAGE@>@M@{@<VLabel@>@(Manuals@,label_manuals_b.gif@,@<Manuals FILE@>@)@}

@$@<Label_support_a IMAGE@>@M@{@<VLabel@>@(Support@,label_support_a.gif@,@<Support FILE@>@)@}
@$@<Label_support_b IMAGE@>@M@{@<VLabel@>@(Support@,label_support_b.gif@,@<Support FILE@>@)@}

@$@<Label_links_a IMAGE@>@M@{@<VLabel@>@(Links@,label_links_a.gif@,@<Links FILE@>@)@}
@$@<Label_links_b IMAGE@>@M@{@<VLabel@>@(Links@,label_links_b.gif@,@<Links FILE@>@)@}

@$@<Label_search_a IMAGE@>@M@{@<VLabel@>@(Search@,label_search_a.gif@,@<FunnelWeb_search FILE@>@)@}
@$@<Label_search_b IMAGE@>@M@{@<VLabel@>@(Search@,label_search_b.gif@,@<FunnelWeb_search FILE@>@)@}

@$@<VLabel@>@(@3@)@M@{<A HREF="@3"><IMG SRC="@<Bin@>@2" HEIGHT=25 WIDTH=100 BORDER=0 ALT="@1"></A>@}

@$@<Red_pin IMAGE/left@>@Z@M@{<IMG SRC="@<Bin@>rd_pin.gif" HEIGHT="21" WIDTH="21" ALIGN="left" ALT="*">@}

@$@<Rossnet_logo IMAGE@>@Z@M@{@-
<A HREF="@<Ross root WWW@>">
   <IMG BORDER="0"
    ALT="*"
    ALIGN="left"
    SRC="@<Bin@>rossnet_logo.gif" HEIGHT="32" WIDTH="64">
</A>@}

@$@<FunnelWeb_logo IMAGE@>@Z@M@{@-
<A HREF="@<FunnelWeb WWW@>">
   <IMG BORDER="0"
    ALT="*"
    ALIGN="left"
    SRC="@<Bin@>linklogo.gif" HEIGHT="32" WIDTH="64">
</A>@}

@$@<Spider_up IMAGE@>@Z@M@{@-
<IMG SRC="@<Bin@>fw_up.gif" WIDTH=32 HEIGHT=32 ALT="*">@}

@$@<Spider_up IMAGE/left@>@Z@M@{@-
<IMG SRC="@<Bin@>fw_up.gif" WIDTH=32 HEIGHT=32 ALT="*" ALIGN="left">@}

@$@<Spider_up IMAGE/right@>@Z@M@{@-
<IMG SRC="@<Bin@>fw_up.gif" WIDTH=32 HEIGHT=32 ALT="*" ALIGN="right">@}

@$@<Spider_down IMAGE@>@Z@M@{@-
<IMG SRC="@<Bin@>fw_down.gif" WIDTH=32 HEIGHT=32 ALT="*">@}

@$@<Spider_left IMAGE@>@Z@M@{@-
<IMG SRC="@<Bin@>fw_left.gif" WIDTH=32 HEIGHT=32 ALT="*">@}

@$@<Spider_left IMAGE/right@>@Z@M@{@-
<IMG SRC="@<Bin@>fw_left.gif" WIDTH=32 HEIGHT=32 ALT="*" ALIGN="right">@}

@$@<Spider_right IMAGE@>@Z@M@{@-
<IMG SRC="@<Bin@>fw_right.gif" WIDTH=32 HEIGHT=32 ALT="*">@}

@$@<Spider_right IMAGE/left@>@Z@M@{@-
<IMG SRC="@<Bin@>fw_right.gif" WIDTH=32 HEIGHT=32 ALT="*" ALIGN="left">@}

@$@<Spider_right IMAGE/right@>@Z@M@{@-
<IMG SRC="@<Bin@>fw_right.gif" WIDTH=32 HEIGHT=32 ALT="*" ALIGN="right">@}

@!******************************************************************************

@$@<FunnelWeb keywords and decription@>@{
<META NAME="description"
 CONTENT="FunnelWeb is a portable literate-programming macro preprocessor
 that enables you to weave code and documentation together."

<META NAME="keywords"
 CONTENT="funnelweb,funnel,web,FunnelWeb,Funnelweb,
          literate programming,literate, programming,literate-programming,
          macro,macros,preprocessor,macro preprocessor,
          software,free,freeware,gnu,copyleft,
          web,development,tool,web tool,
          ross,williams,ross williams,
          ross n williams,Ross,Williams,Ross Williams">
@}

@!==============================================================================

@$@<FWIcon@>@Z@M@{
<IMG SRC="@<Bin@>fw_icon.gif" HEIGHT="32" WIDTH="32" BORDER="0" ALT="[Icon]">
@}

@$@<FWIcon/para@>@Z@M@{
<IMG SRC="@<Bin@>fw_icon.gif"
HEIGHT="32" WIDTH="32"
BORDER="0" ALT="[Icon]"
ALIGN="left" HSPACE="5">
@}

@$@<Tick16 IMAGE@>@Z@M@{@-
<IMG SRC="@<Bin@>tick_red.gif"
WIDTH="16" HEIGHT="16" HSPACE=2 VSPACE=0 ALT="*" BORDER="0">@}

@$@<Tick IMAGE@>@Z@M@{@-
<IMG SRC="@<Bin@>tick_red_12.gif"
WIDTH="12" HEIGHT="12" HSPACE=4 VSPACE=0 ALT="*" BORDER="0">@}

@!******************************************************************************
@!******************************************************************************

@$@<Home FILE@>@Z@M@{index.shtml@}
@$@<Index FILE@>@Z@M@{index.shtml@}
@O@<index.shtml@>@{@-
@<Begin FunnelWeb page/index@>@(The FunnelWeb Literate Programming Tool@)

@<IFCopy@>@(
@<Begin blockquote@>
<FONT COLOR=#993300 SIZE=2>
@<Boldthing@>@(Note:@) This is a copy of the FunnelWeb
website as it was on @<CopyDate@>. This copy may now be
out of date. The official FunnelWeb website can be found
at @<WindowLink@>@(@<FunnelWeb WWW/abs@>@,@-
@<FunnelWeb WINDOWNAME@>@,@<FunnelWeb WWW/abs@>@)
</FONT>
@<End blockquote@>

@<P@>
@<HR@>
@)

@<P@>@<Spider_up IMAGE/right@>Welcome to the FunnelWeb Home Page.
FunnelWeb is a
powerful literate-programming macro preprocessor that
enables you to weave programs and documentation together.
FunnelWeb is a @<B@>@(production quality@) tool that was
specifically engineered for practical everyday use:

@<P@>
@<Begin indent@>
@<Tick IMAGE@>Can be used with any programming language.@<BR@>
@<Tick IMAGE@>Runs on most platforms (including GNU/Linux).@<BR@>
@<Tick IMAGE@>Free of charge; entirely non-commercial.@<BR@>
@<Tick IMAGE@>Source available under a GNU licence.@<BR@>
@<Tick IMAGE@>Reference, tutorial, and developer manuals.@<BR@>
@<Tick IMAGE@>Mature and essentially bug-free (released 1992).@<BR@>
@<Tick IMAGE@>Simple; specifically designed to minimize errors.@<BR@>
@<Tick IMAGE@>High speed; doesn't stretch the development cycle.@<BR@>
@<Tick IMAGE@>Used to create the @<Veracity@> data integrity product.@<BR@>
@<Tick IMAGE@>Generates documentation in HTML and TeX forms.@<BR@>
@<Tick IMAGE@>FunnelWeb user community mailing list.@<BR@>
@<End indent@>

@<P@>@<Spider_right IMAGE/left@>But FunnelWeb is also
a powerful @<B@>@(general
purpose@) text file preparation tool that has found many
applications outside the area of literate programming. For
example, FunnelWeb was used to create the web you are
reading. Check out the @<User Testimonials@>.

@<P@>@<Spider_left IMAGE/right@>If
you are looking for a solid literate-programming
tool, or if you are curious about how FunnelWeb's macro
capabilities can help you in your everyday computing, I
hope that you will take the time to
@<Link@>@(@<Install FILE@>@,try out FunnelWeb.@)

@<P@>
@<Ross Williams@>@<BR@>
Author of FunnelWeb@<BR@>
Adelaide, May 1999.@<BR@>

@<P@>
@<Begin size2@>
PS: If you found this page because you were looking for the
Funnelweb web traffic analysis tool, you should visit the
@<Active Concepts@> web instead.
@<End size2@>

@<End FunnelWeb page@>
@}

@!******************************************************************************

@$@<Overview FILE@>@Z@M@{overview.shtml@}
@O@<overview.shtml@>@{
@<Begin FunnelWeb page/overview@>@(Overview Of FunnelWeb@)

@<P@>@<Spider_right IMAGE/right@>FunnelWeb
is a essentially a macro preprocessor. It reads
in an input file containing a list of macros and generates one
or more output files that are defined in terms of the macros.
In between the macro definitions, you can add explanatory text,
enabling the entire document to be typeset as code documentation.
For this reason, FunnelWeb is best described as a
"Literate Programming Macro Preprocessor".

@<P@>FunnelWeb has the following features:

@<P@>
@<Begin list@>
@<Item@>A simple macro preprocessor facility.
@<Item@>Generates documentation in TeX and HTML formats.
@<Item@>Runs on a variety of platforms.
@<Item@>Portable C source code available under GNU licence.
@<Item@>Comprehensive documentation.
@<Item@>Input-programming-language independent.
@<Item@>Allows complete control over the output text.
@<End list@>

@<P@>FunnelWeb can be used in a variety of roles, but in particular
is useful for:

@<Begin list@>
@<Item@>Writing complicated computer programs.
@<Item@>Preparing related collection of text files.
@<Item@>Preparing text files in a cryptic language.
@<End list@>

@<P@>@<Spider_right IMAGE/left@>In
particular, these properties make FunnelWeb perfect for
generating webs. In fact, this FunnelWeb web was generated
using FunnelWeb. For more information, see the chapter on this
topic in the @<FunnelWeb Tutorial Manual@>.

@<P@>FunnelWeb is in use all around the world in a wide variety of
roles. To see some comments that FunnelWeb users have made about
FunnelWeb, see the @<FunnelWeb Testimonials@> page.

@<P@>To get started with FunnelWeb, visit the
@<FunnelWeb Installation@> page. If you're worried about the
stability and availabity of FunnelWeb, visit the
@<Link@>@(@<Stability FILE@>@,Stability Page@).

@<P@>There is a @<Frequently Asked Questions@> page too.

@<End FunnelWeb page@>
@}

@!******************************************************************************

@$@<Stability FILE@>@Z@M@{stability.shtml@}
@O@<stability.shtml@>@{
@<Begin FunnelWeb page/overview@>@(FunnelWeb Stability@)

@<P@>@<Spider_right IMAGE/left@>One
of the dangers of becoming involved with a language
tool such as FunnelWeb is that you become dependent upon it.
If FunnelWeb were to stop working for some reason, your
@<TT@>@(.fw@) files would become unuseable. This can happen
because of operating system upgrades, copyright problems,
unfixable bugs, or just the inability of the program to be
ported to a new target platform.

@<P@>I am critically aware of these issues, and have taken
the following steps to ensure that FunnelWeb provides a
stable base upon which to build software:

@<Narrowthing@>@(Open source:@,FunnelWeb's C source code has
been released under GNU General Public License Version 2.
This means not only that FunnelWeb is available free of
charge, but that the source code to FunnelWeb is available
to you free of charge too. If a FunnelWeb executable ever
stops working, you can compile a new version on your
platform. If ever you run up against a serious bug, you can
always fix it.@)

@<Narrowthing@>@(Portability:@,FunnelWeb has been designed
and written to be extremely portable. First, all FunnelWeb
really does is read and write text files, which are very
portable operations. Second, FunnelWeb is written in the C
programming language with portability as a major design
goal. Third, FunnelWeb has already been ported to many
popular platforms (including Windows, Macintosh, Solaris,
and OpenVMS) and will probably compile on many others, with
almost no change. Fourth, FunnelWeb comes with a
comprehensive automated regression test suite that makes it
easy to pinpoint problems when it is moved to a new
platform. All this amounts to an assurance that if you have
to migrate to a new platform, FunnelWeb can migrate with
you.@)

@<Narrowthing@>@(Quality:@,The FunnelWeb source code is
stable high quality code. Design decisions have not been
taken lightly. FunnelWeb V3.0 has been in daily use since
its release in 1992, and the few bugs that were found were
all fixed in FunnelWeb V3.2.@)

@<Narrowthing@>@(Documentation:@,FunnelWeb is comprehensively
documented by
the @<FunnelWeb Reference Manual@>,
the @<FunnelWeb Tutorial Manual@>
and the @<FunnelWeb Developer Manual@>.
These manuals, plus the source code, provide the
ultimate reference for any questions about FunnelWeb
you may have.@)

@<Narrowthing@>@(Language stability:@,To protect your
investment in the FunnelWeb language, I intend to ensure
that future versions of the official version of FunnelWeb
maintain backwards compatibility so that existing FunnelWeb
files can always be processed. Having done most of my
programming since 1986 using FunnelWeb, I am not in a
position to compromise on backwards compatibility!@)

@<P@>It is my hope that together these elements will
eliminate any fears you may have about the stability
and availability of the FunnelWeb language.

@<End FunnelWeb page@>
@}

@!******************************************************************************

@$@<FAQ@>@Z@M@{@<Link@>@(@<FAQ FILE@>@,FAQ@)@}
@$@<Frequently Asked Questions@>@Z@M@{@<Link@>@(@<FAQ FILE@>@,FAQ@)@}
@$@<FAQ FILE@>@M@{faq.shtml@}
@O@<faq.shtml@>@{@-
@<Begin FunnelWeb page/overview@>@(Frequently Asked Questions@)

@<FunnelWeb subheading@>@(What Is FunnelWeb?@)

@<P@>FunnelWeb is a essentially a macro preprocessor. It reads
in an input file containing a list of macros and generates one
or more output files that are defined in terms of the macros.
In between the macro definitions, you can add explanatory text,
enabling the entire document to be typeset as documentation for
the code. For this reason, FunnelWeb is best describes as a
"Literate Programming Macro Preprocessor".

@<FunnelWeb subheading@>@(How Much Does FunnelWeb Cost?@)

@<P@>FunnelWeb is free and distributed under a GNU licence.
You can download executables for a wide range of platforms,
or compile FunnelWeb yourself.

@<FunnelWeb subheading@>@(I Was Expecting A Web Log Analysis Tool!@)

@<P@>In about 1997, the Australian company
@<Active Concepts@> named its webserver logfile analysis tool
@<DQ@>@(Funnel Web@). If you were looking for that tool, visit
the @<Active Concepts@> web site. From what I have heard, their
FunnelWeb is an excellent webserver logfile analysis tool.

@<P@>Note: The FunnelWeb of the site you are reading was named
in 1986, long before the world wide web even existed.

@<End FunnelWeb page@>
@}

@!******************************************************************************

@$@<User Testimonials@>@M@{@<Link@>@(@<Testimonials FILE@>@,User Testimonials@)@}

@$@<FunnelWeb Testimonials@>@M@{@<Link@>@(@<Testimonials FILE@>@,FunnelWeb Testimonials@)@}

@$@<FWTestimonial@>@(@2@)@M@{@-
@<Begin blockquote@>
@1
@<Begin indent@>
@<Begin size2@>
@2
@<End size2@>
@<End indent@>
@<End blockquote@>
@}

@$@<Testimonials FILE@>@Z@M@{testimonials.shtml@}
@O@<testimonials.shtml@>@{@-
@<Begin FunnelWeb page/overview@>@(FunnelWeb User Testimonials@)

@<Begin size4@>
@<P@>Praise for FunnelWeb:
@<End size4@>

@<P@>
@<Spider_up IMAGE/left@>@<FunnelWeb subheading@>@(Power@)

@<FWTestimonial@>@(
"I've been fooling around with FunnelWeb for about three days now, and
I'm convinced that this is one of the most powerful tools I have
encountered in almost two decades of programming. I'm in the process
of converting several thousand lines of very repetitive code to
FunnelWeb macros; I can't believe how EASY it is, and how GOOD the
resulting source code and documentation are. Thank you for this tool!"
@,
Jerry Callen (jcallen@@world.std.com)@<BR@>
Runtime Engineer,@<BR@>
Thinking Machines Corporation,@<BR@>
Boston, USA.@<BR@>
22-Jun-1992 (Authorized to be quoted 16-Oct-1992).
@)

@<Spider_up IMAGE/left@>@<FunnelWeb subheading@>@(Quality@)

@<FWTestimonial@>@(
"I really like the 'quality' of the FW distribution. Well done Ross!
I cannot call it 'professional quality' because much of the
'professional' software I have seen has been VERY POOR.  Your package
is better than 'professional', but I don't know of an appropriate
adjective."
@,
George Vokalek (gvokalek@@augean.eleceng.adelaide.edu.au).@<BR@>
Hardware Engineer,@<BR@>
University of Adelaide,@<BR@>
South Australia, Australia.@<BR@>
14-Jun-1992 (Authorized to be quoted 18-Oct-1992).
@)

@<Spider_up IMAGE/left@>@<FunnelWeb subheading@>@(Correctness@)

@<FWTestimonial@>@(
"I have used FunnelWeb on two ASSEMBLER modules. Written for a
microcontroller with NO DEBUGGING POSSIBLE, so correctness and
emphasis on getting it right was important.@<BR@>
@<BR@>
I found it forced me to reorganise the code a bit, to get my concepts
straight. By the time I did this, and documented what I was doing,
[including a C version of an algorithm in one module] It looked good,
and worked in a few passes.@<BR@>
@<BR@>
I am VERY happy with the results. ...@<BR@>
@<BR@>
And, I got a very nice listing to present the customer!!"
@,
John Skaller (maxtal@@extro.ucc.su.oz.au)@<BR@>
Maxtal Pty Ltd,@<BR@>
Sydney, Australia.@<BR@>
09-Jul-1992 (Authorized to be quoted 17-Oct-1992).
@)

@<Spider_up IMAGE/left@>@<FunnelWeb subheading@>@(User Manual@)

@<FWTestimonial@>@(
"...the manual is about 10 times better than any other user manual
I've ever read."
@,
Barry Dwyer (dwyer@@cs.adelaide.edu.au)@<BR@>
Senior Lecturer, Department of Computer Science,@<BR@>
The University of Adelaide.@<BR@>
Australia.@<BR@>
17-Jun-1992 (Authorized to be quoted 21-Oct-1992).
@)

@<Spider_up IMAGE/left@>@<FunnelWeb subheading@>@(Portability@)

@<FWTestimonial@>@(
"I've done the regression testing, and it worked without a hitch.
You've done a nice job making the sucker portable. My system is a mono
NeXTstation running NeXTSTEP 2.1 with 16 MB of RAM."
@,
John Dawson (john@@arissoft.com)@<BR@>
Software Developer,@<BR@>
Arissoft Development Corporation,@<BR@>
Texas, USA.@<BR@>
11-Jun-1992. (Authorized to be quoted 17-Oct-1992).
@)

@<Spider_up IMAGE/left@>@<FunnelWeb subheading@>@(Coolness@)

@<FWTestimonial@>@(
"I use FunnelWeb for everything from my FutureBASIC programming to
maintaining my web pages. It is a cool tool, and one of the few
literate programming environments that are (1) language-independent
and (2) available on the Mac. I couldn't be more pleased with it."
@,
Ron Hale-Evans (rwhe@@apocalypse.org)@<BR@>
Author/Publisher,@<BR@>
Lexington, Kentucky, USA.@<BR@>
20-Oct-1996. (Authorized to be quoted 20-Oct-1996).
@)

@<Spider_up IMAGE/left@>@<FunnelWeb subheading@>@(Style@)

@<FWTestimonial@>@(
"Let me say that FunnelWeb is the most impressive
literate programming tool I have yet seen.  The language
is powerful, the tutorial manual excellent, and I really
love the new weave facility to output both TeX and HTML
(both of which are very visually appealing -- a rare feat
these days)."
@,
Paul Wanis (wanis@@hotmail.com)@<BR@>
Electrical Engineer,@<BR@>
San Diego, CA USA.@<BR@>
04-Jun-1999. (Authorized to be quoted 30-Dec-1999).
@)

@<Begin size4@>

@<P@>@<BR@>Convinced that FunnelWeb is
@<Link@>@(@<Install FILE@>@,worth checking out?@)

@<P@>@<BR@>

@<End size4@>

@<End FunnelWeb page@>
@}

@!******************************************************************************

@$@<FunnelWeb Installation@>@M@{@-
<A HREF="install.shtml">FunnelWeb Installation</A>@}

@$@<Install FILE@>@Z@M@{install.shtml@}
@O@<install.shtml@>@{@-
@<Begin FunnelWeb page/install@>@(Installing FunnelWeb@)

@<P@>FunnelWeb is available free of charge for a wide range of platforms.
Just follow these steps.

@<FunnelWeb subheading@>@(1. FTP A FunnelWeb Executable@)

@<P@>Download a FunnelWeb executable now for any or all of
the following platforms:

@<Begin indent@>
@<FWDownload@>@(funnelweb_v320_mac.hqx@,FunnelWeb V3.2 for Macintosh-68K (147K)@)
@<FWDownload@>@(funnelweb_v320_win32.zip@,FunnelWeb V3.2 for Windows 95/NT (126K)@)
@<FWDownload@>@(funnelweb_v320_msdos.zip@,FunnelWeb V3.2 for MS-DOS (189K)@)
@<FWDownload@>@(funnelweb_v320_bsdos.tar.Z@,FunnelWeb V3.2 for BSD/OS (168K)@)
@<FWDownload@>@(funnelweb_v320_digunix.tar.Z@,FunnelWeb V3.2 for Digital Unix (161K)@)
@<FWDownload@>@(funnelweb_v320_freebsd.tar.Z@,FunnelWeb V3.2 for FreeBSD (119K)@)
@<FWDownload@>@(funnelweb_v320_irix.tar.Z@,FunnelWeb V3.2 for IRIX (168K)@)
@<FWDownload@>@(funnelweb_v320_redhat.tar.Z@,FunnelWeb V3.2 for Red Hat Linux (119K)@)
@<FWDownload@>@(funnelweb_v320_solaris.tar.Z@,FunnelWeb V3.2 for Solaris (133K)@)
@<FWDownload@>@(funnelweb_v320_aix.tar.Z@,FunnelWeb V3.2 for AIX (166K)@)
@<End indent@>

@<P@>FunnelWeb is provided under an open source GNU licence,
so if your platform is not listed above, you are welcome to
download the C source code and compile it on whatever
platform you have. You can find instructions on how to
compile FunnelWeb in the @<FunnelWeb Developer Manual@>.

@<Source download list@>

@<FunnelWeb subheading@>@(2. FTP The FunnelWeb Manuals@)

@<P@>The documentation for FunnelWeb consists of this main
FunnelWeb web and three manuals, also in web form, which are
online. You can browse them in a new browser window by clicking
below:

@<P@>
@<Begin indent@>
@<FunnelWeb Main Web@>@<BR@>
@<FunnelWeb Tutorial Manual@>@<BR@>
@<FunnelWeb Reference Manual@>@<BR@>
@<FunnelWeb Developer Manual@>@<BR@>
@<End indent@>

@<P@>An alternative is to download all the manuals as an archive file
and install them on your disk so that you can access them quickly, without
going through the internet.

@<P@>
@<Manual download list@>

@<FunnelWeb subheading@>@(3. Work Through The Tutorial@)

@<P@>To get started with FunnelWeb, work through the tutorial
at the start of the

@<P@>
@<Begin indent@>
@<FunnelWeb Tutorial Manual@>@<BR@>
@<End indent@>

@<P@>Once you've done that, you should try using FunnelWeb
on a small project to get used to it. Then, once you're
comfortable with FunnelWeb, try using it on a production
project.

@<P@>If you want to see a real-world example, there is a
complete package written using FunnelWeb at:

@<P@>
@<Begin indent@>
@<URL@>@(@<FunnelWeb FTP@>examples/except/@)
@<End indent@>

@<P@>The package provides Ada-like exceptions for the
C programming language. Among other things, the package
demonstrates how FunnelWeb can be used to assist in the
documentation of tricky code.

@<FunnelWeb subheading@>@(4. Subscribe To The FunnelWeb Mailing List@)

@<P@>@<Spider_left IMAGE/right@>If
you like FunnelWeb, you can join the
@<FunnelWeb Mailing List@>. This is a low-traffic mailing
list so if
you're unsure, you should subscribe. If you're not on the
mailing list, you won't hear about new versions or other
happenings that might happen!

@<End FunnelWeb page@>
@}

@$@<Manual download list@>@M@{@-
@<Begin indent@>

@<Link@>@(@<FunnelWeb FTP@>funnelweb_v320/funnelweb_v320_manuals_d.hqx@,@-
FunnelWeb Manuals (Macintosh @<TT@>@(.hqx@) ~1.2M)@)@<BR@>

@<Link@>@(@<FunnelWeb FTP@>funnelweb_v320/funnelweb_v320_manuals_d.zip@,@-
FunnelWeb Manuals (Wintel @<TT@>@(.zip@) ~0.8M)@)@<BR@>

@<Link@>@(@<FunnelWeb FTP@>funnelweb_v320/funnelweb_v320_manuals_d.tar.Z@,@-
FunnelWeb Manuals (Unix @<TT@>@(.tar.Z@) ~0.8M)@)@<BR@>

@<Link@>@(@<FunnelWeb FTP@>funnelweb_v320/funnelweb_v320_manuals_d.tar.gz@,@-
FunnelWeb Manuals (Unix @<TT@>@(.tar.gz@) ~0.5M)@)@<BR@>

@<End indent@>
@}

@$@<Source download list@>@M@{@-
@<Begin indent@>

@<Link@>@(@<FunnelWeb FTP@>funnelweb_v320/funnelweb_v320_source.hqx@,@-
FunnelWeb Source Code (Macintosh @<TT@>@(.hqx@) ~0.7M)@)@<BR@>

@<Link@>@(@<FunnelWeb FTP@>funnelweb_v320/funnelweb_v320_source.zip@,@-
FunnelWeb Source Code (Wintel @<TT@>@(.zip@) ~0.6M)@)@<BR@>

@<Link@>@(@<FunnelWeb FTP@>funnelweb_v320/funnelweb_v320_source.tar.Z@,@-
FunnelWeb Source Code (Unix @<TT@>@(.tar.Z@) ~0.7M)@)@<BR@>

@<Link@>@(@<FunnelWeb FTP@>funnelweb_v320/funnelweb_v320_source.tar.gz@,@-
FunnelWeb Source Code (Unix @<TT@>@(.tar.gz@) ~0.3M)@)@<BR@>

@<End indent@>
@}

@$@<FWDownload@>@(@2@)@M@{@-
<A HREF="@<FunnelWeb FTP@>funnelweb_v320/@1">@2</A><BR>@}

@!******************************************************************************

@$@<FunnelWeb Manuals@>@M@{@<Link@>@(@<Manuals FILE@>@,FunnelWeb Manuals@)@}
@$@<Manuals FILE@>@Z@M@{manuals.shtml@}
@O@<manuals.shtml@>@{
@<Begin FunnelWeb page/manuals@>@(FunnelWeb Manuals@)

@<P@>FunnelWeb's documentation is organized into this
main FunnelWeb web plus three subwebs.

@<P@>To browse one of these webs in a new window, just click on its
hyperlink.

@<Begin indent@>

@<P@>@<Spider_up IMAGE/left@>@<B@>@(@<FunnelWeb Tutorial Manual@>:@)
This manual contains an introductory
tutorial to assist you in learning FunnelWeb. It also contains
a description of some application and some general hints on using
FunnelWeb.

@<P@>@<Spider_up IMAGE/left@>@<B@>@(@<FunnelWeb Reference Manual@>:@)
This manual contains a concise
definition of the entire functionality of FunnelWeb. Refer to this manual
when you have a specific question about FunnelWeb's features or if
you want to find out about FunnelWeb's more obscure features.

@<P@>@<Spider_up IMAGE/left@>@<B@>@(@<FunnelWeb Developer Manual@>:@)
This manual is for those who
want to obtain the FunnelWeb source code and compile their own
version of FunnelWeb. This manual contains compilation instructions
and a discussion of the licensing and language definition issues.

@<End indent@>

@<P@>You can also FTP an archive file of the webs and install them
on your local disk for high-speed offline browsing.

@<P@>
@<Manual download list@>

@<End FunnelWeb page@>
@}

@!******************************************************************************

@$@<Support FILE@>@Z@M@{support.shtml@}
@O@<support.shtml@>@{@-
@<Begin FunnelWeb page/support@>@(FunnelWeb Support@)

@<FunnelWeb subheading@>@(FunnelWeb Documentation@)

@<P@>In addition to this main FunnelWeb web, three
@<FunnelWeb Manuals@> are available online:

@<P@>
@<Begin indent@>
@<FunnelWeb Tutorial Manual@>@<BR@>
@<FunnelWeb Reference Manual@>@<BR@>
@<FunnelWeb Developer Manual@>@<BR@>
@<End indent@>

@<P@>You can search this web and these manuals by keyword by
visiting the @<Link@>@(@<FunnelWeb_search FILE@>@,search@)
page of this web. These manuals can be downloaded too. See
the @<FunnelWeb Manuals@> page for more information.

@<FunnelWeb subheading@>@(Mailing List@)

@<P@>Your next point of call after the manuals should be
the @<FunnelWeb Mailing List@> to which many FunnelWeb
users have subscribed. Post a message describing the
problem you've encountered and see if you get a reply.

@<FunnelWeb subheading@>@(Informal Support@)

@<P@>You are welcome to @<email me@> questions about
FunnelWeb, particularly about possible bugs. However, I can
make absolutely no guarantees about how quickly I can
respond to such questions as I receive a constant barrage of
email in relation to the webs I have created. You are more
likely to receive a response if you post a message to the
mailing list. I'm on the mailing list anyway!

@<FunnelWeb subheading@>@(Formal Support@)

@<P@>FunnelWeb is not commercial software and no formal
support @<DQ@>@(product@) is available. However, if for some
reason, you require high quality responsive
support, and are willing to pay for it, try emailing
@<Email@>@(@<Rocksoft support EMAIL@>@) quoting the URL
of this page and this paragraph, and perhaps they will be
able to help.

@<End FunnelWeb page@>
@}

@!******************************************************************************

@$@<FunnelWeb mailinglist EMAIL@>@M@{fw-users@@lists.internode.on.net@}
@$@<FunnelWeb majordomo EMAIL@>@M@{majordomo@@lists.internode.on.net@}
@$@<FunnelWeb mailinglist owner EMAIL@>@M@{owner-fw-users@@lists.internode.on.net@}
@$@<FunnelWeb majorcool WWW@>@M@{http://lists.internode.on.net/@}
@$@<FunnelWeb MAILINGLISTID@>@Z@M@{fw-users@}
@$@<FunnelWeb web EMAIL@>@Z@M@{@<Ross web EMAIL@>@}

@$@<FunnelWeb Mailing List@>@M@{@-
@<Link@>@(@<Mailing_list FILE@>@,FunnelWeb Mailing List@)@}

@$@<Mailing_list FILE@>@Z@M@{mailing_list.shtml@}
@O@<mailing_list.shtml@>@{@-
@<Begin FunnelWeb page/support@>@(FunnelWeb Mailing List@)

@<P@>@<Spider_left IMAGE/right@>The FunnelWeb Mailing List
carries announcements about FunnelWeb, and general
discussions about FunnelWeb by FunnelWeb users. The
FunnelWeb Mailing List is a fairly low traffic mailing list,
so if you want to be notified of new FunnelWeb developments,
don't be afraid to subscribe!

@<P@>
@<Begin indent@>
@<Begin border@>@(1@)
@<Begin table@>
@<Row2/bold@>@(Name@,FunnelWeb Mailing List@)
@<Row2/bold@>@(Address@,@<Email@>@(@<FunnelWeb mailinglist EMAIL@>@)@)
@<Row2/bold@>@(Majordomo@,@<Email@>@(@<FunnelWeb majordomo EMAIL@>@)@)
@<Row2/bold@>@(Human@,@<Email@>@(@<FunnelWeb mailinglist owner EMAIL@>@)@)
@<Row2/bold@>@(Web interface@,@<URL@>@(@<FunnelWeb majorcool WWW@>@)@)
@<End table@>
@<End border@>
@<End indent@>

@<P@>You can subscribe or unsubscribe using the Majordomo
email interface, the MajorCool web interface, or by filling
in the following form:

@<P@>
@<Begin form/action@>@(@<Mailing_list_modify CGIFILE@>@)
@<Begin table@>
@<Row2/bold@>@(Email:@,@<Form textfield@>@(@<Arg_Email@>@,30@)@)
@<End table@>
<BR>
<INPUT TYPE="submit" NAME="@<Arg_Action@>" VALUE="@<Action_Unsubscribe@>">
<INPUT TYPE="submit" NAME="@<Arg_Action@>" VALUE="@<Action_Subscribe@>">
@<End form/nosubmitbutton@>

@<P@>
@<Begin size3@>
@<Strong@>@(Note:@) All messages posted to the FunnelWeb mailing
list will be considered to be public postings that can be freely
copied, archived, forwarded, reposted and in other ways disseminated,
without permission having to be granted by the message's author.
@<End size3@>

@<IFCopy@>@(
@<Boldthing@>@(Note:@) This subscription web form is
@<Blink@>@(@<B@>@(UNAVAILABLE@)@) because it invokes PERL
scripts specific to the original web's webserver, and you
are currently browsing a @<B@>@(copy@) of the
original online web. If you wish to use this form, fvisit the
mailing list page in the
@<WindowLink@>@(@<FunnelWeb WWW/abs@>@,@-
@<FunnelWeb WINDOWNAME@>@,Official Online FunnelWeb Website@).
@)

@<End FunnelWeb page@>
@}

@$@<Arg_Email@>@M@{Email@}
@$@<Arg_Action@>@M@{Action@}
@$@<Action_Subscribe@>@M@{Subscribe@}
@$@<Action_Unsubscribe@>@M@{Unsubscribe@}

@!******************************************************************************

@$@<Mailing_list_modify CGIFILE@>@Z@M@{mailing_list_modify.cgi@}
@O@<mailing_list_modify.cgi@>@{@-
@<Begin www.ross.net CGI/PERL script@>

&form_parse_and_clean();
if ($form{'@<Arg_Email@>'} eq '')
  { &html_page('@<Mailing_list_modify_e_e HTFILE@>'); }
if ($form{'@<Arg_Action@>'} eq '')
  { &html_page('@<Mailing_list_modify_e_e HTFILE@>'); }

$email = $form{'@<Arg_Email@>'};
if (!&email_address_is_legal($email))
  { &html_page('@<Mailing_list_modify_e HTFILE@>'); }

$email_from = '@<FunnelWeb web EMAIL@>';
$email_to   = '@<FunnelWeb majordomo EMAIL@>';
$email_subj = 'FunnelWeb: Orders from the FunnelWeb web to Major Domo.';
$email_cc   = $email;
&email_open;
if ($form{'@<Arg_Action@>'} eq "@<Action_Unsubscribe@>")
  { &email_line("unsubscribe @<FunnelWeb MAILINGLISTID@> $email"); }
else
  { &email_line("subscribe @<FunnelWeb MAILINGLISTID@> $email"); }
&email_close;

&html_page("@<Mailing_list_modify HTFILE@>");

@<End www.ross.net CGI/PERL script@>
@}

@!==============================================================================

@$@<Mailing_list_modify HTFILE@>@M@{mailing_list_modify.txt@}
@O@<mailing_list_modify.txt@>@{
@<Begin FunnelWeb page/support@>@(Mailing List Request Forwarded@)

@<P@>Your mailing list request has been forwarded to the
MajorDomo mailing list server at
@<Email@>@(@<FunnelWeb majordomo EMAIL@>@),
with a copy sent to you. You should
receive a confirmation from the MajorDomo server by email
soon.

@<Back button@>@(Back to the mailing list page@)

@<End FunnelWeb page@>
@}

@!==============================================================================

@$@<Mailing_list_modify_e_e HTFILE@>@M@{mailing_list_modify_e_e.txt@}
@O@<mailing_list_modify_e_e.txt@>@{
@<Begin FunnelWeb page/support@>@(Error: A Field Is Empty@)

@<P@>A field in the form was left empty. Please return to the form,
fill in the missing field and try again.

@<Back button@>@(Back to the form@)

@<End FunnelWeb page@>
@}

@!==============================================================================

@$@<Mailing_list_modify_e HTFILE@>@M@{mailing_list_modify_e.txt@}
@O@<mailing_list_modify_e.txt@>@{
@<Begin FunnelWeb page/support@>@(Error: Email Address Has Incorrect Syntax@)

@<P@>The email address that you provided is not a legal email address. Please
return to the form and correct it.

@<P@>If you think that the address you have provided is legal, please email
the @<FunnelWeb Webmaster@>
so that this check can be loosened.

@<P@>
@<Back button@>@(Back to the form@)

@<End FunnelWeb page@>
@}

@!******************************************************************************

@$@<Links FILE@>@Z@M@{links.shtml@}
@O@<links.shtml@>@{@-
@<Begin FunnelWeb page/links@>@(FunnelWeb Links@)

@<FunnelWeb subheading@>@(FunnelWeb Variants@)

@<P@>@<Spider_up IMAGE/left@>@<Tony Coates@> has created a
@<Link/blank@>@(http://www.internetezy.com.au/~abcoates/funnelweb.html@,FunnelWeb variant@)
called FunnelWeb V3.05AC (a variant of FunnelWeb V3.0  - an
earlier version) that provides some extra useful features.
As this is an unofficial version, it's features are not
guaranteed to appear in future official versions of
FunnelWeb.

@<FunnelWeb subheading@>@(Newsgroups@)

@<P@>@<Newsgroup@>@(comp.programming.literate@) - This is the
newsgroup for Literate Programming. It carried quite a bit of
traffic in the early 1990s, but (as at 1999) traffic appears
to be very low.

@<P@>@<Newsgroup@>@(comp.doc@) A newsgroup about documentation.
Again, a very low traffic group.

@<FunnelWeb subheading@>@(Literate Programming Links@)

@<P@>@<Link/blank@>@(http://www.cs.cmu.edu/Groups/AI/html/faqs/lang/lit_prog/faq.html@,@-
The Literate Programming FAQ@) - I think this was the FAQ that was used in
@<Newsgroup@>@(comp.programming.literate@). This FAQ contains what appears to
be a comprehensive list of literate programming tools.

@<P@>@<Link/blank@>@(http://liinwww.ira.uka.de/bibliography/SE/litprog.html@,@-
A Bibliography of Literate Programming@) - A searchable bibliography.

@<P@>@<URL/http@>@(www.literateprogramming.com/home.html@) - Anyone who's bothered
to register a domain called this deserves a link!

@<P@>@<Link/blank@>@(http://www.webring.org/cgi-bin/webring?ring=litprog;list@,@-
The Literate Programming WebRing@) - A collection of literate programming webs
organized into a ring.

@<P@>@<Link/blank@>@(http://dir.yahoo.com/Computers_and_Internet/Programming_Languages/Literate_Programming/@,@-
The Yahoo Literate Programming Page@).

@<P@>@<Link/blank@>@(http://www.ems.uq.edu.au/Seminars/XML_LitProg/@,@-
XML and Literate Programming@)

@<FunnelWeb subheading@>@(Other Literate Programming Tools@)

@<P@>@<Link/blank@>@(http://www.cs.virginia.edu/~nr/noweb/@,NoWeb Home Page@) - A
minimalist literate programming tool.

@<P@>@<Link/blank@>@(http://www.mailbag.com/users/edream/front.html@,@-
The LEO Outlining Literate Programming Tool For Macintosh@) - Sounds
interesting (but I haven't looked at it yet).

@<P@>There are lots of other tools out there too.

@<FunnelWeb subheading@>@(Literate Programming People@)

@<P@>@<Donald Knuth@> - The inventor of literate programming.

@<P@>@<Ross Williams@> - The creator of FunnelWeb.

@<P@>@<Tony Coates@> - Creator of a variant of FunnelWeb (see above).

@<P@>The page
@<URL/http@>@(www.literateprogramming.com/links.html@)
contains a comprehensive-looking list of people involved
with literate programming.

@<FunnelWeb subheading@>@(Books And Papers@)

@<P@>Knuth@<_@>D.E., @<DQ@>@(The WEB System
of Structured Documentation@), (Web User Manual,
Version@<_@>2.5, November, 1983), Stanford University, 1983.

@<P@>Knuth@<_@>D.E., @<DQ@>@(The TeXbook@),
Addison-Wesley, (ISBN: 0-201-13448-9), 1984.

@<P@>Knuth@<_@>D.E., @<DQ@>@(Literate
Programming@), @<I@>@(The Computer Journal@), Vol.@<_@>27,
No.@<_@>2, pp.@<_@>97-111, 1984. (Reference copied
from SIGPLAN 26(1) p.16). Note: The author of this manual
has not yet obtained this paper.

@<P@>Knuth@<_@>D.E.,
Literate Programming,
CSLI, 1992, @<Link/blank@>@(http://www.amazon.com/exec/obidos/ASIN/0937073806/@,ISBN: 0-9370-7380-6@).

@<P@>Smith@<_@>L.M.C., @<DQ@>@(An Annotated
Bibliography of Literate Programming@), ACM SIGPLAN Notices,
Vol.@<_@>26, No.@<_@>1, January 1991.

@<End FunnelWeb page@>
@}

@!******************************************************************************
@!******************************************************************************

@$@<Copyright FILE@>@M@{copyright.shtml@}
@O@<copyright.shtml@>@{@-
@<Begin FunnelWeb page/home@>@(Copyright and Credits@)

@<FunnelWeb webs copyright page contents@>

@<End FunnelWeb page@>
@}

@!******************************************************************************

@O@<linktome.shtml@>@{@-
@<Begin FunnelWeb page/links@>@(Links To This Web@)

@<P@>Here's how you can link to this web:

@<FunnelWeb subheading@>@(Icon And Text@)

@<P@>If you want to create a graphical link, you can use the
FunnelWeb 32x64 logo:

@<P@><A HREF="@<FunnelWeb WWW@>">
<IMG SRC="@<Bin@>linklogo.gif"
 ALT="[FunnelWeb Logo]"
 HSPACE="5"  VSPACE="5"
 HEIGHT="32" WIDTH="64"
 BORDER="0" ALIGN="absmiddle">FunnelWeb</A>

@<P@>To do this, simply copy the image file

@<Begin indent@>
@<URL@>@(@<FunnelWeb WWW/abs@>@<BinName@>/linklogo.gif@)
@<End indent@>

@<P@>into your web and then copy the following HTML code.

@<P@>
@<Begin verbatim/size3@>
   &lt;A HREF="@<FunnelWeb WWW/abs@>"&gt;
   &lt;IMG SRC="linklogo.gif"
    ALT="[FunnelWeb Logo]"
    HSPACE="5"  VSPACE="5"
    HEIGHT="32" WIDTH="64"
    BORDER="0"
    ALIGN="absmiddle"&gt;FunnelWeb&lt;/A&gt;
@<End verbatim/size3@>

@<FunnelWeb subheading@>@(Text Only@)

@<P@>To add a straightforward link such as
@<FunnelWeb@>
simply cut and paste the following HTML code:

@<P@>
@<Begin size3@>
@<Begin verbatim@>
     &lt;A HREF="@<FunnelWeb WWW/abs@>">FunnelWeb&lt;/A>
@<End verbatim@>
@<End size3@>

@<FunnelWeb subheading@>@(URL Stability@)

@<P@>As these pages may be revised from time to time, it is not guaranteed
that any particular page will have the same name from month to month,
or even that it will persist. So if you want to link to these pages,
it would be best to link to @<URL@>@(@<FunnelWeb WWW/abs@>@) as this
is likely to be this web's most persistent URL.

@<End FunnelWeb page@>
@}

@!******************************************************************************

@B@<Search Form Section@>

The files in this section are all linked in with the FunnelWeb
include file.

@O@<search.html@>@{@-
@<Begin FunnelWeb page/search@>@(Search FunnelWeb Documentation@)

@<FunnelWeb search form@>@(checked@,@,@,@)

@<End FunnelWeb page@>
@}

@!==============================================================================

@O@<search_form.cgi@>@{@-
@<FunnelWeb search CGICODE@>
@}

@!==============================================================================

@O@<search_head.txt@>@{@-
@<Begin FunnelWeb page/search@>@(Search Results@)
@<P@>
@}

@!==============================================================================

@O@<search_tail.txt@>@{@-
@<BR@>
@<P@>@<Back button@>@(Back To The Search Form@)
@<BR@>

@<End FunnelWeb page@>
@}

@!==============================================================================

@O@<search_e_nokeywords.txt@>@{@-
@<Begin FunnelWeb page/search@>@(Error: No Keywords Specified@)

@<P@>You must specify one or more keywords to perform a search.

@<P@>@<Back button@>@(Back To The Search Form@)

@<End FunnelWeb page@>
@}

@!==============================================================================

@O@<search_e_nomanual.txt@>@{@-
@<Begin FunnelWeb page/search@>@(Error: No Manual Selected@)

@<P@>You must specify one or more manuals (using the checkboxes) to
perform a search.

@<P@>@<Back button@>@(Back To The Search Form@)

@<End FunnelWeb page@>
@}

@!******************************************************************************

@$@<Sidebar CGIFILE@>@M@{sidebar.cgi@}
@O@<sidebar.cgi@>@{@-
@<Begin www.ross.net CGI/PERL script@>

# The content header is required even for Server Side Includes.
&html_write_standard_content_header;

# Read in the quotes file.
@@quotes = &file_read_paragraphs("@<Quotes FILE@>");

# Print a random quote.
$quoteno = &random_0_nmo(scalar @@quotes);
print "@@quotes[$quoteno]\n";

@<End www.ross.net CGI/PERL script@>
@}

@!==============================================================================

@$@<Dynamic sidebar note@>@Z@M@{
<CENTER>
<TABLE WIDTH="100" BORDER="0">
@<Row1@>@(
@<Begin size2@>
@<Red_pin IMAGE/left@>
<!--#exec cgi="@<Sidebar CGIFILE@>" -->
@<End size2@>
@)
@<End table@>
</CENTER>
@}

@!==============================================================================

@$@<Quotes FILE@>@{quotes.txt@}
@O@<quotes.txt@>@{@-

FunnelWeb can generate TeX and HTML documentation.

FunnelWeb is available free of charge under a GNU licence.

FunnelWeb is available for many different platforms.

FunnelWeb is a language-independent literate programming tool.

"I've been fooling around with FunnelWeb for about three days now, and
I'm convinced that this is one of the most powerful tools I have
encountered in almost two decades of programming" -- Jerry Callen, 1992.

"FunnelWeb forced me to reorganise the code a bit, to get my concepts
straight. By the time I did this, and documented what I was doing, ...
It looked good, and worked in a few passes." -- John Skaller, 1992.

"I use FunnelWeb for everything from my FutureBASIC programming to
maintaining my web pages. It is a cool tool, and one of the few
literate programming environments that are (1) language-independent
and (2) available on the Mac. I couldn't be more pleased with it."
-- Ron Hale-Evans, 1996.

"Let me say that FunnelWeb is the most impressive
literate programming tool I have yet seen.  The language
is powerful, the tutorial manual excellent, and I really
love the new weave facility to output both TeX and HTML."
-- Paul Wanis, 1999.

Join the @<FunnelWeb Mailing List@>!

FunnelWeb is free of charge. It's distributed under a GNU licence.

Write your open source software using
FunnelWeb and use it to publish your source code on the web!

"@<B@>@(F@) is for Funnel-web,
Our furry-legged foe.
He sleeps in your slipper,
And breakfasts on toe."
---  Dame Edna Everage, 1991.

Use FunnelWeb's +D argument to suppress
unnecessary Make cascades.

FunnelWeb was created in 1986 before the World Wide
Web was created, but has proven be an excellent
tool for creating webs!

@}

@!******************************************************************************

@O@<protect.cgi@>@{@-
@<Begin www.ross.net CGI/PERL script@>

require('lib_protect.pl');

&protect_dir_binary('.',0755);
&protect_dir_binary('./reference',0755);
&protect_dir_binary('./tutorial',0755);
&protect_dir_binary('./developer',0755);
&protect_page;

@<End www.ross.net CGI/PERL script@>
@}

@!******************************************************************************

@O@<0cleanup.vxf@>@{@-
eneo *.html
eneo *.shtml
eneo *.cgi
eneo *.txt
eneo *.lis
eneo *.pl
@}

@O@<0cleanup_all.vxf@>@{@-
eneo *.html
eneo *.shtml
eneo *.cgi
eneo *.txt
eneo *.lis
eneo *.pl

eneo :developer:*.html
eneo :developer:*.shtml
eneo :developer:*.cgi
eneo :developer:*.txt
eneo :developer:*.lis
eneo :developer:*.pl

eneo :reference:*.html
eneo :reference:*.shtml
eneo :reference:*.cgi
eneo :reference:*.txt
eneo :reference:*.lis
eneo :reference:*.pl

eneo :tutorial:*.html
eneo :tutorial:*.shtml
eneo :tutorial:*.cgi
eneo :tutorial:*.txt
eneo :tutorial:*.lis
eneo :tutorial:*.pl

@}

@!******************************************************************************

@! Include the FunnelWeb webs master include file.
@i 0fw_inc.fwi
@i 0www_style.fwi
@i 0www_links.fwi
@i 0www_ross.fwi

@!******************************************************************************
@!******************************************************************************