Noch eine Frage zu POD

Fehler in pod2html

Hallo,

ich hatte diese Frage zwar schon mal gepostet, aber ganz am Ende
eines anderen Threads, sodass die Gefahr besteht, dass sie der eine
oder andere vielleicht überlesen hat. Daher wiederhole ich sie hier
mit der Bitte um Hilfe:

> Eine zweite Frage noch: wenn ich zB. mit
>
> Zu Referenzen siehe auch L und L.
>
> externe Doku referenzieren möchte, sagt mir pod2html
>
> testdoc.pod: cannot resolve L in paragraph 78.
> testdoc.pod: cannot resolve L in paragraph 78.
>
> Beide Dokumente kann man sich aber mit perldoc ganz normal
> ansehen.

Kann mir da vielleicht jemand helfen?

Schöne Grüße, Ferry

--
Ing Ferry Bolhar
Magistrat der Stadt Wien - MA 14
A-1010 Wien
E-Mail: bol@adv.magwien.gv.at

Re: Zwei Fragen zu POD

On 2006-09-18 08:26, Ferry Bolhar wrote:
> Peter J. Holzer:
>>> Ja, aber wie gesagt, das ist hier ja gar nicht das Problem. HTML
>>> wird ja ohnehin richtig dargestellt. Nur pod eben nicht. Hilfe!
>>
>> Irgendwie habe ich jetzt ein Verständnisproblem: "pod" ist das
>> Source-Format. Das wird normalerweile gar nicht dargestellt, außer im
>> Editor beim Schreiben. Dieses Source-Format wird dann in diverse andere
>> Formate (man, html, latex, text, ...) übersetzt, und die schaut man sich
>> dann an. Wenn ich Dich recht verstehe, hast Du ein Problem mit dem
>> man-Format.
>
> Ja. Ich habe das ganze pod-System noch nicht so ganz durchschaut,
> aber es scheint, als gibt es zunächst Doku in pod, die wird dann in
> .nroff-Format übersetzt und aus der wird dann durch die diverse
> "Front-Ends" das gwünschte Output-Format (zB. HTML) erzeugt
> oder - wie im Fall von "man" - der nroff-Output mit einem Pager
> dargestellt.

Nein, nroff/man ist nur eines von mehreren Markup-Formaten, in die pod
direkt übersetzt wird. Es ist nur eines der wichtigeren, weil es von perldoc
unter Unix verwendet wird (was macht eigentlich perldoc unter Windows?
pod2text?).

Also eine Auswahl möglicher Konversionen ist z.B.:

..pod => pod2man => .man => nroff => .txt => $PAGER => (Zeichen am Bildschirm)
..pod => pod2man => .man => groff => .ps => lpr => (Zeichen am Papier)
..pod => pod2html => .html => $BROWSER (Zeichen am Bildschirm)
..pod => pod2latex => .tex => latex => .dvi => dvips => .ps => (Zeichen am Papier)


>> Gefunden. Es ist offensichtlich das .TH makro. Hier ist ein Patch für
>> Pod::Man:
>
> Danke für die Info! Das Dumme ist nur, dass ich damit zwar bei
> _mir_ das Abteilen unterbinden kann, aber nicht auf den Rechnern
> der Benutzer, die meine Doku später lesen werden, weil die ja
> weiterhin die ungepatchte Pod::Man Version verwenden.

Ja, das Blöde an Bugs ist, dass sie immer erst (frühestens) in der
nächsten Version gefixt sind. Du müsstest dann also Perl oder zumindest
Pod::Man überall upgraden.


> Wäre es möglich, hier mit der =for Direktive zu arbeiten?

Ja, das müsste möglich sein.

> Vielleicht könnte man dann auf diese Weise auch die benötigten
> Makros für nroff einbauen. Nur was gibt man als "formatname" nach
>=for an?

perldoc perlpod:

| Some format names that formatters currently are known to accept
| include "roff", "man", "latex", "tex", "text", and "html". (Some
| formatters will treat some of these as synonyms.)

Also probieren wir mal "roff":

=for roff .nh
=head1 NAME

fuh - eine Test-Seite

[...]

Scheint zu funktionieren.


> Und was müsste man im .TH angeben

Gar nichts. .TH setzt die Kopf- und Fußzeilen. Das scheint nur (versehentlich?)
als Nebeneffekt die Silbentrennung einzuschalten, daher muss man sie
danach wieder ausschalten, wenn man sie nicht will.

