Hallo, On Sat, 05 Jul 2003, toRBEN pOLLmann schrieb:
Also nun muss ich mir mal was von der Seele schreiben:
Ich bin zwar drastisch Linux interessiert, lernbeGIERig und auch ein Stueck weit detektivisch veranlagt, aber:
Das ist schoen ;)
Warum in aller Welt sind in den man / info Pages meist keine, oft nur ein einziges und dann noch nichtssagende Beispiele?
Das gibt's leider. Die Doku ist zwar in der Regel ausreichend bis sehr gut, aber manchmal eben auch etwas arg knapp. Allerdings sind die meisten Befehle mit "kryptischer" Doku auch nicht fuer Anfaenger geeignet. Das gesagte gilt allerdings nicht fuer GUI Zeug, v.a. bei KDE und GNOME ist die Doku oft sehr schlecht.
Ich nenne mal ein Beispiel: Wenn man von DOS kommt, dann ist date ne feine Sache. Weit gefehlt unter Linux. Kein Beispiel, und dann nur fuer Leute, die das wohl schon seit Unix 1969 machen, verstaendlich.
'date' ist ein gutes Beispiel fuer ein GNU-tool und deren Doku ist primaer die Info-page -- und bei date finden sich dort dann auch _einige_ Beispiele! Kleiner Tipp am Rande: falls info keine Seite findet, es aber eine manpage gibt, dann wird diese angezeigt (erkennt man dann schon). D.h. wenn du nicht weisst, ob du jetzt eher ne man- oder ne info-page suchen solltest, dann solltest du zuerst 'info foo' versuchen. 'wget' ist uebrigens auch noch ein Beispiel fuer die knappe man-page und die ausfuehrliche info-page.
Ich finde es super, dass es sowas wie diese Liste gibt (Nur von hier aus dem Archiv weiss ich dass mir date +'%A %d. %B %Y' den Tag mit vollstaendigem Datum ausgibt), aber die man / info Pages sind wirklich - man moege es mir nachsehen - aber aus Sicht eines Umsteigers unter aller S...
Fuer sowas ist primaer eigentliche Doku (in /usr/share/doc/packages/$name) und die HOWTOs zustaendig. manpages (und infopages) sind eine _Referenz_, ein "Katalog" in dem man schnell und kurz und knapp die Optionen (usw.) eines Befehls oder einer Funktion nachschauen kann. Zwar packt SuSE nicht immer alle moegliche Doku mit in die RPMs, das betrifft aber eigentlich immer nur die fuer Entwickler relevante Doku.
Und nochmal ganz deutlich: Wenn es trotz der angeblich so tollen man pages zu Fragen wie "Wie funktioniert date" kommt, dann weist das fuer mich ganz darauf hin, dass das man(ual) mangelhaft ist!
Wer arbeitet daran noch? Wird das noch eingearbeitet?
s.o. Achso, nochwas, wenn hier in der Liste ein "RTFM foo" kommt, dann ist das natuerlich erstmal die Aufforderung 'man foo' zu lesen, aber auch generell, sich mit 'foo' genauer zu beschaeftigen, z.B. schauen ob's evtl. noch ne info-page gibt, ob's Doku in /usr/share/doc/packages/foo gibt (siehe dazu auch die Ausgabe von 'rpm -qlf `which foo`'). Und bei den HOWTOs sollte man in etwa wissen welche es gibt, so dass man dann schon etwas gezielter suchen kann... -dnh -- 99: EDV Experimentelle Daten Verarbeitung (Andreas Frackowiak)