Versions log for StrawHelp
==========================

StrongHelp file viewer, by Rick Murray
http://www.heyrick.co.uk/software/strawhelp/


0.06  2015/03/17

      No functional changes. StrawHelp is now open source under the
      EUPL (v1.1 only).



0.05  2009/12/28

      Changed "merseymail" email reference to the current address.

      Added shim to let the AVR manual load without giving warnings of
      the root directory being in an unexpected place. It is not
      "illegal", just pretty unusual...

      If #Draw <...> is encountered, then
        [ Drawfile illustration ]
      will be inserted into the output. There is no support for the
      rendering of Drawfiles, nor is any support planned.
      Likewise, if #Sprite <...> is encountered, then
        [ Bitmap illustration ]
      will be inserted into the output. There is no support for the
      conversion and display of Sprites, nor is any support planned.



0.04  2009/10/31

      Manky hack because the MSIE8 double-entry behaviour would cause
      *two* identical entries to be written to the view history. Now
      if the item to be added is identical to that which was last
      stored, the current is discarded. So it looks and feels pretty
      much like it did prior to MSIE8.
      [dontcha just love Microsoft? I wonder what else this little
       change broke...]



0.03  2009/07/27

      Fixed StrawHelp to work with MSIE8. MSIE8 tries to be clever,
      and after receiving data for the "strawhelp:" URIs, will report
      that the URI is not known (only the "friendly error" does not
      make this clear), so THIS is trapped and the request repeated.
      This means StrawHelp does the same thing twice for MSIE8 to be
      sated, and it also explains the "double-clicking" sound...



0.02  2008/04/26

      If there are more than 28 manuals (this is how many will fit in
      the display area *without* scroll bars, if each has less than
      ten characters in the filename (a la RISC OS)), then the
      manual selection display will switch to using the 'small icon'
      form. This is very similar to how StrongHelp itself presents
      the available manuals.

      You can switch between big icon display and small icon display
      (in the manual selection window) by RIGHT clicking.

      No longer makes the basic beep 'clang' noise when you open a
      manual. This was only supposed to occur (and now does) if you
      double-click without a manual having been selected; i.e. if you
      double-click on a blank area of the list.

      The command parser now outputs comments describing what has
      been read. The results ought to be fairly self-evident from the
      HTML generated. This should help in debugging commands that did
      not work as expected (some manuals appear to set a text style
      which is never unset, I'd be inclined to blame the parser at
      this early stage...).

      Left aligned sections now specify justification desired.

      fStd and fCode reduced to 12pt (the standard 14pt looked too
      big in MSIE).

      Now loads the default RISC OS colour set, and will now support
      the use of #Background to set up either an absolute (RGB)
      colour, or one of the WIMP colours.
      Is Windows XP kinda light, or is RISC OS kinda dark? I was
      surprised at how dark WIMP colour 1 was, but all of the colours
      were pulled directly out of the RISC OS 3.70 palette (using the
      Wimp_ReadPalette SWI!).

      It's probably a moot point anyway, if StrawHelp sees you want
      #Background Wimp 1 then it will set the default background
      *colour* to a light grey, and then set the background *image*
      to be "tile.jpeg", which is a slightly lighter version of the
      tile effect that I have on my RiscPC (the proper version was
      too dark when against the crappy Windows text rendering).

      If no background was ever defined, StrawHelp will 'assume' the
      same as #Background Wimp 1 - icluding switching on tiling.

      This background stuff, incidentally, gets rid of the stupid
      'bgcolor="EEEEEE"=black' in the HTML file (who forget the text
      colour attribute? :-) ).

      Various messages reworded to use the syntax of "file" to refer
      to an individual help document loaded from the "manual" (which
      is the complete image file). Thus, when it is talking of files
      it is talking of actions upon stuff within the manual, and when
      it is talking of manuals it is talking of the complete thing.

      Widened the manuals window a tiny amount so there is no need
      for a horizontal scroll bar when there are lots of manuals...

      Now supports *simple* /effects/ where the author just uses a
      star, a slash, or an underline. The logic is that one of the
      characters on either side must be an alphanumeric, however they
      cannot both be and they cannot both not be. This means that
      something *highlighted* will be treated correctly, while some
      text/words with a slash in them won't be 'eaten'.

      #Subpage is now handled as HTML #links, so clicking a sub-page
      link will now take you directly to that specific part. There
      are additional 'Return to top' links to take you back to the
      main content.

      There is a new command button "Main page", which will take you
      back to the main page as it is when the manual is first opened.
      This does *NOT* destroy your page history, so you can flip
      around quite easily.
      [note that this button is auto-disabled if you are actually
      looking at the manual's main page...]

      The button "Go to help index" now reads "Manuals index".
      
      A "Go to index" button added, will return you to the manual's
      opening page (but won't destroy your page history in doing so).

      Yucky hack to support #Include as too many pages require this.
      It only works to ONE level, any #Include commands while doing
      a #Include will be ignored (with a message). There is one other
      caveat - you cannot use #Include to define a 'style' for your
      manual, as StrawHelp won't scan that deep looking for style
      definitions. Maybe in a later release...

      Now correctly handles font-reset followed by other commands,
      such as "#f;Indent".



0.01  2008/04/25

      Updated my manual sets from the sudden.recoil.org site.

      The "INetDrafts" manual failed to load; turns out that it has
      a simple directory structure containing many pages, and/or many
      subdirectories, which required more than 32K to express the
      directory entries. Obviously >32K into a signed integer value
      will go "bang". Thankfully it was a very simple problem to fix!



0.00  2008/04/21

      First release version. Incomplete in many ways, but is fully
      able to view help files... if you don't mind them looking 'odd'
      at times.

      Tested mainly with the VDU codes manual and OS manual v3.20.
