*** Readme11 -- Release notes for HtX 1.1 ***

Along with its support of frames, HtX 1.1 introduces a new feature:  the image path

The image path functions like the Unix/DOS PATH variable by providing a set
of alternative directory paths for locating images (and in fact any other
auxiliary material).  At translation time, the HtX processor searches for
the given file, and inserts the appropriate URL in the HTML translation.
This way, an author may assert several image repositories (e.g. global,
project, personal), and refer to image files by name alone, without further
specification of their URLs.

How it works:

1. Specify a local image path (lpath) using the \setlpath argument:

       \setlpath{.;icons;../icons;/usr/local/www/icons} (Unix)
       \setlpath{.;icons;..|\|icons;C:|\|icons;C:|\|www|\|icons} (DOS)

   Note these consist of semi-colon separated local paths (and in DOS the
   "backslash" must appear as |\|).

   The variable \thelpath contains the current lpath.  You can extend a
   given path by using \thelpath in \setlpath:

       \setlpath{/usr/local/www/icons}
       \setlpath{.;icons;\thelpath}

   This way, global path entries can be specified in the local.htx and
   extended in the user's environment.

2. Similarly, you can optionally specify the URL image path (upath) using
   \setupath.  The URL path is the sequence of URL equivalents of the local
   path enries.  Variable \theupath is similarly available.

	\setlpath{.;../icons;/usr/local/www/icons}
	\setupath{.;../icons;http://www.foobar.edu/icons}

   In the first 2 cases, the relative paths serve as valid URLs, while in
   the last case a complete URL must be substituted for the absolute path.
   Alternatively, an underscore serves as a "ditto", indicating that the
   local path and URL are the same:

	\setupath{_;_;http://www.foobar.edu/icons}

   HtX inserts the URL rather than the local path in creating a fully
   qualified image reference.  If a URL equivalent is not specified
   (i.e. the upath is not given, or is too short), the local path is used.

3. Now, when specifying an image, use \lupath{fname}, as in

        \image{\lupath{header.gif}}

   HtX will search for header.gif in each of the local directories
   specified in the lpath.  If found, the URL equivalent (if defined) or
   local path (if not) is used to form a fully qualified URL.

Examples:

   Assuming the paths specified in (2), 

      (a) If header.gif is contained ../icons, then \lpath{header.gif}
          expands into ../icons/header.gif 

      (b) If header.gif is contained in /usr/local/www/icons, then
          \lpath{header.gif} expands into http://www.foobar.edu/icons/header.gif