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. Ich 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, mit einem gutem inhaltsverzeichnis und guter suchfunktion, wo die inhalte sehr stark querverlinkt sind, es 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). Das ist mehr als nur ein paar textdateien mit formatierung. Ich 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.

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.

@ptk: ich bin kein "unixprogrammierer", und habe nicht vor einer zu werden, ich lege wert auf gute beschreibung, nichtkryptische namen usw. wenn ich programmiere, dann ist es sowieso nicht so lowlevel, dass es eine rolle spielen würde ob es unix, linux, win oder sonstwas ist. wobei ich an-skripten-rumhacken nicht als programmieren bezeichnen würde, sondern als skripten. Als 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)

@pq: als referenz ist die perdoku ok, denn wenn du genau weißt, was du suchst und wie es heißt, sollte es selbstverständlich sein, dass du es schnell findest. aber eine dokumentation ist mehr als nur eine referenz.

Klärung: ich habe mich etwas unpräzise ausgedrückt mit html meinte ich eigentlich hypertext, also querverweise. ich meine nicht die html-syntax.

@ptk: was meinst du mit use english?

Gruß,
-Lev