Kommentieren von Zeilen
(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)
Falls Sie Ihren Quellcode an einer bestimmten Stelle kommentieren möchten, gibt es zwei Möglichkeiten:
- Markierungspunkte. Sie werden in Markierungslisten (calloutlist) und Markierungspunkte (Callouts) beschrieben.
- Zeilenanmerkung mit lineannotation
Quellcode und Anmerkungen lassen sich innerhalb von programlisting oder screen mischen:
<programlisting language="python">#!/usr/bin/python -u
import sys
import string
import commands
<lineannotation>Zusammensetzen des Befehls:</lineannotation>
cmd = ["file", sys.argv[1], "| cut -d',' -f2" ]
cmd = string.join(cmd)
(res, out) = commands.getstatusoutput(cmd) <lineannotation
>Ausführen des Befehls</lineannotation>
print res, out <lineannotation
>Rückgabewert und Ergebnis ausgeben</lineannotation>
</programlisting>
Copyright © 2009 Millin Verlag
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.
Millin Verlag, Siebengebirgsring 36, 53797 Lohmar, info(at)millin.de