Re: Portmaster - unklare manpage

On Wed, 06 Feb 2013 18:13:58 +0100, Heino Tiedemann wrote:
> Gerhard Brauer <gb+ML-2011(at)derbrauer.homelinux.net> wrote:
> > Oder einfach nur verwirrend?
>
>
> Unix manpages halt.
>
> Ich habe sie nie gemocht. Allein wegen des eklatenten mangels an
> beispielen.

Naja, Manpages sind vordergründig Referenzen. Sie sollen
(bei Programmen) die Optionen erklären. Viele Manpages
erläutern allgemeine Verfahrensweisen im Umgang mit dem
Programm (in generischer Weise), und manche fügen auch
Beispiele an. In "man portmaster" sind einige zu finden,
aber natürlich können die nicht "die Welt des Möglichen"
abdecken. :-)

Zumindest die häufigsten Anwendungsfälle (sogar mit
"Nebenschauplätzen") deckt EXAMPLES in "man portmaster"
ab, das ist schonmal gut.

> > Manpages können echt grausam
> > sein <g>... Und leider kann man sich mit den manpages nicht so wichtig
> > machen wie z.B. früher ein Netware-Admin im weißen Kittel mit 1-3
> > Novell-leitordnern unterm Arm ;-)
>
>
> Doch kann man, hat man den Mist mal verstanden, ist man schon wer.

Nur, wenn man auch ein buntes Papier an der Wand hat,
auf dem das draufsteht. :-)

> aber warum macht man diese manpages nicht mal "user fiendly"?

So gemein das klingt: Weil eine Manpage kein Howto ist,
und auch kein benutzergeneriertes Wiki mit Autoren aus
aller Welt. :-)

Aber im Ernst: Es gibt durchaus Manpages, deren Qualität
kaum noch zu unterbieten ist, und damit meine ich nicht
die, die auf das "info"-Manual verweisen. Wiederum andere
Programme haben gar keine lokal verfügbare Dokumentation
(besonders in der GUI-Welt vertreten, obwohl es da auch
Ausnahmen gibt, denke einfach "man opera").

Das sage ich in meiner Eigenschaft als Mensch mit roten Novell-
Büchern auf'm Regal, die geringschätzig auf mich herabsehen. :-)

-- 
Polytropon
Magdeburg, Germany
Happy FreeBSD user since 4.0
Andra moi ennepe, Mousa, ...
To Unsubscribe: send mail to majordomo(at)de.FreeBSD.org
with "unsubscribe de-bsd-questions" in the body of the message