> bzw gibt es nicht auch in nroff die Möglichkeit zu sagen "trenne
> dieses Wort nicht"?

Vermutlich. Aber wie gesagt, was anderes als Man-Pages habe ich mit
*roff nie geschrieben, bei den Feinheiten kenne ich mich nicht aus.

hp


--
_ | Peter J. Holzer | > Wieso sollte man etwas erfinden was nicht
|_|_) | Sysadmin WSR | > ist?
| | | hjp@hjp.at | Was sonst wäre der Sinn des Erfindens?
__/ | http://www.hjp.at/ | -- P. Einstein u. V. Gringmuth in desd

Re: Fehler in pod2html

"Ferry Bolhar" writes:

> Hallo,
>
> ich hatte diese Frage zwar schon mal gepostet, aber ganz am Ende
> eines anderen Threads, sodass die Gefahr besteht, dass sie der eine
> oder andere vielleicht überlesen hat. Daher wiederhole ich sie hier
> mit der Bitte um Hilfe:
>
> > Eine zweite Frage noch: wenn ich zB. mit
> >
> > Zu Referenzen siehe auch L und L.
> >
> > externe Doku referenzieren möchte, sagt mir pod2html
> >
> > testdoc.pod: cannot resolve L in paragraph 78.
> > testdoc.pod: cannot resolve L in paragraph 78.
> >
> > Beide Dokumente kann man sich aber mit perldoc ganz normal
> > ansehen.
>
> Kann mir da vielleicht jemand helfen?
>

Was ist genau dein Problem? Die Warnungen? Oder sind die beiden
Dokumente nicht richtig verlinkt?

Gruß,
Slaven

--
Slaven Rezic - slaven rezic de

Dump a Tk canvas as an xfig file:
http://search.cpan.org/search?mode=module&query=Tk::CanvasFi g

Re: Fehler in pod2html

Slaven Rezic:

> Was ist genau dein Problem? Die Warnungen? Oder sind die beiden
> Dokumente nicht richtig verlinkt?

Offen gestanden, ist mir der Sinn von L<> nicht ganz klar.
Ich hatte soweit verstanden, dass man damit, wie in perlpod
behauptet wird, Hyperlinks definieren kann, und zwar sowohl
innerhalb des eigenen Dokumentes, als auch zu Externen.

Nun wurde hier schon festgestellt, dass ein Navigieren in dem
von perldoc erzeugten Output nicht möglich ist, was IMHO
die Einsatzmöglichkeiten der Direktive schon stark einschränkt,
denn ich behaupte mal, in 99% aller Fälle wird pod-Doku wohl
mit perldoc angesehen werden. Ich hätte eigentlich erwartet,
dass damit zumindest ein Anspringen von entsprechend gekenn-
zeichneten Abschnitten möglich sein sollte, ähnlich wie

perldoc -f

direkt zu in perlfunc springt.

Nun gibt es "Frontends", die aus pod auch anderen Output
(HTML, LaTeX) machen können. Der HTML-Frontend
baut aus L korrekte Verweise, wenn im selben
Dokument ein solcher mittels =head oder =item im
Dokument existiert. Man muss zwar ein bisschen nachhelfen,
aber es geht. Auch noch verständlich.

Nun gibt es aber auch die Syntax

L, die lt. perlpod:

Link to a Perl manual page (e.g., "L"). Note that
"name" should not contain spaces. This syntax is also occa-
sionally used for references to UNIX man pages, as in
"L".

einen Verweis auf eine man-page (die natürlich existieren
muss), anlegt.

Ich habe gesehen, dass in den diversen perlxxxx.pod Seiten
immer wieder auf andere Doku referenziert wird, und wollte
das in meiner eben auch machen, zB.:

Für weitere Informationen über Referenzen siehe L.

und hätte erwartet, dass in meinem HTML-Dokument beim
Anklicken des Verweises dann entweder

o) aus perlref on the fly eine HTML-Seite generiert und diese
ausgegeben wird, oder

o) perlref so, als normales Textdokument dargestellt wird.

Es passiert aber weder das eine noch das andere, es wird
überhaupt kein Verweis erzeugt, sondern (hier):

Für weitere ....siehe perlref.

und es kommt die erwähnte "cannot resolve" Fehlermeldung.

