All those references to Sun documentation are generated by a Java
macro, so all I would have to do is add some lines to it.  However,
instead I decided to put a link to the J: drive entry at the bottom of
page where there is a link to the local mirror of the page.

I have a sort of poor man's JSP where I statically regenerate the
pages, and upload them, using compaction and untouch to avoid
reuploading ones that have not really changed.

The key to understanding is that I don't have a webserver.  I have to
do everything statically. At some point I will try to package this up
for everyone to use.  It a bit too tough for novices, and most experts
will go with JSP.  I wanted to polish off the burrs before inflicting
it on others.

You can get some hints looking at the source.  You will see embedded
macros like this for example:

<!-- macro CurrCon c$AN USD 10.00 -->

That generates an applet invocation that will display 10.00 in many
different currencise, by default the user's home currency.

<!-- macro Sun "more than you wanted to know about JButtons"
api/javax/swing/JButton -->

Will generate links to the online Sun doc, the docs in the local J:
production JDK and the beta JDK.

<!-- macro Book generates a boof referal complete with book cover and
links to six bookstores.

<!-- macro JDK xxx --> generates a variety of ways of referrnig to the
lastest JDK.

<!-- macro Quilt generates multicolumn sorted lists, such as the index
at http://mindprod.com/jgloss/errormesages.html#INDEX. That one I
wrote expressly for you.

Here is a list of macros I have written so far:

AmanuensisHead.java     header for an Amanunesis Applet
BestBrowsers.java       list of recommeded browsers
BglossHead.java         Buyer glossary header
Book.java               book referral
ColourMenu.java         menu to select colour palette
CurrCon.java            currency conversion
Foot.java               Footer
GglossHead.java         Gay glossary header
HansHead.java           HANS header
HansPractHead.java      HANS Practioner header
HtmlMacros.java         HtmlMacros main Java program source
ImageInfo.java          Gets info about an image
Include.java            Include unmodified
JDisplay.java           display Java, BAT, HTML source prettified
JDK.java                current JDK in various formats
JglossHead.java         Java glossary header
JRE.java                current JRE in various formats
LaserHead.java          Header for laser talks
LL.java                 Living love database entry
Macro.java              Interface all macros implement
Moved.java              document moved
ParmParser.java         HtmlMacros main Java program source
Picture.java            Generate reference to image calc size
Quilt.java              list sorted in columns
PriceList.java          Generates Products downloads pages
RandomLink.java         randomly chosen link
Replacer.java           engine to invoke macros
Reunion.java            reunion data base entry
run.bat                 execute the HtmlMacros application
Signed.java             notes on Signed Applet
Sun.java                ref to Sun docs
Tools.java              Tools for macros to use

There there is a tool I call QF (quick find??) to find all the <dt>
entries and build the letter and master indexes.

The compactor takes out the unnecessary whitespace.
Untouch dates files back that have not really changed.
the Replicator uploads just what has changed in zipped form and
automadically downloads to a mirror just what has changed.

I have another tool I wrote called MissingSee that finds unlinked
words inside <div class="see"> ...</div> and turns them into links, if
it can find an approximate match.  It also sorts the links at the
bottom of each page into alphabetical order. It also detects some
common errors I make like linking with text ending in .html.

Xenu finds broken links.

hTMLValidator finds HTML syntax errors.

Here is the code for your Quilt Macro:

---------------------------------------------

package com.mindprod.htmlmacros;
import java.io.File;
import java.util.Arrays;

import com.mindprod.comparators.HTMLComparator;

/**
* Generate the for grid of values like a quilt, with the entries
sorted by columns.
*
* @author Roedy Green
*/
public class Quilt implements Macro
  {

  /**
   * sample macro invocation:
   * <!-- macro Quilt 5 sort {bird} {ca<b>t</b>} {<a
href="abc.html">rabbit</a>} -->
   * 5 = number of columns.  sort/asis.
   * Generate the html for a grid of values, possibly containing HTM?
   * @param parms      * @param fileBeingProcessed File being
processed.
   */
  public String expand ( String[] parms, File fileBeingProcessed )
     {

     System.out.print("Q");
     if ( parms.length < 3 )
        {
        throw new IllegalArgumentException("Quilt needs size, sorted
the {value} {value} ..." );
        }

     int cols  = Integer.parseInt( parms[0] );
     String type = parms[1];
     boolean sort;
     if ( type.equalsIgnoreCase("sort" ) )
        {
        sort = true;
        }
     else if ( type.equalsIgnoreCase( "asis" ) )
        {
        sort = false;
        }
     else throw new IllegalArgumentException ( "Quilt needs either
sort or asis.");
     String[] cells = new String[ parms.length - 2 ];

     for ( int i=0; i<cells.length; i++ )
        {
        cells[i] = parms[i+2];
        }
     if ( sort )
        {
        Arrays.sort( cells, new HTMLComparator() );
        }
     return expand(  cols,  cells );

     }
  /**
   * guts to Generate the table for a quilt
   *
   * @param cols   how many columns to generate.
   * @param cells  cells to render
   *
   * @return expanded explanation
   */
  public String expand ( int cols, String[] cells )
     {
     // calc covered quotient
     int rows = ( cells.length + cols - 1) / cols;

     // account for space taken by html tags, a bit of anally
retentive coding.
     int size = "\n<table class=\"gridmenu\">\n</table>\n".length()
      + ( "<tr></tr>\n".length() * rows )
      + ( "<td></th>\n".length() * rows * cols )
      + ( "&nbsp;".length() * ( rows * cols - cells.length ) );

     // account for contents
     for ( int k=0; k<cells.length; k++ )
        {
        size += cells[k].length();
        }
     StringBuffer sb = new StringBuffer( size );
     sb.append ( "\n<table class=\"gridmenu\">\n" );
     for ( int i=0; i<rows; i++ )
        {
        sb.append("<tr>");

        for ( int j=0; j<cols; j++ )
           {
           sb.append("<td>");
           int k = j * rows + i;
           if ( k < cells.length )
              {
              sb.append( cells[k] );
              }
           else
              {
              sb.append( "&nbsp;" );
              }
           sb.append("</td>\n");
           }
        sb.append("</tr>\n");

        }
     sb.append("</table>\n");
     return sb.toString();
  }
  }