aboutsummaryrefslogtreecommitdiff
path: root/development/source-highlight/README
diff options
context:
space:
mode:
Diffstat (limited to 'development/source-highlight/README')
-rw-r--r--development/source-highlight/README24
1 files changed, 24 insertions, 0 deletions
diff --git a/development/source-highlight/README b/development/source-highlight/README
new file mode 100644
index 0000000000000..6f34ffa6a72d1
--- /dev/null
+++ b/development/source-highlight/README
@@ -0,0 +1,24 @@
+GNU Source-highlight
+
+This program, given a source file, produces a document with syntax highlighting.
+It also provides a C++ highlight library.
+
+Source-highlight reads source language specifications dynamically, thus it can
+be easily extended (without recompiling the sources) for handling new
+languages. It also reads output format specifications dynamically, and thus it
+can be easily extended (without recompiling the sources) for handling new
+output formats. The syntax for these specifications is quite easy (take a look
+at the manual).
+
+Source-highlight is a command line program, and it can also be used as a CGI.
+
+Notice that source-highlight can also be used as a formatter (i.e., without
+highlighting): you can, for instance, format a txt file in HTML (and it will
+take care of translating special characters, such as, <, >, &).
+
+A common example:
+ less /usr/src/linux/kernel/panic.c
+
+to tune the less, add in your .bash_profile these lines:
+ export LESSOPEN="| /usr/bin/src-hilite-lesspipe.sh %s"
+ export LESS=' -R '