Provided by: java2html_0.9.2-7_amd64 bug

NAME

       java2html - generates highlighted html-files from Java or C++ source

SYNOPSIS

       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 lines

               AddType text/x-java .java
               Action text/x-java /cgi-bin/java2html

       to  the webserver configuration file.  java2html depends on the webserver properly setting
       environment variable PATH_TRANSLATED to the pathname of the source file.  If java2html has
       been  compiled  with  option  -DCOMPRESSION=1  then  it  will  invoke gzip to compress the
       generated HTML before sending it to the requesting browser. Of course java2html takes care
       to check if the browser accepts gzip encoding.

   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
              <li><a href="#name">prototype()</a></li>
              so they can be used directly as an index list, or further parsed by another script.
              If you want the index at the top of the source file, you will need a wrapper script
              like this one:

                #! /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.

EXIT STATUS

       java2html returns 0 on success, 1 if input files are not existing/readable,  2  if  output
       files  are  not creatable/writable, 3 if invoked with illegal options and 4 if gzip cannot
       be invoked.

AUTHORS

       Florian Schintke <schintke@cs.tu-berlin.de>
       Martin Kammerhofer <mkamm@gmx.net> wrote the CGI feature.
       Rob Ewan <rob@ewan.com> wrote the indexing feature.

SEE ALSO

       c2html(1), pas2html(1), perl2html(1).

                                                                                     JAVA2HTML(1)