yum man page fixes (was Re: up2date)
camille zavala
camille_zavala at hotmail.com
Sun Oct 10 22:27:50 UTC 2004
>Pretty sure Seth takes patches... to both code and documentation.
I downloaded the SRPM thinking that I'd hack the sources, but I don't know
Python so I'm useless there.
Never mind, I can help with the documentation since I know troff. I'm
posting here so that if someone besides Seth knows the answer, you can
answer and save Seth some time.
What are all those zero-length characters doing in docs/yum.8 before the
periods? Usually \& appears only when the first character on the line is a
dot.
In the Synopsis command block, can I remove the deprecated "upgrade"
command? If it's truly deprecated we should remove its documentation, or at
least move it down to the bottom of the list. We also really should change
that "*deprecated*" and its comment to be in italics.
What's the organization of the list of commands in the Synopsis section?
The list should be alphabetical unless we're giving the reader a better,
more obvious ordering. (It doesn't seem obvious -- maybe I'm just stupid.)
Uh oh. "yum clean oldheaders" doesn't work on my FC3T2 system with all
updates as of today. It gives me a usage diagnostic. We should remove it
from the man page if it doesn't do that any more.
"yum clean" says it needs an option -- I'll change the docs.
I'm sure I'll have other questions, but i'll bring them up in a followup
message.
Cheers,
Camille
_________________________________________________________________
Express yourself instantly with MSN Messenger! Download today - it's FREE!
hthttp://messenger.msn.click-url.com/go/onm00200471ave/direct/01/
More information about the fedora-test-list
mailing list