Catherine Gramze schreef op 30-12-2016 4:32:
Ad hominem attacks now, Xen, since you cannot refute the simple
fact that man pages were designed to be a reference, not a
tutorial?
If the topic is attitudes, then those belong to people don't they?
You'll need examples, won't you?
You defend bad writing, period.
You don't explain, or you did, but you probably don't even take the time
to see what I actually mean by what I would call bad writing or what I
would call good writing.
Then you say you disagree with me, but it is not clear at all to me what
you are disagreeing with.
I do not need to refute the "simple fact" that man pages were designed
to be a reference. Their incumbent design has nothing to do with what
you can do with them, and they are designed just fine for writing good
man pages as well as bad ones.
So why the hell should I need to refute that? Are you out of your mind?
You think what someone else made them to be is more important than
anything else?
Really. I am quickly done here if you are going to be arguing like that,
because I am not arguing with add ad hominem attack here, if you will.
What you do is petulant and you yourself clearly can't stand the fact
that yes it is a weak argument and no it does not say anything about how
those man pages should be used.
My university technical writing course professor would disagree
with your evaluation of my writing ability. He saved my work to use as
examples for future classes of what he wants to see in technical
writing. And I am a programmer, too, one of a very few selected by
a professor to work in his IT consulting firm while still in grad
school. Yes, some people can both write and code.
Well, that's great. Now why do you use this position or this expertise
or background to kill efforts at improving man pages for ordinary
people?
If you do not know what a command basically does, a man page is not
the place to go. I am not familiar with aufs, but I learned from the
example of "bad writing" you posted that it is a filesystem utility,
that it loads things in a specific sequence that has to be kept in
mind when using the command, and that you wanted your specific
solution laid out for you in the man page instead of figuring it out
yourself.
That was not a specific solution dear lady. That was one of the two
commands every damn user uses.
You are beliggerent and yes I am quickly done here.