TITLE

  hsc - html sucks completely

VERSION 

  0.917

AUTHOR

  Thomas Aglassinger <agi@giga.or.at>

DESCRIPTION

  Hsc is a developer tool for html-projects.

  It can be used on any html file and creates a new html file as
  output. In the input file, you may use an extended syntax based on
  html, but which also allows extensions like macros, conditionals and
  more.

  It's mainly intended to create and maintain larger html projects. As
  a CLI-only tool, it can be used together with `make', and a
  dependency generator is included.

  Hsc is *not* a tool to make html easier for beginners; it's a tool
  to make html a bit less painful and brain-damaged for people who
  already know how to work with it.

FEATURES

  - macros (implemented as additional tags)
  - conditionals (if/else/elseif)
  - expressions, supporting
    - string concatenation and comparison
    - import of environment variables
    - current time
    - size of files
  - special tags to
    - include files (also verbatim text)
    - execute shell commands (and include output)
    - comment in a reasonable way
  - for local links, checks if file/id exists
  - project relative URIs
  - replaces special characters by entities
  - evaluates attributes for image size (PNG/jfif/gif)
  - can strip useless white space, comments and tags
  - replaces icon entities by images
  - performs a basic syntax- and structure check
  - error messages are easier to understand than the esoteric crap
    tools like sglms vommit
  - maintains a project file
  - includes hscpitt, a tool to examine/manipulate project files
  - includes hscdepp, a dependancy generator for makefiles

NEW FEATURES

  - added internal support for message browsers for AmigaOS and
    RiscOS
  - as usual some minor bugfixes and improvements

SPECIAL REQUIREMENTS

  AmigaOS 2.04, 2MB of regular memory, 68020, some sort of w3-browser
  and ASCII editor.

  For larger projects, 4MB of memory and 68060 are recommended.

  Different to many other html-tools, hsc requires a user-IQ > 50. You
  should also know how to work with the CLI and how to write
  Makefiles. You should already have made some experiences with macro
  processors and some programming language (Rexx should suffice).

AVAILABILITY

  - Every Aminet-mirror, file "text/hyper/hsc.lha", for example:

    ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc.lha
    ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc-source.lha
    ftp://wuarchive.wustl.edu/pub/aminet/text/hyper/hsc-ps.lha

  - http://www.giga.or.at/~agi/hsc/

PRICE

  Freeware.

DISTRIBUTABILITY

  Distributed under GNU General Public License.

SOURCE CODE

  ANSI-C source code is available in a separate archive named
  `hsc-source.lha'.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                   37      37 100.0% -lh0- 324d Sep 21  1998 file_id.diz
