
This is patch5 for Wafe 0.96.  

It contains:

   - All changes included in patch 1 to patch 4
     (see wafe-0.96.p1.README, wafe-0.96.p2.README,
      wafe-0.96.p3.README and wafe-0.96.p4.README)


   - based on tcl 7.2 (instead of 7.0)


   - new version of libhtmlw based on XMosaic-2.0 
     (no prerelease anymore!)

     The new version of the XMosaic hypertext widget 
     has a few bugs fixed, it should be more portable, 
     it should have some speed improvements. Also, the picture
     cache within wafe has two bugs fixed (that could cause
     segmentation violations when multiple html widgets using 
     different pictures were used). 

     In order to step through the example set of html forms 
     issue the following command:

         1) cd wafe/src/tcl
         2) ./htmlBrowse html/example-1.html

     By using the command above one can examine 12 examples when you 
     click on the hypertext links at the bottom of the forms.
     These examples are straight from ncsa, the text might not always
     be appropriate.

     The example usage above assumes that you are using the
     Athena version (wafe). If you want to use the OSF/Motif version
     of Wafe (mofe) instead, you can issue

        2) ../mofe --f ./htmlBrowse html/example-1.html

     The HTML widget is a patched version of XMosaic's hypertext
     that can be used under both OSF/Motif and Athena. The developer
     of XMosaic support currently on the OSF/Motif version. If someone
     is interested in the diffs between the original version of
     the HTML widget and the version distributed with Wafe can
     look at:

     ftp.wu-wien.ac.at:pub/src/X11/wafe/libhtmlw2.0-athena.tar.gz

     The Athena version of the HyperText widget does currently not 
     support multiple selections in a selection list, since the the 
     Athena List widget supports only single selections.

     
   - some cosmetical changes in wafe/apps/Monitoring
     to make its appearance nicer


   - new sample script 
          wafe/tcl/m-htmlForm
     to show usage of html forms under OSF/MOTIF


   - output converter for mofe for resources of the class
     verticalPosition and horizontalPosition


   - new general available command:

         getApplicationResource <baseWidget> <resourceName> <resourceClass>
  
     which can be used to read user specific resources. Consider the
     following example:
  
         mergeResources topLevel *xx green
      
     sets for resource xx the value green. This value (or a value
     set by a resource file or with the -xrm command line option)
     can be retrieved by the command
  
         getApplicationResource topLevel xx String
         #R: {green}
  
     if a resouce of the <resourceName> "xx" is found under
     topLevel, its string value is returned (regardless of
     widgetClass). If it is not found, a second attempt is performed
     to get a resource value for the <resourceClass>. For example:
      
         mergeResources topLevel *Xx red
         getApplicationResource topLevel xx Xx
         #R: {green}
         getApplicationResource topLevel xy Xx
         #R: {red}

     Here Xx is the resource class; in accordance with the Xt
     manual, the name should be capitalized.

     One can use this mechanism for example to specify via resource
     mechanisms Background as defaultBackground (resource Class) and
     mySpecificBackground as a more specific one:

      --------.Xdefaults --------
      myApp*Background: green
      myApp*popupShell*mySpecificBackground: pink
      ----------
  
      and a widget tree structure like

         command c1 topLevel
         transientShell popupShell topLevel
             command c2 popupShell

      the following values will be returned:

         getApplicationResource c1 mySpecificBackground Background
         #R: {green}

         getApplicationResource c2 mySpecificBackground Background
         #R: {pink}

      In to first case the default value is returned, in the
      second the specified more specific value.


  -  README.solaris file for user with Solaris 2.x with broken xmkmf
     (Supplied by Peter Ludemann <peter.ludemann@imi.kdsi.com> Many
     thanks again to Peter!)
 

To apply this patch, "cd" to the wafe 0.96 directory, expand the
tar file, and do a "rm -f ../libhtmlw/*.a src/htmlwGen.o; make". 

Please note that in cases where you have 0.96 not installed,
you should 
   a) first get the wafe 0.96 distribution, expand the tar file, 
      expand the wafeapps.tar.gz tar file as indicated in wafe/INSTALL, and
   b) expand this update 'over' the 0.96 distribution, and follow then
      the instructions in wafe/INSTALL

-gustaf
