Steve` said:
Ich persönlich finde Hinweise auf Man-pages unhöflich, solange sie nicht mit Folgeerklärungen versehen werden.
Wieso? In den meisten Faellen besteht die Loesung genau darin, die genannte Manpage zu lesen. Warum soll man da noch zusaetzlich noch etwas erklaeren?
Natürlich ergibt sich vieles aus der Manpage, aber dann könnte man das Forum fast vollständig einstampfen. Ich finde Antworten optimal, in denen auf eine Manpage hingewiesen wird, der entsprechende Passus zitiert und dann mit eigenen Worten erläutert wird.
Das Forum als Hilfe fuer Leute mit Leseschwaeche? Sorry, aber es gibt (hier und auch in diversen Mailinglisten und Newsgroups) genug Probleme, die eben nicht mit einem Hinweis auf ein paar Manpages erledigt sind. Andererseits gibt es auch mehr als genug Leute, denen man beim besten Willen ersmal ein man man(1) vor den Bug knallen sollte, ggf. mit einem Hinweis auf die huebsche Option '-k'.
Nur so kann man Fragestellern die Manpages nahebringen und zeigen, dass die Erklärungen dort wirklich zu finden sind. Mal ganz davon abgesehen, dass viele Manpages wirklich schmerzhaft umfangreich sind.
Wenn Du den Leuten fertige Loesungen bietest, werden sie den Hinweis auf die Manpage ignorieren und einfach Copy & Paste verwenden. Himmel, ich habe schon mal jemandem einen Link auf eine Referenzdoku (in diesem Fall kein Unix-Geraffel, sondern Java-APIs) geschicht, und er war zu faul, draufzuklicken (haette er es getan, dann haette er auch eingesehen, dass sein Code falsch war). Klarer Fall von Dokuphobie.
Zum Umfang: ksh: ca. 41 Seiten. Dafuer steht dann auch alles drin, und die ksh ist kein triviales Propramm. Vielleicht muss man das Teil zwei oder auch drei mal lesen, um halbwegs durchzusteigen, aber es geht. Und wem das zu anstrengend ist (i.e. echte Unix-Newbies), der sollte sich sowieso ein einfuehrendes Buch besorgen.
Noch ein Beispiel: awk(1): 4 Seiten. Ja, die Manpage setzt voraus, dass man re_format(7), printf(7) kennt, und in C-Expressions einigermassen fit ist. Aber da Unix benutzerfreundlich ist, wird in der Section "SEE ALSO" auch gleich auf weiterfuehrende Literatur hingewiesen.