[Yum] Other formats for HOWTO, documentation in general

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



I'm getting a few requests for additional formats for the HOWTO -- SO I
fixed up the Makefile and it now automagically installs at least the
following:

  html,(US Letter,A4)x(PS,PDF),Text (badly), tarball of sgml sources

All of these formats are accessible from

  http://www.phy.duke.edu/~rgb/General/yum_HOWTO.php

Note that I >>still<< haven't had time to finish this off, although I'm
very close now -- my current pass is going to shorten it a lot and
finish off the section on actual yum commands.  Perhaps over TG break.

In the meantime, hopefully between the HOWTO (almost finished), the
article:

  http://www.phy.duke.edu/~rgb/General/yum_article.php

(finished, I suppose) and the man pages (which are the one authoritative
and up to date reference anyway:-) and this list, nobody feels totally
deprived of yum documentation as they start out using it.

The one thing yum is still missing (even in draft form) is a FAQ.
Anybody want to tackle this?  I'll do it, but probably not before next
year.

BTW, the FAQ should probably swallow Seth's short "Questions" section on
the yum site for starters, and then go on to things like 

  Q: What does it mean if yum complains that my rpmdb is corrupt?

  A: That your rpmdb is corrupt.  Yum will refuse to work with a corrupt
rpmdb as it is not safe to do so.  Maybe it's your fault it is corrupt
you wicked "rpm --force --nodeps" user you.  More likely your system
glitched while ths db was being actively written and it was left in a
corrupt state.  All you can do is try rpm --rebuilddb and pray.  If
prayer doesn't work, try threats.  If threats don't work, try
reinstalling...

See?  It can be fun and easy to write documentation!

   rgb

-- 
Robert G. Brown	                       http://www.phy.duke.edu/~rgb/
Duke University Dept. of Physics, Box 90305
Durham, N.C. 27708-0305
Phone: 1-919-660-2567  Fax: 919-660-2525     email:rgb@xxxxxxxxxxxx




[Index of Archives]     [Fedora Users]     [Fedora Legacy List]     [Fedora Maintainers]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]

  Powered by Linux