Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
slice2html(1)		     General Commands Manual		   slice2html(1)

NAME
     slice2html - The Slice to HTML documentation tool.

SYNOPSIS
     slice2html [options] [files]

DESCRIPTION
     slice2html  generates  HTML  documentation  from  Slice  files.  The  macro
     __SLICE2HTML__ is defined during this compilation.

     Full documentation for slice2html is available online at:
     https://doc.zeroc.com/ice/3.7/the-slice-language/generating-slice-documen-
     tation

     slice2html is deprecated, Doxygen is now  the  preferred  way  to	generate
     Slice API reference, see:
     https://doc.zeroc.com/api/ice/3.7/slice/

OPTIONS
     -h, --help
	    Displays help message.

     -v, --version
	    Displays the compiler version.

     -DNAME
	    Defines the preprocessor symbol NAME.

     -DNAME=DEF
	    Defines the preprocessor symbol NAME with the value DEF.

     -UNAME
	    Undefines the preprocessor symbol NAME.

     -IDIR
	    Add the directory DIR to the search path for #include directives.

     -E
	    Print the preprocessor output on stdout.

     --output-dir DIR
	    Place the generated files into directory DIR.

     -d, --debug
	    Print debug information showing the operation of the Slice parser.

     --hdr FILE
	    Prepend  FILE to each generated HTML file (except for _sindex.html).
	    This allows you to replace the HTML header and other preamble infor-
	    mation with a custom version, so you can connect style sheets to the
	    generated pages. The specified file must include the <body> tag (but
	    need not end with a <body> tag). FILE is  expected	to  contain  the
	    string TITLE on a line by itself, starting in column one. slice2html
	    replaces  the  TITLE  string with the fully-scoped name of the Slice
	    symbol that is documented on the corresponding page.

     --ftr FILE
	    Append FILE to each generated HTML file (except  for  _sindex.html).
	    This  allows you to add, for example, a custom footer to each gener-
	    ated page. FILE must end with a </body> tag.

     --indexhdr FILE
	    slice2html generates a file _sindex.html that contains  a  table  of
	    contents  of  all  Slice symbols that hyperlink to the corresponding
	    page. This option allows you to replace the standard header  with  a
	    custom  header,  for  example, to attach a JavaScript. The specified
	    file must include the <body> tag (but need not  end  with  a  <body>
	    tag). The default value is the setting of --hdr (if any).

     --indexftr FILE
	    Append  FILE  to  the generated sindex.html page. This allows you to
	    add, for example, a custom footer to the table of  contents,  or  to
	    invoke  a  JavaScript.  FILE is must end with a </body> tag. The de-
	    fault value is the setting of --ftr (if any).

     --image-dir DIR
	    With this option, slice2html looks in the  specified  directory  for
	    images to use for the generated navigation hyperlinks. (Without this
	    option,  text links are used instead.) Please see the generated HTML
	    for the names of the various image files. (They can easily be  found
	    by looking for img elements.)

     --logo-url URL
	    Use  the  specified  URL as a hyperlink for the company logo that is
	    added to each page (if --image-dir is specified). The  company  logo
	    is expected to be in <image_dir>/logo.gif.

     --search ACTION
	    If	this  option  is specified, the generated pages contain a search
	    box that allows you to connect the generated pages to a  search  en-
	    gine.  On pressing the "Search" button, the specified ACTION is car-
	    ried out.

     --index NUM
	    slice2html generates sub-indexes for various Slice symbols. This op-
	    tion controls how many entries must be present before a sub-index is
	    generated.	For example, if NUM is set to 3,  a  sub-index	will  be
	    generated  only  if  there	are three or more symbols that appear in
	    that index. The default settings is 1, meaning that a  sub-index  is
	    always generated. To disable sub-indexes entirely, set NUM to 0.

     --summary NUM
	    If	this option is set, summary sentences that exceed NUM characters
	    generate a warning.

SEE ALSO
     slice2cpp(1),  slice2cs(1),  slice2java(1),  slice2js(1),	slice2matlab(1),
     slice2objc(1), slice2php(1), slice2py(1), slice2rb(1)

								   slice2html(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=slice2html&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help