Daher meine Frage nach dem Sinn von L bzw.
ganz allgemein nach den Einsatzmöglichkeiten (und der
richtigen Syntax) dieser Direktive in pod-Dokumenten.
Unter welchen Umstäden macht es dann überhaupt noch
Sinn, aus pod Dokumenten heraus andere Dokumente zu
referenzieren?

LG, Ferry
--
Ing Ferry Bolhar
Magistrat der Stadt Wien - MA 14
A-1010 Wien
E-Mail: bol@adv.magwien.gv.at

Re: Fehler in pod2html

Ferry Bolhar schrieb:
> Hallo,
>
> ich hatte diese Frage zwar schon mal gepostet, aber ganz am Ende
> eines anderen Threads, sodass die Gefahr besteht, dass sie der eine
> oder andere vielleicht überlesen hat. Daher wiederhole ich sie hier
> mit der Bitte um Hilfe:
>
>> Eine zweite Frage noch: wenn ich zB. mit
>>
>> Zu Referenzen siehe auch L und L.
>>
>> externe Doku referenzieren möchte, sagt mir pod2html
>>
>> testdoc.pod: cannot resolve L in paragraph 78.
>> testdoc.pod: cannot resolve L in paragraph 78.
>>
>> Beide Dokumente kann man sich aber mit perldoc ganz normal
>> ansehen.
>
> Kann mir da vielleicht jemand helfen?

Wie wäre es mit den Optionen "--podroot" und "--podpath"?
Wenn die sauber gesetzt sind, findet pod2html auch alle
verlinkten Pods (achtung: die Verzeichnisse in podpath
sind _relativ_ zu podroot). Wenn ich hier etwas wie
L im text habe und dann
pod2html --podroot C:/perl588/lib --podpath .:Pod \
--infile myfile.pm --outfile myfile.html
drüber laufen lasse, werden auch die Links (fast)
ordnungsgemäß gesetzt.

Die Verlinkung mittels --htmlroot und --htmldir sauber ins
HTML zu bekommen, sollte dann eine einfach Fleißaufgabe sein.

-Christian

Re: Fehler in pod2html

"Ferry Bolhar" writes:

> Slaven Rezic:
>
> > Was ist genau dein Problem? Die Warnungen? Oder sind die beiden
> > Dokumente nicht richtig verlinkt?
>
> Offen gestanden, ist mir der Sinn von L<> nicht ganz klar.
> Ich hatte soweit verstanden, dass man damit, wie in perlpod
> behauptet wird, Hyperlinks definieren kann, und zwar sowohl
> innerhalb des eigenen Dokumentes, als auch zu Externen.
>
> Nun wurde hier schon festgestellt, dass ein Navigieren in dem
> von perldoc erzeugten Output nicht möglich ist, was IMHO
> die Einsatzmöglichkeiten der Direktive schon stark einschränkt,
> denn ich behaupte mal, in 99% aller Fälle wird pod-Doku wohl
> mit perldoc angesehen werden.

Ich glaube, du unterschätzt die Verfügbarkeit von Perl-Dokumentation
als Hypertext. Es gibt z.B. populäre Webseiten wie search.cpan.org
oder perldoc.perl.org. Dort funktioniert die Querverlinkung. Und ich
bin mir ziemlich sicher (obwohl ich gerne dafür eine Bestätigung
hätte), dass ActivePerl die Perl-Dokumentation hypertextfähig
anbietet, entweder als HTML oder in einem anderen Hypertextformat.

Ich persönlich muss mir in 90% aller Fälle die Doku mit tkpod
anschauen :-)

> Ich hätte eigentlich erwartet,
> dass damit zumindest ein Anspringen von entsprechend gekenn-
> zeichneten Abschnitten möglich sein sollte, ähnlich wie
>
> perldoc -f
>
> direkt zu in perlfunc springt.

Das ist mir nicht klar. Wenn du einen L<...>-Referenz hast, dann
verwendet man doch einfach

perldoc

?

>
> Nun gibt es "Frontends", die aus pod auch anderen Output
> (HTML, LaTeX) machen können. Der HTML-Frontend
^^^
Es gibt nicht ein einziges HTML-Frontend. Im CPAN tummeln sich einige
Module, die von Pod nach HTML konvertieren können.

