scc-log2html(1)

NAME

	scc-log2html - convert a SCC-logbook to HTML-format

RELEASE

	scc	1.26.73

SYNOPSIS

	scc-log2html [ -h|--help ] [ -s|--standalone ] <name>

DESCRIPTION

	This program reads a SCC-logbook from stdin and converts it to HTML-
	format on stdout. Refer to scc(4) for a detailed description of 
	SCC-logbook. An empty logbook results in an empty html-file.

	The html-file consists of a table with entries for each run of scc.
	For reported differences in the logbook, the menu contains an URL
	pointing to the corresponding report.

	The logbook contains DIV-tags with the following nested classes:
	    - SCC_LOG
	        - SCC_LOG_NAV
	        - SCC_LOG_SUMMARY
	        - SCC_LOG_STATS
	        - SCC_LOG_ENTRY
	The sylesheet style.css in /var/opt/scc/data controls the markup.

OPTIONS

	-h|--help       Display the syntax and exit.
	-s|--standalone Embed the stylesheet in the html-data and do not
	                show "externel" links to snapshot and index.html.
	                Use this option before transferring the html
	                version of the logbook to a user.

ARGUMENTS

	<name>          name of the host to convert the SCC-snapshot for

DIAGNOSTICS

	This program writes the following message to stderr:

	Syntax error, use: scc-log2html [ -h|--help ] [ -s|--standalone ] <name>
	A syntax error was detected and reported.

	scc-log2html: insufficient permissions to write in data directory: <data_dir>
	To run this program, log in as the owner of the directory.

RETURN VALUE

	Upon completion, the program returns one of the following values:

		0 successful completion
		1 Syntax error
		2 Runtime error

EXTERNAL INFLUENCES

	Use environment variable SCC_DATA to specify an alternative directory
	for the SCC data files. Should be an absolute path.

COPYRIGHT

	scc-log2html is free software under the terms of the GNU General Public 
	License. Copyright (C) 2001-2004 Open Challenge B.V.,
	2004-2005 OpenEyeT Professional Services, 2005-2018 QNH,
	2019 Siem Korteweg.

FILES

	/var/opt/scc/data/style.css - stylesheet

SEE ALSO

	scc(1), scc-cmp(1), scc-collect(1), scc-log(1), scc-log2html(1),
	scc-plugin(1), scc-snap2html(1), scc(4), scc(5)

VERSION

	$Revision: 6216 $