Langue: en

Version: July 2006 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)


source-highlight - manual page for source-highlight 2.4


source-highlight [OPTIONS]... [FILES]...


GNU source-highlight 2.4

Highlight the syntax of a source file (e.g. Java) into a specific format (e.g. HTML)

-h, --help
Print help and exit
-V, --version
Print version and exit
-i, --input=filename
input file. default std input
-o, --output=filename
output file. default std output. If STDOUT is specified, the output is directed to standard output
-s, --src-lang=STRING
source language (use --lang-list to get the complete list). If not specified, the source language will be guessed from the file extension.
list all the supported language and associated language definition file
list all the supported output language and associated language definition file
-f, --out-format=STRING
output format (use --outlang-list to get the complete list) (default=`html')
-v, --verbose
verbose mode on
-d, --doc
create an output file that can be used as a stand alone document (e.g., not to be included in another one)
cancel the --doc option even if it is implied (e.g., when css is given)
-c, --css=filename
the external style sheet filename. Implies --doc
-T, --title=STRING
give a title to the output document. Implies --doc
-t, --tab=INT
specify tab length. (default=`8')
-H, --header=filename
file to insert as header
-F, --footer=filename
file to insert as footer
specify the file containing format options (default=`')
output language definition file
output language map file (default=`')
directory where language definition files and language maps are searched for. If not specified these files are searched for in the current directory and in the data dir installation directory
output directory
language definition file
language map file (default=`')
prints the language elements that are defined
in the language definition file

reference generation:

-n, --line-number
number all output lines
number all output lines and generate an anchor,
made of the specified prefix + the line number (default=`line')
generate references (possible values="inline", "postline", "postdoc" default=`inline')
specify the file generated by ctags that will be used to generate references (default=`tags')
how to run the ctags command. If this option is not specified, ctags will be executed with the default value. If it is specified with an empty string, ctags will not be executed at all (default=`ctags --excmd=n --tag-relative=yes')


put source-highlight version in the generated file (default=on)
only check the correctness of a language definition file
only check the correctness of an output language definition file
if no language definition is found for the input, it is simply copied to the output
debug a language definition
show the regular expression automaton corresponding to a language definition file

Maintained by Lorenzo Bettini <>


Report bugs to <bug-source-highlight at> Copyright © 1999-2005 Lorenzo Bettini <> This program comes with ABSOLUTELY NO WARRANTY.
This is free software; you may redistribute copies of the program under the terms of the GNU General Public License. For more information about these matters, see the file named COPYING.


The full documentation for source-highlight is maintained as a Texinfo manual. If the info and source-highlight programs are properly installed at your site, the command
info source-highlight

should give you access to the complete manual.