> baut aus L korrekte Verweise, wenn im selben
> Dokument ein solcher mittels =head oder =item im
> Dokument existiert. Man muss zwar ein bisschen nachhelfen,
> aber es geht. Auch noch verständlich.
>
> Nun gibt es aber auch die Syntax
>
> L, die lt. perlpod:
>
> Link to a Perl manual page (e.g., "L"). Note that
> "name" should not contain spaces. This syntax is also occa-
> sionally used for references to UNIX man pages, as in
> "L".
>
> einen Verweis auf eine man-page (die natürlich existieren
> muss), anlegt.
>
> Ich habe gesehen, dass in den diversen perlxxxx.pod Seiten
> immer wieder auf andere Doku referenziert wird, und wollte
> das in meiner eben auch machen, zB.:
>
> Für weitere Informationen über Referenzen siehe L.
>
> und hätte erwartet, dass in meinem HTML-Dokument beim
> Anklicken des Verweises dann entweder
>
> o) aus perlref on the fly eine HTML-Seite generiert und diese
> ausgegeben wird, oder

Dazu gibt es Module, die on-the-fly mit Hilfe eines Webservers
HTML-Seiten aus Pod erzeugen, z.B. Apache::Pod::HTML.

>
> o) perlref so, als normales Textdokument dargestellt wird.
>
> Es passiert aber weder das eine noch das andere, es wird
> überhaupt kein Verweis erzeugt, sondern (hier):
>
> Für weitere ....siehe perlref.

>
> und es kommt die erwähnte "cannot resolve" Fehlermeldung.
>
> Daher meine Frage nach dem Sinn von L bzw.
> ganz allgemein nach den Einsatzmöglichkeiten (und der
> richtigen Syntax) dieser Direktive in pod-Dokumenten.
> Unter welchen Umstäden macht es dann überhaupt noch
> Sinn, aus pod Dokumenten heraus andere Dokumente zu
> referenzieren?

Wie gesagt, es hängt vom Frontend ab. Es gibt z.B. pods2html (mit
Plural-s), welches für mehrere Pods die HTML-Seiten erzeugt und
wahrscheinlich die Querverlinkungen zwischen diesen Pods richtig
erzeugt, aber alle anderen Verweise unbearbeitet lässt. Es gibt
Frontends, denen man nur sagen muss, wo sich die HTML-Dokumentation
befindet (--base), und man bekommt Links erzeugt, muss aber dafür
sorgen, dass sich an dieser Stelle tatsächlich schon ein Dokument
befindet.

Gruß,
Slaven

--
Slaven Rezic - slaven rezic de

tkruler - Perl/Tk program for measuring screen distances
http://ptktools.sourceforge.net/#tkruler

Re: Fehler in pod2html

Slaven Rezic schrieb:

> Ich glaube, du unterschätzt die Verfügbarkeit von Perl-Dokumentation
> als Hypertext. Es gibt z.B. populäre Webseiten wie search.cpan.org
> oder perldoc.perl.org. Dort funktioniert die Querverlinkung. Und ich
> bin mir ziemlich sicher (obwohl ich gerne dafür eine Bestätigung
> hätte), dass ActivePerl die Perl-Dokumentation hypertextfähig
> anbietet, entweder als HTML oder in einem anderen Hypertextformat.

Die Bestätigung: Komplett in HTML. ..\Perl\html\...

Gruß,
Peter

Re: Fehler in pod2html

Slaven Rezic:

> Ich glaube, du unterschätzt die Verfügbarkeit von Perl-Dokumentation
> als Hypertext. Es gibt z.B. populäre Webseiten wie search.cpan.org
> oder perldoc.perl.org. Dort funktioniert die Querverlinkung. Und ich
> bin mir ziemlich sicher (obwohl ich gerne dafür eine Bestätigung
> hätte), dass ActivePerl die Perl-Dokumentation hypertextfähig
> anbietet, entweder als HTML oder in einem anderen Hypertextformat.

Als HTML. Es wäre interessant zu wissen, wie diese Dokumentation
(die aus den jeweiligen .pod-Dokumenten stammt) erstellt wurde.

> Ich persönlich muss mir in 90% aller Fälle die Doku mit tkpod
> anschauen :-)

Ich nur mit POD, vielleicht führt das zu falschen Schlüssen.

>> Ich hätte eigentlich erwartet,
>> dass damit zumindest ein Anspringen von entsprechend gekenn-
>> zeichneten Abschnitten möglich sein sollte, ähnlich wie
>>
>> perldoc -f
>>
>> direkt zu in perlfunc springt.
>
> Das ist mir nicht klar. Wenn du einen L<...>-Referenz hast, dann
> verwendet man doch einfach
>
> perldoc

Vielleicht habe ich mich unklar ausgedrückt. Es geht um das
Anspringen eines Abschnittes in einem Dokument von einer
anderen Stelle innerhalb dieses Dokumentes aus. Aber ich sehe
schon, dass das mit perldoc/*roff/man nicht vorgesehen
und L<> nur für Output, der in navigierfähigen Tools dargestellt
wird, gedacht ist. Darauf sollte man allerdings in perlpod
deutlich hinweisen; die Doku läßt nicht vermuten, dass L<>
mit perldoc bzw. pod2man eigentlich nutzlos ist.

>> Nun gibt es "Frontends", die aus pod auch anderen Output
>> (HTML, LaTeX) machen können. Der HTML-Frontend
> ^^^
> Es gibt nicht ein einziges HTML-Frontend. Im CPAN tummeln sich einige
> Module, die von Pod nach HTML konvertieren können.

Danke für den Hinweis, ich werde mich mal dort umsehen.

Was mir in der Doku zu Pod::Html (das von pod2html
verwendet wird) fehlt, sind eben Hinweise, wie solche
speziellen Direktiven wie L<> und X<> verarbeitet werden
(bzw. im Falle von Pod::Man bzw. pod2man, dass sie über-
haupt nicht verarbeitet werden). Generell sollte jeder pod-
Konverter IMHO beschreiben, wie er mit pod-Direktiven
umgeht (und auch Möglichkeiten zum Eingreifen in diesen
Ablauf vorsehen).

Und dass natürlich Fehler oder Warnungen, die durch das
Modul ausgegeben werden können, entsprechend beschrieben
sind!

Die Frage, die nach wie vor für mich offen ist, ist eben,
inwieweit die Verwendung von zB. "Siehe L..."
in pod-Dokumenten, die nach HTML konvertiert werden,
Sinn macht bzw. wie man L<> sinnvoll verwendet.

LG, Ferry

--
Ing Ferry Bolhar
Magistrat der Stadt Wien - MA 14
A-1010 Wien
E-Mail: bol@adv.magwien.gv.at

Re: Fehler in pod2html

Peter Arnhold writes:

> Slaven Rezic schrieb:
>
> > Ich glaube, du unterschätzt die Verfügbarkeit von Perl-Dokumentation
> > als Hypertext. Es gibt z.B. populäre Webseiten wie search.cpan.org
> > oder perldoc.perl.org. Dort funktioniert die Querverlinkung. Und ich
> > bin mir ziemlich sicher (obwohl ich gerne dafür eine Bestätigung
> > hätte), dass ActivePerl die Perl-Dokumentation hypertextfähig
> > anbietet, entweder als HTML oder in einem anderen Hypertextformat.
>
> Die Bestätigung: Komplett in HTML. ..\Perl\html\...
>

Danke!

--
Slaven Rezic - slaven rezic de

Lost in your Tk widget tree? Try
http://user.cs.tu-berlin.de/~eserte/src/perl/Tk-WidgetDump/

Re: Fehler in pod2html

"Ferry Bolhar" writes:

> Slaven Rezic:
>
[...]
> >> Ich hätte eigentlich erwartet,
> >> dass damit zumindest ein Anspringen von entsprechend gekenn-
> >> zeichneten Abschnitten möglich sein sollte, ähnlich wie
> >>
> >> perldoc -f
> >>
> >> direkt zu in perlfunc springt.
> >
> > Das ist mir nicht klar. Wenn du einen L<...>-Referenz hast, dann
> > verwendet man doch einfach
> >
> > perldoc
>
> Vielleicht habe ich mich unklar ausgedrückt. Es geht um das
> Anspringen eines Abschnittes in einem Dokument von einer
> anderen Stelle innerhalb dieses Dokumentes aus. Aber ich sehe
> schon, dass das mit perldoc/*roff/man nicht vorgesehen
> und L<> nur für Output, der in navigierfähigen Tools dargestellt
> wird, gedacht ist. Darauf sollte man allerdings in perlpod
> deutlich hinweisen; die Doku läßt nicht vermuten, dass L<>
> mit perldoc bzw. pod2man eigentlich nutzlos ist.

Das ist wieder die eingeengte Denkweise. Bei der Pod-Konvertierung
kann man beispielsweise als Endformat etwas wählen, das schließlich
auf Papier gedruckt wird. Man würde nicht unbedingt erwarten, dass
hier Hyperlinks funktionieren (außer vielleicht in der Form von
Fußnoten, die auf andere Seiten verweisen). Und bei einem Programm,
welches offensichtlich $PAGER verwendet, würde man auch nicht
erwarten, dass Hyperlinks irgendwie automatisch funktionieren. Das tut
es bei man(1) auch nicht.

>
> >> Nun gibt es "Frontends", die aus pod auch anderen Output
> >> (HTML, LaTeX) machen können. Der HTML-Frontend
> > ^^^
> > Es gibt nicht ein einziges HTML-Frontend. Im CPAN tummeln sich einige
> > Module, die von Pod nach HTML konvertieren können.
>
> Danke für den Hinweis, ich werde mich mal dort umsehen.
>
> Was mir in der Doku zu Pod::Html (das von pod2html
> verwendet wird) fehlt, sind eben Hinweise, wie solche
> speziellen Direktiven wie L<> und X<> verarbeitet werden
> (bzw. im Falle von Pod::Man bzw. pod2man, dass sie über-
> haupt nicht verarbeitet werden). Generell sollte jeder pod-
> Konverter IMHO beschreiben, wie er mit pod-Direktiven
> umgeht (und auch Möglichkeiten zum Eingreifen in diesen
> Ablauf vorsehen).
>
> Und dass natürlich Fehler oder Warnungen, die durch das
> Modul ausgegeben werden können, entsprechend beschrieben
> sind!
>
> Die Frage, die nach wie vor für mich offen ist, ist eben,
> inwieweit die Verwendung von zB. "Siehe L..."
> in pod-Dokumenten, die nach HTML konvertiert werden,
> Sinn macht bzw. wie man L<> sinnvoll verwendet.
>

Die meisten Pod-zu-HTML-Konverter sind für die Massenumwandlung der
Standard-Perl-Dokumentation nach HTML optimiert. Bei pods2html oder
mpod2html kann man ein gesamtes Pod-Verzeichnis (oder gar den gesamten
@INC-Pfad) nach HTML konvertieren lassen. In diesem Fall funktioniert
die Link-Auflösung, weil die Konverterprogramme wissen, wo sich die
Linkziele befinden bzw. befinden werden.

Du hast anscheinend den Spezialfall, dass Links sowohl zu deinen
eigenen Seiten als auch zu der Standard-Perl-Dokumentation
funktionieren sollen. Funktionieren würde, wenn du auch hier die
komplette Perl-Dokumentation zusammen mit deinen Dateien umwandeln
lässt. Das ist natürlich aufwändig. Schöner wäre eine Lösung, die bei
Links auf die Perl-Dokumentation externe http-Links erzeugen würde,
z.B. auf perldoc.perl.org oder search.cpan.org (www.perldoc.com gibt
es leider nicht mehr). Leider kenne ich so eine Lösung nicht. Aber es
gibt ja nicht nur die Skripte, die Pod::*-Module warten nur darauf,
verwendet zu werden.

Gruß,
Slaven

--
Slaven Rezic - slaven rezic de

sf-upload: make batch releases on SourceForge
http://sf-upload.sf.net

Re: Fehler in pod2html

"Ferry Bolhar" writes:

[...]
> Die Frage, die nach wie vor für mich offen ist, ist eben,
> inwieweit die Verwendung von zB. "Siehe L..."
> in pod-Dokumenten, die nach HTML konvertiert werden,
> Sinn macht bzw. wie man L<> sinnvoll verwendet.

Nachtrag: ich habe gerade entdeckt, dass man sämtliche
CPAN-Dokumentation auf search.cpan.org durch Benutzung des folgenden
URL-Formats verlinken kann:

http://search.cpan.org/perldoc?Modulename

Also z.B.:

http://search.cpan.org/perldoc?Tk%3A%3APod

Das muss man nur noch den Pod2HTML-Konvertern beibringen...

Gruß,
Slaven

--
Slaven Rezic - slaven rezic de

tkrevdiff - graphical display of diffs between revisions (RCS, CVS or SVN)
http://ptktools.sourceforge.net/#tkrevdiff