yum man page fixes (was Re: up2date)

[camille zavala]

>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/