Opened by Gast at 2005-07-21 04:47
Grr.
[quote=Lev,21.07.2005, 23:54]Nun ja wenn man die doku erst durchgrepen muss um da was zu finden ist es nicht gerade ein zeichen dafür dass sie gut ist.
[/quote]
Wenn du den Teil nicht gefunden hast, wo der Index ist, ist das nicht gerade ein Zeichen dafür, dass du gut gesucht hast ;)
Index *wovon*? Perl ist ein bißchen zu umfangreich, um einen kompletten Index zu haben. Das ist etwas umfangreicher als eine einfache Beschreibung der Funktionen.
"man perl" oder "perldoc perl". Oder http://perldoc.perl.org/ wenn man denn mal Google bemüht hätte.
perldoc -q sucht die (immer mitgelieferten!) FAQs ab, perldoc-r für rekursive Suche, perldoc -f bringt eine Beschreibung der jeweiligen Funktion.
Die Links sind enthalten. Siehe http://perldoc.perl.org/
Da sehe ich keine Probleme. PODs sind meist recht gut bestückt mit Beispielen.
POD ist mächtig genug um dir auch ein paar bunte HTML Seiten mit Formatierung zu produzieren.
Das könnte das Problem sein ;)
[quote]Ich will hier auch nicht die leistung der autoren aberkennen: klar ist das ein mordsjob eine doku zu schreiben, die einigermassen vollständig ist. sie sache ist nur die, dass diese beschreibungen, anders verpackt, mit querverweisen, mit index usw... die produktivität sehr erhöhen würden. [/quote ]
- no comment this time -
Stimmt schon, intuitiv wie Sau ..
Das gibt noch nen Abzug in der B-Note. Hast du die Perl-Dokumentation überhaupt schonmal angesehen?
[quote=Lev,21.07.2005, 23:54]Nun ja wenn man die doku erst durchgrepen muss um da was zu finden ist es nicht gerade ein zeichen dafür dass sie gut ist.
[/quote]
Wenn du den Teil nicht gefunden hast, wo der Index ist, ist das nicht gerade ein Zeichen dafür, dass du gut gesucht hast ;)
QuoteIch habe nicht die quantität bemängelt, sondern die qualität, wobei ich auch nicht die qualität der einzelnen beschreibungen meine. Ich bin halt verwöhnt von einem hilfe_system_ mit gutem index,
Index *wovon*? Perl ist ein bißchen zu umfangreich, um einen kompletten Index zu haben. Das ist etwas umfangreicher als eine einfache Beschreibung der Funktionen.
Quotemit einem gutem inhaltsverzeichnis
"man perl" oder "perldoc perl". Oder http://perldoc.perl.org/ wenn man denn mal Google bemüht hätte.
Quoteund guter suchfunktion,
perldoc -q sucht die (immer mitgelieferten!) FAQs ab, perldoc-r für rekursive Suche, perldoc -f bringt eine Beschreibung der jeweiligen Funktion.
Quotewo die inhalte sehr stark querverlinkt sind,
Die Links sind enthalten. Siehe http://perldoc.perl.org/
Quotees gibt anschauliche beispiele zu vielen nichttrivialen zusammenhängen, und die erklärungen gehen nicht davon aus, dass vor dem bildschirm ein nerd sitzt (was nicht heißen sollte dass sie für dummies geschrieben sind, es gibt eine gesunde mitte).
Da sehe ich keine Probleme. PODs sind meist recht gut bestückt mit Beispielen.
QuoteDas ist mehr als nur ein paar textdateien mit formatierung.
POD ist mächtig genug um dir auch ein paar bunte HTML Seiten mit Formatierung zu produzieren.
QuoteIch brauche ewig, um in der perldoku was zu finden, dabei find ich sogar in der java-doku (von der ich auch nicht superbegeistert bin) sie sachen recht fix.
Das könnte das Problem sein ;)
[quote]Ich will hier auch nicht die leistung der autoren aberkennen: klar ist das ein mordsjob eine doku zu schreiben, die einigermassen vollständig ist. sie sache ist nur die, dass diese beschreibungen, anders verpackt, mit querverweisen, mit index usw... die produktivität sehr erhöhen würden. [/quote ]
- no comment this time -
QuoteAls unixprogrammierer benutzt man C/C++ und dort gibt es keine kryptischen vordefinierten variablen (okay hardwarenahen sachen in C sind nicht unbedingt selbsterklärend, aber das ist bei hardwarenahen sachen okay)
Stimmt schon, intuitiv wie Sau ..
Quote@ptk: was meinst du mit use english?
Das gibt noch nen Abzug in der B-Note. Hast du die Perl-Dokumentation überhaupt schonmal angesehen?