LWN.net Logo

Red Hat RPM Guide released

Red Hat has released a new, extensive guide to the RPM package manager under the Open Publication License. It probably belongs in the bookmarks of anybody who manages an RPM-based system.
(Log in to post comments)

Great step, but finish it please!

Posted Nov 3, 2005 19:14 UTC (Thu) by bastiaan (guest, #5170) [Link]

I've always found it strange that RedHat so poorly documented such a central piece of software as RPM. So, I very much welcome this effort to improve the situation.
However, this document is still incomplete, inprecise and already obsolete at certain points. A few examples:
* in the 'Extending RPM Management' section no mention of yum whatsoever!? It discusses obsolete tools like apt-rpm and autoupdate instead.
* still no complete DTD for the RPM spec file.
* section 22.1 talks about the obsolete 'copyright' tag instead of 'licenses'
* the same section talks about the 'epoch', but lacks a clear definition.
* most parts of chapter 22 just give examples of tags but no definitions or complete syntax.
* chapter 22 doesn't mention some tags or qualifiers at all. For example '%ghost', '%attr', '%config(noreplace)', triggers.
* section 3.2.2.2 does mention '%config(noreplace)' briefly, but fails to clarify wether (noreplace) needs to be in the old package, new package, either or both for the policy to apply.

I know this still is a draft, but judging from the content it appears to have been a draft for a rather long time :-( Also the fact that the revision histoy shows only one checkin a month ago is not a very good sign.

Please RedHat complete the guide!

Regards,

Bastiaan

Great step, but finish it please!

Posted Nov 3, 2005 19:21 UTC (Thu) by pnasrat (subscriber, #31781) [Link]

The plan is to update it - this is merely what was published in book format with errata.

The work so far has been conversion - interested contributors should see the fedora-docs-list, where I'll be organising the editorial and content update process.

Great step, but finish it please!

Posted Nov 3, 2005 22:07 UTC (Thu) by bastiaan (guest, #5170) [Link]

Ah, I see. The 2005 copyright made me think the content was written this year , rather than 2003 mostly.
Well, I'll be happy to contribute (if only snippets and comments).


Great step, but finish it please!

Posted Nov 4, 2005 21:01 UTC (Fri) by rahulsundaram (subscriber, #21946) [Link]

fedora-docs list would be a good place to start for interested contributors

http://fedora.redhat.com/projects/docs/

Copyright © 2005, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds