doc: Document C/Java source highlighting.

2 files changed, 39 insertions, 0 deletions

diff --git a/doc/user/prgm.skb b/doc/user/prgm.skb
index e44ad10..5c681f8 100644
--- a/doc/user/prgm.skb
+++ b/doc/user/prgm.skb
@@ -98,6 +98,17 @@ can be rendered using different colors or faces.])
 (example-produce 
  (example :legend "The source markup" (prgm :file "src/prgm2.skb"))
  (disp (include "src/prgm2.skb")))
+   
+(p [Note that even awful programming languages of the C family can be
+highlighted!])
+
+(linebreak)
+(example-produce 
+ (example :legend "The source markup for C" (prgm :file "src/prgm4.skb"))
+ (disp (include "src/prgm4.skb")))
+   
+(p [You would highlight Java,(symbol "tm") code in a similar way, i.e.,
+with ,(tt [:language java]).])
 
 (mark "*source-path*")
 (p [Files passed as the ,(tt [:file]) argument of ,(markup-ref "source")
diff --git a/doc/user/src/prgm4.skb b/doc/user/src/prgm4.skb
new file mode 100644
index 0000000..734de54
--- /dev/null
+++ b/doc/user/src/prgm4.skb
@@ -0,0 +1,28 @@
+(use-modules (skribilo source c))
+	     
+(p [Here's how:])
+   
+ (linebreak)
+ (prog
+   (source :language c
+[#include <stdlib.h>
+
+static int foo = 10;
+static float bar;
+
+/* This is the function responsible
+   for integer chbouibification.  */
+float
+chbouibify (int x)
+{
+  bar = foo + (float) x / random ();
+  foo = (float) x * random ();
+
+  if (x > 2)
+    /* Great!  */
+    printf ("hello world!\n");
+  else
+    printf ("lower than two\n");
+
+  return ((float) foo * bar);
+}]))