A.2. Included Source Code Comment Processing
Comments, when formatted a certain way, will be processed by Slacker's
Docbook allowing you to do the following:
//end comments, you can trim the
included code so you only show in the book the relevant snippet.
//start id=idName, you can give IDs to different
snippets of code in the same source file, and refer to them from an
<include segid="idName"> the XML file.
Reformat multiline comments that come after non-whitespace as
numbered "callouts" where the comments show up in a numbered list after the
For languages where the comment character is a # instead of a // (Python,
Bash, Perl), Slacker's Docbook also supports