Don't believe the hype
Take a look at the small print
Ignore the bold type
(Carter U.S.M, "Do Re Me, So Far So Good")

hsc

(Version 0.913, 26-May-1997)

This is the documentation to hsc, a developer tool for html-projects. It acts as a preprocessor and supports include files, macros, expressions, conditionals, replaces special characters, performs a structure check, tests existence of local links and several other things.

A current version of this document should always be available from http://www.giga.or.at/~agi/hsc/docs/.

About the program

• Introduction - What's this all about?
• Copyright and disclaimer - the usual legal stuff
• Author - how to contact me
• Changes - what's new with this release
• Updates - where to find them

Before you begin

• Requirements - what to own and know
• Archive contents - things coming along
• Installation - where to put the whole damn thing

Usage

• Invoking hsc
  • Options and switches - there are loads of them
  • Exit-code - return to sender
  • Example usage - how it is supposed to work
• File arguments - specifying input and output
• Messages - shit happens
  • Message elements
  • Message classes
  • Message options
  • List of messages
• Environment variables - Save the nature

Features

• Special tags to make life a bit easier
• Check existence of local URIs to avoid dangling links
• Absolut URIs to avoid paths like "../../../image/back.gif"
• Replace special characters by their entities
• Get size of images and set attributes WIDTH and HEIGHT
• Special attributes to access various information
• Strip specific elements (comments, redundant linefeeds and white-spaces, unneeded tags, tags with external references)
• Structure and syntax check to avoid surprises with different browsers

Advanced topics

• Expressions - there's more to life than strings
  • Operators
  • Boolean expressions
  • Priorities
• Macros - create your own shortcuts and templates.
  • Macro modifiers
  • Attribute declaration
  • Attribute types
  • Attribute modifiers
• Conditionals - what if..?
  • General syntax
  • Some simple examples
  • Nesting conditionals
  • Conditionals and macros
• Syntax definition - what to do if html version 17.3 is out
• Execute shell-commands - poor man's pseudo-CGI
• Project management - I'll make ya
  • make - a general purpose tool for project management
  • project files - where hsc stores the required information.
  • Makefiles - how to adopt them for hsc
  • hscdepp - hsc dependency procreator
  • hscpitt - hsc project interfering and trashing tool
  • hscpaltrow - a Rexx-script demonstrating how to utilize the output of hscpitt

Miscellaneous

• Questions - and maybe some answers..
• Source code - gnugnugnugnugngnugngug
• Existing ports - Amiga rulez? Not really.
• Known bugs, problems and limitations - hsc sucks completely
• Future Improvements - what might happen
• Related stuff - tools and further information