table of contents
JAVA2HTML(1) | General Commands Manual | JAVA2HTML(1) |
NAME¶
java2html - generates highlighted html-files from Java or C++ sourceSYNOPSIS¶
java2html [options] [filename...]DESCRIPTION¶
This manual page documents how to use java2html. If no arguments are given on the command line of java2html, it reads from stdin and writes to stdout. If invoked with filenames as arguments java2html will write it's output into new files. Names of output files are generated by appending ".html" to the corresponding input filename.Installing as a CGI program¶
java2html can be installed as a CGI program and convert source files on the fly. In order to set this up for apache the webmaster has to add the two linesAddType text/x-java .java
Action text/x-java /cgi-bin/java2html
OPTIONS¶
- --
- Interpret all following arguments on the command line as filenames. This is useful, if you want to convert files beginning with a '-'.
- -b filename
- Insert the file 'filename' after converted data and before HTML footer. See also the -s option.
- -c
- Turns off CGI-script detection and HTTP header generation. This is needed to use java2html as a subcommand in another CGI script.
- -h filename
- Insert the file 'filename' after the HTML headers and before the converted data. See also the -s option.
- -i
- Generate an index only. This will generate a list of references (HREF's)
to the labels that java2html creates for your source file. The
references are created as list items (<li>) in an HTML list. Each
line has the form
#! /bin/sh
echo "Content-type: text/html"
echo ""
echo "<html>"
echo "<head><title>$PATH_TRANSLATED</title>"
echo "<meta name=\"generator\""
echo "content=\"`java2html -V`\">"
echo "</head>"
echo "<body>"
echo "<h1>Source of $PATH_TRANSLATED</h1>"
echo "<ul>Structures and functions"
cat $PATH_TRANSLATED | java2html -isc
echo "</ul>"
echo "<hr></hr>"
cat $PATH_TRANSLATED | java2html -sc
echo "</body></html>"
exit
- -n
- Number lines and label them with 'line' followed by the line number. Empty lines get no label, but the linecounter will count them nevertheless. With this feature you can refer to special lines of code from other parts of the generated file or from external files with a line like this: <A HREF="foo.java.html#line301">Go to line 301</A>
- -s
- With this option you can suppress the generation of HTML headers. This is especially useful together with options -b file and -h file.
- -t title
- Set the title to 'title'. The default is the filename you converted or "stdin" if reading from stdin. This option is only used if -s is not set.
- -u
- Print usage information.
- -w width
- sets the WIDTH attribute for HTML tag <PRE>. If this option is not used a default of 80 is assumed. (Currently most browsers are ignoring this attribute).
- -V
- reports the version number of java2html.