NEWS
====

This file is of no use for new users of hsc and just describes the
in-combat-ibilities of this release to the previous one. For a 
complete list of improvements and bug-fixes, refer to `CHANGES'.

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

Version 0.917

- This is the last release of hsc. Probably there still will be a
  couple of bugfix releases, but no further enhancements are planned.

- There is finally a somewhat more official release of the RiscOS
  port with a new support page (still done by the same people) at
  `http://www.alphawave.ltd.uk/sergio/hsc.html'.

- When validating URIs the corresponding filenames are "optimized".
  That means useless parent directories in the middle of the filename
  are stripped. This fixes a bug and also results in more legible
  message texts.

  The only problem is that this optimization fails on AmigaOS if you
  use paths with ".." for parent directory and a system patch (e.g.
  `DosWedge' or `ixpath') to make the filesystem support it. Use the
  AmigaOS/ixemul version of hsc if this is a problem for you.

- Comparing two URIs using the `=' operator now works again, even with
  project relative URIs. This was an unintentional feature of version
  0.915 I was not aware of, and accidentally it was gone in 0.916.

- The CLI option MODE has been renamed to MSGMODE

- Some special values for IGNORE and ENABLE have changed:
  BADSTYLE -> STYLE
  JERKS    -> JERK
  NOTES    -> NOTE

- The CLI option MSGANSI has been removed. Use MSGBROWSER=ANSI
  instead.

- The CLI option SMARTENT has been removed. It was too inconsistent.

- Due lack of interest, `dtd2hsc.rexx' and the resulting
  `hsc-html-40.prefs' have been removed.

- The list of messages has moved from `docs/messages.html' to
  `docs/message-list.html'.

- Those who never really could figure out how to use all these
  message options like IGNORE and ENABLE might want to read
  `docs/messages.html' again as it explains some details that
  weren't there in previous versions of the manual.

- The undocumented arithmetic `+' operator does no more work as the
  autodetection  wheter to use string concatenation or arithmetic
  addition did not work in some expression. Use `&' for arithmetic
  addition (which is still undocumented, of course).

- There are some maybe useful features that (because of good reason)
  never made it into the official documentation described in
  `docs/undocumented.html'.

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

Version 0.916

- Hsc does no more create a new project file if you specify a
  non-existent one with the CLI-option PRJFILE. Instead, you will have
  to create it using "hscpitt new" before.

  If you are not already familiar with hscpitt, maybe you will want to
  give a short look to `docs/project/index.html', because it now
  contains a short sort-of tutorial to the basic commands of hscpitt
  and hscdepp.

- There is no more `hsc-all.lha', but only a `hsc-source.lha' that now
  also contains the documentation, and therefore the same contents as
  `hsc-all.lha' in earlier versions.

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

Version 0.915

- For those who need to compile everything on there own: the whole
  process has changed a bit, the Makefile should now be easier to
  handle. Compiling is no more described in `source/README', but in
  `docs/source.html'.

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

Version 0.914

- The `examples' drawer is back again.

- The documentation now tells a bit more about `make'; If this still
  does not help to prevent new users from sending me bullshit-emails
  with extraordinary silly questions, I might consider removing the
  introductory material completely...

- The term `absolute URI' is now used for external URIs; the manual
  now referres to `project relative URIs' instead to avoid confusion
  as this term is normally used to refer to external URIs...clear?
  Better give "docs/features/uris.html" a glimpse...

- If you compile this yourself and perform a `make test' afterwards,
  some calls to hsc will exit with an error return code. This is
  because some test sources now contain corrupt data. These will not
  create a html document, bug only a message file which will be
  analysed for differences just like before. The `diff' program still
  should not report any mismatches, of course.

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

Version 0.913

This isn't really a nasty update, but:

- Container macros are now implemented in a cleaner way. However,
  old-style containers still work, and currently there is no need to
  remove this code. Although old-style is not documented any more.

  Anyway, instead of

    <$macro FILE><I><$macro>
    <$macro /FILE></I><$macro>

  you should now use

    <$macro FILE /CLOSE><I><$content></I><$macro>

  when creating new macros.

- to check existence of files, there are now two functions: Exists()
  works on URIs, and fExists() on files relative to the source
  directory

- collected some material from `graffelwerk' and `example' and put it
  into `starter-project', which should now contain a reasonable
  template to start with a new project.

- the hsc-sources for the docs are now located in the source-archive

- hscpalthrow introduces the first tool of the hsc-package *not*
  named after a male actor, but a female one. Therefor, certain
  homo-erotic aspects of this package will probably vanish.

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

Version 0.912

- "hsc.prefs" has be changed so that <HTML>, <HEAD> and <BODY> are
  no more required, but only recommended within a document.

- The Makefile for the source archive now supports library managers
  like `ar' and `oml'
