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:

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>
Tipp der data2type-Redaktion:
Zum Thema DocBook bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

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