GNU Source-highlight by Lorenzo Bettini <http://www.lorenzobettini.it> This program, given a source file, produces a document with syntax highlighting. The home page is http://www.gnu.org/software/src-highlite/ You can download it from GNU's ftp site: ftp://ftp.gnu.org/gnu/src-highlite/ or from one of its mirrors (see http://www.gnu.org/prep/ftp.html). This project's CVS repository can be checked out through anonymous (pserver) CVS with the following instruction: cvs -z3 -d:pserver:anonymous@@cvs.savannah.gnu.org:/sources/src-highlite co src-highlite Further instructions can be found at the address: http://savannah.gnu.org/projects/src-highlite. Installation Since version 2.0 Source-highlight relies on regular expressions as provided by boost, http://www.boost.org, so you need to install at least the regex library from boost. Most GNU/Linux distributions provide this library already in a compiled form. See the file INSTALL for detailed building and installation instructions; anyway if you're used to compiling Linux software that comes with sources you may simply follow the usual procedure: cd /<source code main directory> /./configure make make install Note: unless you specify a different install directory by --prefix option of configure (e.g. ./configure --prefix=/<your home>/), you must be root to 'make install'. It is also possible to specify as following option for /configure/:/--enable-input-chroot/ to hardcode in the program the path to prefix for input files. Before you run 'make install' you may want to check that the programs have compiled fine, so you can run 'make check'. Files will be installed in the following directories: * Executables -> /prefix/bin * docs and samples -> /prefix/share/doc/source-highlight * conf files -> /prefix/share/source-highlight Default value for prefix is /usr/local but you may change it with --prefix option to configure (see above). Building .rpm Christian W. Zuckschwerdt added support for building an .rpm and an .rpm.src. You can issue the following command rpm -tb source-highlight-1.9rc.tar.gz for building an .rpm with binaries and rpm -ts source-highlight-1.9rc.tar.gz for building an .rpm.src with sources. Patching from a previous version If you downloaded a patch, say source-highlight-1.3-1.3.1-patch.gz(i.e. the patch to go from version 1.3 to version 1.3.1), cd to the directory with sources from the previous version (source-highlight-1.3) and type: gunzip -cd ../source-highlight-1.3-1.3.1.patch.gz | patch -p1 and restart the compilation process (if you had already run configure a simple make will do). Usage and examples See the index.html in the doc directory for many examples. Use source-highlight with less This was suggested by Konstantine Serebriany. The script src-hilite-lesspipe.sh will be installed together with source-highlight. You can use the following environment variables: export LESSOPEN="| /path/to/src-hilite-lesspipe.sh %s" export LESS=' -R ' This way, when you use less to browse a file, if it is a source file handled by source-highlight, it will be automatically highlighted. Credits See CREDITS for detailed contributions and THANKS for a complete list of people that helped me with Source-highlight :-) Feedback Please tell me if you like this software :-) Actually I want to extend it, so if you have some ideas... The most import one will be to make source-highlight more customizable :-) Please send all bug reports by electronic mail to: bug-source-highlight at gnu.org TODO Here's the list of TODO stuff <TODO.txt>, if you'd like to contribute :-) Mailing Lists The following mailing lists are available: * help-source-highlight at gnu.org for generic discussions about the program and for asking for help about it (open mailing list), http://mail.gnu.org/mailman/listinfo/help-source-highlight * info-source-highlight at gnu.org for receiving information about new releases and features (read-only mailing list), http://mail.gnu.org/mailman/listinfo/info-source-highlight if you want to subscribe to a mailing list just go to the URL and follow the instructions, or send me an e-mail and I'll subscribe you. My home page is http://www.lorenzobettini.it source-highlight is free software. See the file COPYING for copying conditions. Anyway I won't get offended if you send me a postcard :-)