[generic]                  276     628  43.9% -lh5- 1cf9 Sep  6  1998 hsc.info
[generic]                12642   32902  38.4% -lh5- a457 Sep 21  1998 hsc/CHANGES
[generic]                  241     463  52.1% -lh5- 4387 Sep  6  1998 hsc/CHANGES.info
[generic]                 6993   17982  38.9% -lh5- dc3e Jun 26  1995 hsc/COPYING
[generic]                  243     463  52.5% -lh5- 1480 Sep  6  1998 hsc/COPYING.info
[generic]                  270     628  43.0% -lh5- 8b41 Sep  6  1998 hsc/docs-source.info
[generic]                  262     436  60.1% -lh5- d609 Oct 10  1997 hsc/docs-source/README
[generic]                  238     463  51.4% -lh5- 8f4e Jun  2  1997 hsc/docs-source/README.info
[generic]                  280     628  44.6% -lh5- 4821 Sep  6  1998 hsc/docs.info
[generic]                 2385    5109  46.7% -lh5- 8164 Sep 21  1998 hsc/docs/about.html
[generic]                 2826    6353  44.5% -lh5- b6d1 Sep 21  1998 hsc/docs/author.html
[generic]                 3064    6647  46.1% -lh5- 0a56 Sep 21  1998 hsc/docs/bugs.html
[generic]                 2823    6304  44.8% -lh5- 4b71 Sep 21  1998 hsc/docs/changes.html
[generic]                 1049    2177  48.2% -lh5- 86d8 Sep 21  1998 hsc/docs/copy.html
[generic]                 1608    4056  39.6% -lh5- 60bc Sep 21  1998 hsc/docs/distrib.html
[generic]                 1083    2393  45.3% -lh5- c281 Sep 21  1998 hsc/docs/envvar.html
[generic]                 1041    2300  45.3% -lh5- 911f Sep 21  1998 hsc/docs/examples.html
[generic]                 3148    8454  37.2% -lh5- 2016 Sep 21  1998 hsc/docs/features/assign.html
[generic]                  855    1883  45.4% -lh5- dbf2 Sep 21  1998 hsc/docs/features/checkuri.html
[generic]                 3653    9800  37.3% -lh5- 5181 Sep 21  1998 hsc/docs/features/exec.html
[generic]                 2473    7019  35.2% -lh5- 2d75 Sep 21  1998 hsc/docs/features/expressions.html
[generic]                 2795    6282  44.5% -lh5- b7f5 Sep 21  1998 hsc/docs/features/getsize.html
[generic]                 1762    4717  37.4% -lh5- 83af Sep 21  1998 hsc/docs/features/if.html
[generic]                 3821    9003  42.4% -lh5- 9a2f Sep 21  1998 hsc/docs/features/prefs.html
[generic]                 1082    2206  49.0% -lh5- 7c0b Sep 21  1998 hsc/docs/features/rplcent.html
[generic]                 3759   13155  28.6% -lh5- 7242 Sep 21  1998 hsc/docs/features/spcattr.html
[generic]                 4927   13306  37.0% -lh5- 3e4d Sep 21  1998 hsc/docs/features/spctags.html
[generic]                 1683    3913  43.0% -lh5- b9c0 Sep 21  1998 hsc/docs/features/strip.html
[generic]                  882    1894  46.6% -lh5- fd9c Sep 21  1998 hsc/docs/features/syntax.html
[generic]                 2439    5930  41.1% -lh5- 320d Sep 21  1998 hsc/docs/features/uris.html
[generic]                 2354    5937  39.6% -lh5- 6b39 Sep 21  1998 hsc/docs/fileargs.html
[generic]                 1377    2807  49.1% -lh5- abb7 Sep 21  1998 hsc/docs/future.html
[generic]                  103     103 100.0% -lh0- 62bc Jun  6  1997 hsc/docs/image/austria.gif
[generic]                  138     138 100.0% -lh0- caae Jan 14  1996 hsc/docs/image/back.gif
[generic]                  190     190 100.0% -lh0- 1fb4 Jan 14  1996 hsc/docs/image/copy.gif
[generic]                  140     140 100.0% -lh0- 020f Jun  6  1997 hsc/docs/image/english.gif
[generic]                  638     638 100.0% -lh0- 8cff May 26  1996 hsc/docs/image/hsc.gif
[generic]                  170     170 100.0% -lh0- efae Jan 14  1996 hsc/docs/image/index.gif
[generic]                  176     176 100.0% -lh0- 1d32 Jan 14  1996 hsc/docs/image/main.gif
[generic]                  189     189 100.0% -lh0- 2f1a Jan 14  1996 hsc/docs/image/next.gif
[generic]                  347     347 100.0% -lh0- 6b10 Oct 12  1996 hsc/docs/image/niceguy.gif
[generic]                  168     168 100.0% -lh0- bfd0 Jan 14  1996 hsc/docs/image/noback.gif
[generic]                  211     211 100.0% -lh0- 96b5 Jan 14  1996 hsc/docs/image/nocopy.gif
[generic]                  200     200 100.0% -lh0- 1c77 Jan 14  1996 hsc/docs/image/noindex.gif
[generic]                  201     201 100.0% -lh0- 3884 Jan 11  1998 hsc/docs/image/nomain.gif
[generic]                  212     212 100.0% -lh0- 45a4 Jan 14  1996 hsc/docs/image/nonext.gif
[generic]                  213     213 100.0% -lh0- f4b8 Jul 15  1996 hsc/docs/image/noprev.gif
[generic]                  188     188 100.0% -lh0- 8594 Jan 14  1996 hsc/docs/image/prev.gif
[generic]                  111     111 100.0% -lh0- d075 Jun  6  1997 hsc/docs/image/teutsch.gif
[generic]                  141     141 100.0% -lh0- 3dee Nov  4  1995 hsc/docs/image/up.gif
[generic]                 2709    7398  36.6% -lh5- ae88 Sep 21  1998 hsc/docs/index.html
[generic]                  241     462  52.2% -lh5- 33fa Sep  4  1998 hsc/docs/index.html.info
[generic]                 2115    4806  44.0% -lh5- ea65 Sep 21  1998 hsc/docs/install.html
[generic]                 1837    5048  36.4% -lh5- 73ed Sep 21  1998 hsc/docs/macro/attrib.html
[generic]                 1710    4698  36.4% -lh5- 77e6 Sep 21  1998 hsc/docs/macro/flag.html
[generic]                 3613    9618  37.6% -lh5- 217d Sep 21  1998 hsc/docs/macro/macros.html
[generic]                 7680   23998  32.0% -lh5- 02ff Sep 21  1998 hsc/docs/message-list.html
[generic]                 4707   12238  38.5% -lh5- c840 Sep 21  1998 hsc/docs/messages.html
[generic]                 4911   12943  37.9% -lh5- b8e1 Sep 21  1998 hsc/docs/options.html
[generic]                 2776    6333  43.8% -lh5- fccc Sep 21  1998 hsc/docs/others.html
[generic]                 3223    7486  43.1% -lh5- b6ec Sep 21  1998 hsc/docs/ports.html
[generic]                 1446    3530  41.0% -lh5- 23b9 Sep 21  1998 hsc/docs/project/hscdepp.html
[generic]                 1066    2321  45.9% -lh5- 6a53 Sep 21  1998 hsc/docs/project/hscpaltrow.html
[generic]                 2658    7278  36.5% -lh5- e70b Sep 21  1998 hsc/docs/project/hscpitt.html
[generic]                 3922   10713  36.6% -lh5- d791 Sep 21  1998 hsc/docs/project/index.html
[generic]                 2957    6693  44.2% -lh5- 1976 Sep 21  1998 hsc/docs/project/make.html
[generic]                 1799    4309  41.7% -lh5- 4c0c Sep 21  1998 hsc/docs/project/makefile.html
[generic]                 1308    3106  42.1% -lh5- 113c Sep 21  1998 hsc/docs/project/prjfile.html
[generic]                 3629    9133  39.7% -lh5- 8b9c Sep 21  1998 hsc/docs/questions.html
[generic]                 1999    4583  43.6% -lh5- e54e Sep 21  1998 hsc/docs/related.html
[generic]                 1735    3692  47.0% -lh5- aeab Sep 21  1998 hsc/docs/require.html
[generic]                 4888   11566  42.3% -lh5- 1c05 Sep 21  1998 hsc/docs/source.html
[generic]                 1229    2633  46.7% -lh5- e89a Sep 21  1998 hsc/docs/teutsch.html
[generic]                 1672    3670  45.6% -lh5- 3e90 Sep 21  1998 hsc/docs/undocumented.html
[generic]                 1581    3579  44.2% -lh5- a4c2 Sep 21  1998 hsc/docs/updates.html
[generic]                 5259   12652  41.6% -lh5- cfa7 Sep 21  1998 hsc/docs/usecases.html
[generic]                  275     628  43.8% -lh5- 52c6 Sep  6  1998 hsc/examples.info
[generic]                  273     628  43.5% -lh5- 250d Jun  8  1997 hsc/examples/advanced.info
[generic]                  154     249  61.8% -lh5- 9e21 Aug 23  1998 hsc/examples/advanced/README
[generic]                  239     463  51.6% -lh5- 2145 Jun  3  1997 hsc/examples/advanced/README.info
[generic]                  271     628  43.2% -lh5- 8874 Jun  8  1997 hsc/examples/fetzenschaedl.info
[generic]                  347     347 100.0% -lh0- 6b10 Oct 12  1996 hsc/examples/fetzenschaedl/hugo/hugo.gif
[generic]                  172     217  79.3% -lh5- ed49 Oct 23  1995 hsc/examples/fetzenschaedl/hugo/hugo.hsc
[generic]                  514    1104  46.6% -lh5- 800e Sep 30  1996 hsc/examples/fetzenschaedl/macro.hsc
[generic]                  257     398  64.6% -lh5- 76ca Jul 23  1996 hsc/examples/fetzenschaedl/main.hsc
[generic]                  296     583  50.8% -lh5- 4ebc Jan  7  1998 hsc/examples/fetzenschaedl/Makefile
[generic]                 1168    2497  46.8% -lh5- b960 Jun  3  1997 hsc/examples/fetzenschaedl/README
[generic]                  238     463  51.4% -lh5- 5d3b Jun  3  1997 hsc/examples/fetzenschaedl/README.info
[generic]                  139     178  78.1% -lh5- c60e Sep 16  1995 hsc/examples/fetzenschaedl/stupid.hsc
[generic]                  274     628  43.6% -lh5- 9a49 Jun  8  1997 hsc/examples/simple.info
[generic]                   55      55 100.0% -lh0- 304f Mar  9  1997 hsc/examples/simple/object_html/README
[generic]                 1126    2589  43.5% -lh5- d009 Jun  3  1997 hsc/examples/simple/README
[generic]                  241     463  52.1% -lh5- 3d75 Jun  3  1997 hsc/examples/simple/README.info
[generic]                  347     347 100.0% -lh0- 6b10 Oct 12  1996 hsc/examples/simple/source_hsc/hugo/hugo.gif
[generic]                  172     217  79.3% -lh5- ed49 Oct 23  1995 hsc/examples/simple/source_hsc/hugo/hugo.hsc
[generic]                  514    1104  46.6% -lh5- 800e Sep 30  1996 hsc/examples/simple/source_hsc/macro.hsc
[generic]                  257     398  64.6% -lh5- 76ca Jul 23  1996 hsc/examples/simple/source_hsc/main.hsc
[generic]                  360     754  47.7% -lh5- 2a5e Jan  7  1998 hsc/examples/simple/source_hsc/Makefile
[generic]                  139     178  78.1% -lh5- c60e Sep 16  1995 hsc/examples/simple/source_hsc/stupid.hsc
[generic]                  271     628  43.2% -lh5- 0fcc Sep  6  1998 hsc/grafflwerk.info
[generic]                 1249    2915  42.8% -lh5- 3ae4 Sep 14  1998 hsc/grafflwerk/hScMsg.rexx
[generic]                  274     513  53.4% -lh5- 27b6 Mar 29  1997 hsc/grafflwerk/hScMsg.rexx.info
[generic]                 1662    4493  37.0% -lh5- 914f Sep 14  1998 hsc/grafflwerk/hscpaltrow.rexx
[generic]                  286     517  55.3% -lh5- 8aa0 Apr 15  1997 hsc/grafflwerk/hscpaltrow.rexx.info
[generic]                  581    1279  45.4% -lh5- 06d4 Mar 28  1997 hsc/grafflwerk/README
[generic]                  240     463  51.8% -lh5- 72b4 Mar 29  1997 hsc/grafflwerk/README.info
[generic]                 1151    2655  43.4% -lh5- 3683 Sep 14  1998 hsc/grafflwerk/SendScMsg.rexx
[generic]                  278     516  53.9% -lh5- 7342 Mar 29  1997 hsc/grafflwerk/SendScMsg.rexx.info
[generic]                  289     455  63.5% -lh5- 547d Oct 12  1997 hsc/grafflwerk/StripNastyChars.hsc
[generic]                  364     604  60.3% -lh5- 0155 Oct 16  1997 hsc/grafflwerk/StripNastyChars.rexx
[generic]                61643  113628  54.2% -lh5- 3cd2 Sep 21  1998 hsc/hsc
[generic]                 6391   25589  25.0% -lh5- 7af6 Sep 15  1998 hsc/hsc-Tschak
[generic]                  314     618  50.8% -lh5- 2a98 Sep  8  1998 hsc/hsc-Tschak.info
[generic]                  204     467  43.7% -lh5- 928e Sep  6  1998 hsc/hsc.info
[generic]                 3690   14704  25.1% -lh5- 0431 Feb 21  1998 hsc/hsc.prefs
[generic]                29000   51676  56.1% -lh5- 21ee Sep 21  1998 hsc/hscdepp
[generic]                  207     467  44.3% -lh5- a627 Sep  6  1998 hsc/hscdepp.info
[generic]                29211   51764  56.4% -lh5- 747e Sep 21  1998 hsc/hscpitt
[generic]                  207     467  44.3% -lh5- 0467 Sep  6  1998 hsc/hscpitt.info
[generic]                  250     383  65.3% -lh5- 2bcb Oct  2  1997 hsc/IMPORTANT
[generic]                  240     463  51.8% -lh5- 5fa0 Sep  6  1998 hsc/IMPORTANT.info
[generic]                 2581    5853  44.1% -lh5- 82d4 Aug 26  1998 hsc/NEWS
[generic]                  240     463  51.8% -lh5- 6142 Sep  6  1998 hsc/NEWS.info
[generic]                 1404    2737  51.3% -lh5- b3ab Sep 21  1998 hsc/README
[generic]                  243     463  52.5% -lh5- e62a Sep  6  1998 hsc/README.info
[generic]                  270     628  43.0% -lh5- 490f Sep  6  1998 hsc/source.info
[generic]                  257     421  61.0% -lh5- de30 Sep 14  1997 hsc/source/README
[generic]                  240     463  51.8% -lh5- 3237 Mar 29  1997 hsc/source/README.info
[generic]                  552    1200  46.0% -lh5- 057d Sep  6  1998 hsc/starter-project/include/page.hsc
[generic]                  251     406  61.8% -lh5- 58cc Sep  6  1998 hsc/starter-project/include/standard.hsc
[generic]                  468     922  50.8% -lh5- baa7 Sep  7  1998 hsc/starter-project/Makefile
[generic]                  238     464  51.3% -lh5- 9d7a Sep  6  1998 hsc/starter-project/Makefile.info
[generic]                  569    1192  47.7% -lh5- e892 Sep  6  1998 hsc/starter-project/README
[generic]                  239     463  51.6% -lh5- 8279 Sep  6  1998 hsc/starter-project/README.info
[generic]                   80      99  80.8% -lh5- 9ba3 Mar 20  1997 hsc/starter-project/Welcome.hsc
[generic]                  236     464  50.9% -lh5- 3dc9 Sep  6  1998 hsc/starter-project/Welcome.hsc.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total       137 files  304475  681115  44.7%            Sep 23  1998