hscpitt

hsc Project Interfering and Trashing Tool

Hscpitt can be used to extract and manipulate data stored in hsc's project file. It lists all documents stored in the project and removes entries and corresponding files for documents.

Hscpitt is part of the hsc-distribution and therefor the same legal issues apply.

Hscpitt is dedicated to Brad Pitt.

Important: hscpitt should be used with caution. It assumes that the user knows what he is doing and does not ask back before performing any action. Using hscpitt it is rather easy to remove information within seconds that required hours being implemented.

Options and switches

HELP=-h=?/S

Display short help message and exit.

LICENSE/S

Display a short version of Copyright and exit.

COMMAND

Command to be applied to project. Supported commands are:

LIST - show list of documents
ADD - add new document to project
DELETE - remove documents entries from project, but leave corresponding files intact
ERASE - remove documents entries from project andalso corresponding document and source file.
EXTRACT - show detailed list of all documentscurrently stored in project

For a more detailed explanation of these commands see below.

ARG/M

Arguments for command. Depends on the value of COMMAND.

PRJFILE/K

Specifies project file to be examined/manipulated. If none given, hsc.project is used.

QUIET/S

Act quietly, do not display progress and status messages.

-DEBUG/S

Enable debug mode; only useful if compiled in debug mode.

Commands

COUNT

Setting COMMAND=COUNT will output the number of documents currently stored in the project file.

LIST

Setting COMMAND=LIST will output a short list of documents to stdout. Every line contains the name of a html object.

ADD

Setting COMMAND=ADD will add a new document with it's corresponding main source to the project. The first ARG contains the full relative filename of the html object, the second ARG contains the name of the main hsc-source that will be used to create the document.

If the document already is part of the project, an error message will be displayed and the old document will be left untouched. To replace a document, you will have to DELETE it before.

DELETE

Setting COMMAND=DELETE will remove the entries specified in ARG from the project file. The document and the corresponding source remains untouched.

ERASE

Setting COMMAND=ERASE will remove the entries specified in ARG from the project file. Different to COMMAND=DELETE, it will also remove the files for document and source. This command should be used with caution.

EXTRACT

Setting COMMAND=EXTRACT will output a detailed list of documents to stdout. This command is mend to be used if you want to utilize the information stored in the project file. Just redirect the output of hscpitt and scan it by your program.

All lines match the template

identifier="value"

You must not make any assumptions about the sequence of identifiers. Your program should be able to skip unknown identifiers. At the end of data about a document, an EOF occurs or an empty line with another document succeeding.

Currently, possible identifers are:

DOCUMENT: URI of document, relative to current directory
SOURCE: Filename of main source file used to create document, relative to current directory
INCLUDE: Name of a file that has been included during processing the document. This identifier can show up more then once, if multiple files have been included.

See also hscpaltrow to learn how you can utilize this command.

Examples

hscpitt HELP: Displays help and exits.
hscpitt PRJFILE=sepp.project COMMAND=LIST: List all documents currently stored in project file sepp.project.
hscpitt ADD ../docs/sepp.html sepp.hsc: Adds document sepp.html, which is created from sepp.hsc. Note that ../docs/ denotes the relative path, where the html objects are located. This usually is the same value you used as ``TO'' argument to invoke hsc.
hscpitt EXTRACT: List information about all documents currently stored in project file hsc.project.
hscpitt COMMAND=DELETE www:index.html www:sepp/hugo.html: Remove entries for the documents www:index.html and www:sepp/hugo.html from the project file. The html object and hsc sources for these documents will not be removed.