AutoHTML Manual

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

2. Operation
AutoHTML uses a list file (by default this is named main.auto) to determine what files it should parse. It then sequentially opens these files, performs the commands specified within, and outputs the new version to a specified location.

2.1 Command Line
PERL AHTML.PL
You can add the following arguments to the command line:
-a/-A

This toggles the parse-all behavior (enabled by default, -A disables). When disabled, AutoHTML will check the last-modified timestamp of the source and destination files, if the destination file is newer, parsing is cancelled. NOTE: There is no check that a file referenced via INCLUDE has been modified (thus this behavior is disabled be default).

-d/-D

This toggles the debugging output (disabled by default, -d enables). Debug output displays every command encountered by AutoHTML while parsing. Due to the volume of text this produces and the resulting speed reduction, it should not be used in normal operation.

-lfilename

This changes the list file from the default main.auto to the specified filename

-p/-P

This toggles pause at end of run (disabled by default, -p enables). All it does is toss a "PAUSE" command to the system which may be useful if you're running it from a GUI rather than the command line. Though you might as well just redirect output to a text file if you're having errors.

-t/T

This toggles the tracing output (enabled by default, -T disables). Tracing output displays the files that AutoHTML opens while parsing & the commands encountered in the list file.

-x/X

This toggles strict mode (disabled by default, -x enables). While in strict mode any unrecognized tags or other errors in the input file will result in program termination.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~