rpm-guide rpm-guide-advanced-packaging-en.xml, 1.1, 1.2 rpm-guide-command-reference-en.xml, 1.1, 1.2 rpm-guide-creating-rpms-en.xml, 1.1, 1.2 rpm-guide-customizing-rpm-en.xml, 1.1, 1.2 rpm-guide-dependencies-en.xml, 1.1, 1.2 rpm-guide-development-tools-en.xml, 1.1, 1.2 rpm-guide-extra-packaging-tools-en.xml, 1.1, 1.2 rpm-guide-licensing-en.xml, 1.1, 1.2 rpm-guide-management-software-en.xml, 1.1, 1.2 rpm-guide-online-resources-en.xml, 1.1, 1.2 rpm-guide-other-linuxes-en.xml, 1.1, 1.2 rpm-guide-other-os-en.xml, 1.1, 1.2 rpm-guide-package-structure-en.xml, 1.1, 1.2 rpm-guide-packaging-guidelines-en.xml, 1.1, 1.2 rpm-guide-programming-c-en.xml, 1.1, 1.2 rpm-guide-programming-perl-en.xml, 1.1, 1.2 rpm-guide-programming-python-en.xml, 1.2, 1.3 rpm-guide-rpm-evolution-en.xml, 1.1, 1.2 rpm-guide-rpm-overview-en.xml, 1.1, 1.2 rpm-guide-rpmbuild-en.xml, 1.1, 1.2 rpm-guide-scripting-en.xml, 1.1, 1.2 rpm-guide-specfile-syntax-en.xml, 1.1, 1.2 rpm-guide-specfiles-en.xml, 1.1, 1.2 rpm-guide-transactions-en.xml, 1.1, 1.2 rpm-gu! ide-using-rpm-db-en.xml,1.1,1.2 rpm-guide-using-rpm-en.xml,1.1,1.2
Stuart Ellis (elliss)
fedora-docs-commits at redhat.com
Wed Oct 26 01:54:14 UTC 2005
Author: elliss
Update of /cvs/docs/rpm-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv20760
Modified Files:
rpm-guide-advanced-packaging-en.xml
rpm-guide-command-reference-en.xml
rpm-guide-creating-rpms-en.xml
rpm-guide-customizing-rpm-en.xml rpm-guide-dependencies-en.xml
rpm-guide-development-tools-en.xml
rpm-guide-extra-packaging-tools-en.xml
rpm-guide-licensing-en.xml
rpm-guide-management-software-en.xml
rpm-guide-online-resources-en.xml
rpm-guide-other-linuxes-en.xml rpm-guide-other-os-en.xml
rpm-guide-package-structure-en.xml
rpm-guide-packaging-guidelines-en.xml
rpm-guide-programming-c-en.xml
rpm-guide-programming-perl-en.xml
rpm-guide-programming-python-en.xml
rpm-guide-rpm-evolution-en.xml rpm-guide-rpm-overview-en.xml
rpm-guide-rpmbuild-en.xml rpm-guide-scripting-en.xml
rpm-guide-specfile-syntax-en.xml rpm-guide-specfiles-en.xml
rpm-guide-transactions-en.xml rpm-guide-using-rpm-db-en.xml
rpm-guide-using-rpm-en.xml
Log Message:
Fixed chapter headings and intros
Index: rpm-guide-advanced-packaging-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-advanced-packaging-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-advanced-packaging-en.xml 4 Oct 2005 01:44:20 -0000 1.1
+++ rpm-guide-advanced-packaging-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,44 +1,42 @@
-<!-- $Id: -->
-<chapter id="ch-advanced-packaging">
-<title>Advanced RPM Packaging</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Defining package dependency information
- </para>
-
- <para>
- *Setting triggers
- </para>
-
- <para>
- *Writing verification scripts
- </para>
-
- <para>
- *Creating subpackages
- </para>
-
- <para>
- *Creating relocatable packages
- </para>
+<!-- $Id: -->
+<chapter id="ch-advanced-packaging">
+ <title>Advanced RPM Packaging</title>
<para>
- *Defining conditional builds
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Defining package dependency information
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Setting triggers
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Writing verification scripts
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Creating subpackages
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Creating relocatable packages
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Defining conditional builds
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
The previous chapter introduced the RPM spec file, which controls
how RPM packages are built and installed. This chapter delves into
@@ -46,7 +44,6 @@
making relocatable packages, starting with how to specify package
dependencies.
</para>
-
<sect1>
<title>Defining Package Dependencies</title>
<para>
@@ -416,7 +413,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Setting Triggers</title>
<para>
@@ -859,7 +855,6 @@
chmod 0400 /var/ftp/bin/bin.md5
</para>
</sect1>
-
<sect1>
<title>Writing Verification Scripts</title>
<para>
@@ -906,7 +901,6 @@
See Chapter 5 for more on package verification.
</para>
</sect1>
-
<sect1>
<title>Creating Subpackages</title>
<para>
@@ -1198,7 +1192,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Creating Relocatable Packages</title>
<para>
@@ -1341,7 +1334,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Defining Conditional Builds</title>
<para>
@@ -1653,7 +1645,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -1721,6 +1712,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-command-reference-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-command-reference-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-command-reference-en.xml 4 Oct 2005 01:45:44 -0000 1.1
+++ rpm-guide-command-reference-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,24 +1,26 @@
-<!-- $Id: -->
-<chapter id="ch-command-reference">
-<title>RPM Command Reference</title>
-
- <para>
- In This Appendix
- </para>
-
- <para>
- *rpm command
- </para>
+<!-- $Id: -->
+<chapter id="ch-command-reference">
+ <title>RPM Command Reference</title>
<para>
- *rpmbuild command
+ This appendix covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ rpm command
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ rpmbuild command
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
This appendix covers the syntax of the command-line options for the
rpm and rpmbuild commands.
</para>
-
<sect1>
<title>The rpm Command</title>
<para>
@@ -1704,7 +1706,6 @@
</informaltable>
</sect2>
</sect1>
-
<sect1>
<title>The rpmbuild Command</title>
<para>
@@ -2307,6 +2308,7 @@
</sect2>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
@@ -2314,4 +2316,3 @@
fill-column: 72
End:
-->
-
Index: rpm-guide-creating-rpms-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-creating-rpms-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-creating-rpms-en.xml 4 Oct 2005 01:48:20 -0000 1.1
+++ rpm-guide-creating-rpms-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,44 +1,42 @@
-<!-- $Id: -->
-<chapter id="ch-creating-rpms">
-<title>Creating RPMs: An Overview</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Preparing to build RPMs
- </para>
-
- <para>
- *Planning for RPMs
- </para>
-
- <para>
- *Explaining the build process
- </para>
-
- <para>
- *Using build files
- </para>
-
- <para>
- *Seeing the results
- </para>
+<!-- $Id: -->
+<chapter id="ch-creating-rpms">
+ <title>Creating RPMs: An Overview</title>
<para>
- *Verifying your RPMs
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Preparing to build RPMs
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Planning for RPMs
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Explaining the build process
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Using build files
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Seeing the results
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Verifying your RPMs
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
Thus far in this book, all the commands presented have been used to
manage or query packages. With this chapter, though, you start
@@ -47,7 +45,6 @@
use, if only for the ease of management that the RPM system
provides.
</para>
-
<para>
Creating RPMs allows you to create a consistent set of applications
for use on all systems in your organization and easily manage those
@@ -56,7 +53,6 @@
customize for your environment. Making RPMs of the customized
applications reduces work and makes the customizations consistent.
</para>
-
<para>
This chapter introduces the RPM system from the point of view of
creating RPMs and demonstrates the steps and planning necessary to
@@ -64,7 +60,6 @@
RPM-building topics covered in depth in the remaining chapters in
this part.
</para>
-
<sect1>
<title>Preparing to Build RPMs</title>
<para>
@@ -600,7 +595,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Building RPMs</title>
<para>
@@ -1555,7 +1549,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Verifying Your RPMS</title>
<para>
@@ -1647,7 +1640,6 @@
for more on the -V option.
</para>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -1674,6 +1666,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-customizing-rpm-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-customizing-rpm-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-customizing-rpm-en.xml 4 Oct 2005 01:48:57 -0000 1.1
+++ rpm-guide-customizing-rpm-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,32 +1,27 @@
-<!-- $Id: -->
-<chapter id="ch-customizing-rpm">
-<title>Customizing RPM Behavior</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Defining RPM macros
- </para>
-
- <para>
- *Configuring RPM settings
- </para>
+<!-- $Id: -->
+<chapter id="ch-customizing-rpm">
+ <title>Customizing RPM Behavior</title>
<para>
- *Adding popt aliases
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Defining RPM macros
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Configuring RPM settings
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Adding popt aliases
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
RPM provides a high degree of customization in the form of basic
settings, such as where your RPM database is located and the path to
@@ -35,7 +30,6 @@
ways to customize RPM behavior: RPM macros, RPM rc settings, and
popt aliases.
</para>
-
<sect1>
<title>Customizing with RPM Macros</title>
<para>
@@ -345,7 +339,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Configuring RPM Settings</title>
<para>
@@ -733,7 +726,6 @@
</sect3>
</sect2>
</sect1>
-
<sect1>
<title>Adding Popt Aliases</title>
<para>
@@ -949,7 +941,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -967,6 +958,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
@@ -974,4 +966,3 @@
fill-column: 72
End:
-->
-
Index: rpm-guide-dependencies-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-dependencies-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-dependencies-en.xml 4 Oct 2005 01:49:40 -0000 1.1
+++ rpm-guide-dependencies-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,42 +1,46 @@
-<!-- $Id: -->
-<chapter id="ch-dependencies">
-<title>Package Dependencies</title>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Understanding dependencies
- </para>
-
- <para>
- *Package capabilities
- </para>
-
- <para>
- *Version dependencies
- </para>
-
- <para>
- *Checking dependencies
- </para>
+<!-- $Id: -->
+<chapter id="ch-dependencies">
+ <title>Package Dependencies</title>
<para>
- *Triggers
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Understanding dependencies
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Package capabilities
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Version dependencies
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Checking dependencies
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Triggers
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
Packages aren’t built in a vacuum. Web applications, for example,
build on system networking libraries, system-encryption libraries,
and system-file input and output libraries.
</para>
-
<para>
This chapter covers dependencies between packages, along with ways
to discover and manage those dependencies.
</para>
-
<sect1>
<title>Understanding the Dependency Concept</title>
<para>
@@ -281,7 +285,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Checking for Dependencies</title>
<para>
@@ -1170,7 +1173,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Triggers</title>
<para>
@@ -1532,7 +1534,6 @@
package changes.
</para>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -1570,6 +1571,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
@@ -1577,4 +1579,3 @@
fill-column: 72
End:
-->
-
Index: rpm-guide-development-tools-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-development-tools-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-development-tools-en.xml 4 Oct 2005 01:50:09 -0000 1.1
+++ rpm-guide-development-tools-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,32 +1,27 @@
-<!-- $Id: -->
-<chapter id="ch-development-tools">
-<title>Linux Text Editors and Development Tools</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Appendix
- </para>
-
- <para>
- *General text editors
- </para>
-
- <para>
- *C-specific tools and integrated development environments
- </para>
+<!-- $Id: -->
+<chapter id="ch-development-tools">
+ <title>Linux Text Editors and Development Tools</title>
<para>
- *Python-specific development tools
+ This appendix covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ General text editors
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ C-specific tools and integrated development environments
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Python-specific development tools
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
Linux includes a number of text editors and integrated development
environments (IDEs), going from plain old text editors all the way
@@ -36,7 +31,6 @@
configuration data, so Linux has always included a number of text
editors.
</para>
-
<para>
This appendix lists a number of tools for those who have not yet set
up an RPM development environment on Linux. Note that choosing an
@@ -46,12 +40,10 @@
out what you have installed on your system and see if that works for
you.
</para>
-
<para>
Note that Internet sites may change or disappear, so you may have to
search to find these tools.
</para>
-
<sect1>
<title>General Text Editors</title>
<para>
@@ -84,7 +76,6 @@
Replace gedit with the editor you choose.
</para>
</sect1>
-
<sect1>
<title>Programming Text Editors</title>
<para>
@@ -115,7 +106,6 @@
www.ibm.com/java/jdk/ and select the IBM Developer Kit for Linux.
</para>
</sect1>
-
<sect1>
<title>Integrated Development Environments for C Programming</title>
<para>
@@ -148,7 +138,6 @@
www.eclipse.org/tools/downloads.html.
</para>
</sect1>
-
<sect1>
<title>Integrated Development Environments for Python Programming</title>
<para>
@@ -205,6 +194,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-extra-packaging-tools-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-extra-packaging-tools-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-extra-packaging-tools-en.xml 4 Oct 2005 01:51:52 -0000 1.1
+++ rpm-guide-extra-packaging-tools-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,28 +1,22 @@
-<!-- $Id: -->
-<chapter id="ch-extra-packaging-tools">
-<title>Supplemental Packaging Software</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Understanding packaging aids
- </para>
+<!-- $Id: -->
+<chapter id="ch-extra-packaging-tools">
+ <title>Supplemental Packaging Software</title>
<para>
- *Manipulating packages
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Understanding packaging aids
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Manipulating packages
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
RPM is intended to make system management easier, both for system
administrators and other users who do all the day-to-day work of
@@ -39,7 +33,6 @@
have less work ahead of them, since they need only concern
themselves with the first step.
</para>
-
<para>
After a packager has prepared an RPM package once, RPM makes the
first step (compilation and configuration) easier when the packager
@@ -56,7 +49,6 @@
same application, but once created, the RPM package takes less time
and effort to keep current than the gzipped tarball requires.
</para>
-
<sect1>
<title>Packaging Aids</title>
<para>
@@ -1452,7 +1444,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -1489,6 +1480,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-licensing-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-licensing-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-licensing-en.xml 4 Oct 2005 01:53:33 -0000 1.1
+++ rpm-guide-licensing-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,16 +1,7 @@
-<!-- $Id: -->
-<chapter id="ch-licensing">
-<title>Licensing RPM</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
+<!-- $Id: -->
+<chapter id="ch-licensing">
+ <title>Licensing RPM</title>
<para>
When incorporating someone else's existing code into your software
project, you should always examine the license of the code
@@ -20,7 +11,6 @@
This is true for commercial code and commercial projects, and it is
equally true for freely licensed code and free software projects.
</para>
-
<para>
RPM itself and most discussed helper applications (rpmlint,
rpm-spec-mode, and so forth) are free software, meaning that the
@@ -28,7 +18,6 @@
these tools are considered open source software, which means the
source code for the applications are also available.
</para>
-
<para>
These facts do not mean that they are unlicensed software, or that
their source code can be used in any desired fashion. RPM and these
@@ -46,9 +35,7 @@
GPL on your project, should you decide to use GPL'ed code in any
commercially licensed project you might undertake).
</para>
-
<para/>
-
<sect1>
<title>The GNU General Public License</title>
<para>
@@ -490,6 +477,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-management-software-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-management-software-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-management-software-en.xml 4 Oct 2005 01:54:10 -0000 1.1
+++ rpm-guide-management-software-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,32 +1,27 @@
-<!-- $Id: -->
-<chapter id="ch-management-software">
-<title>RPM Management Software</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Finding packages in RPM format
- </para>
-
- <para>
- *Graphical tools to manage RPM packages
- </para>
+<!-- $Id: -->
+<chapter id="ch-management-software">
+ <title>RPM Management Software</title>
<para>
- *Extending RPM management with additional tools
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Finding packages in RPM format
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Graphical tools to manage RPM packages
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Extending RPM management with additional tools
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
You can find a variety of software packages to ease the work of
managing RPM-based systems. These utilities can help you find a
@@ -38,12 +33,10 @@
with more recent versions or simplification of software installation
by automating installation of any required software dependencies.
</para>
-
<para>
This chapter covers a number of tools for finding packages in RPM
format, as well as tools to help manage the RPMs on your system.
</para>
-
<sect1>
<title>Locating RPMs</title>
<para>
@@ -670,7 +663,6 @@
</sect3>
</sect2>
</sect1>
-
<sect1>
<title>Graphical RPM Management</title>
<para>
@@ -965,7 +957,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Extending RPM Management</title>
<para>
@@ -2074,7 +2065,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -2118,6 +2108,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
@@ -2125,4 +2116,3 @@
fill-column: 72
End:
-->
-
Index: rpm-guide-online-resources-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-online-resources-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-online-resources-en.xml 4 Oct 2005 01:54:38 -0000 1.1
+++ rpm-guide-online-resources-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,33 +1,26 @@
-<!-- $Id: -->
-<chapter id="ch-online-resources">
-<title>RPM Resources</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Appendix
- </para>
-
- <para>
- *Finding RPM sites on the Internet
- </para>
+<!-- $Id: -->
+<chapter id="ch-online-resources">
+ <title>RPM Resources</title>
<para>
- *Accessing RPM newsgroups and mailing lists
+ This appendix covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Finding RPM sites on the Internet
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Accessing RPM newsgroups and mailing lists
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
This appendix covers the material available on the Internet for
working with RPM.
</para>
-
<sect1>
<title>Finding RPM Sites</title>
<para>
@@ -590,7 +583,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Accessing RPM Mailing Lists and Newsgroups</title>
<para>
@@ -613,6 +605,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-other-linuxes-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-other-linuxes-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-other-linuxes-en.xml 4 Oct 2005 01:55:12 -0000 1.1
+++ rpm-guide-other-linuxes-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,67 +1,59 @@
-<!-- $Id: -->
-<chapter id="ch-other-linuxes">
-<title>Using RPM on Non-Red Hat Linuxe</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Dealing with RPM issues on other versions of Linux
- </para>
-
- <para>
- *RPM standardization
- </para>
-
- <para>
- *Working around RPM differences when installing RPMs
- </para>
-
- <para>
- *Working around RPM differences when building RPMs
- </para>
+<!-- $Id: -->
+<chapter id="ch-other-linuxes">
+ <title>Using RPM on Non-Red Hat Linuxes</title>
<para>
- *Dealing with non-RPM-based Linux distributions
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Dealing with RPM issues on other versions of Linux
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ RPM standardization
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Working around RPM differences when installing RPMs
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Working around RPM differences when building RPMs
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Dealing with non-RPM-based Linux distributions
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
Although its name was originally the Red Hat Package Manager, RPM
has been adopted by most major Linux distributions. With this
adoption, RPM has moved from its Red Hat roots, and RPM now stands
for the RPM Package Manager.
</para>
-
<para>
In addition, the RPM package format is being adopted by the Linux
Standards Base (LSB). The LSB defines a set of standards to help
maintain compatibility for all Linux distributions.
</para>
-
<para>
Cross Reference
</para>
-
<para>
See www.linuxbase.org for more on the LSB.
</para>
-
<para>
This chapter covers differences in how Linux distributions use RPM,
ways to work around these differences, and also tools you can use
for non-RPM distributions.
</para>
-
<sect1>
<title>Troubleshooting RPM Installation Issues</title>
<para>
@@ -307,7 +299,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Handling Problems Building RPMs</title>
<para>
@@ -787,7 +778,6 @@
</sect3>
</sect2>
</sect1>
-
<sect1>
<title>Dealing with Non-RPM-Based Linux Versions</title>
<para>
@@ -816,7 +806,6 @@
<para/>
</sect2>
</sect1>
-
<sect1>
<title>Standardizing RPMs</title>
<para>
@@ -870,7 +859,6 @@
<para/>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -903,6 +891,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-other-os-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-other-os-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-other-os-en.xml 4 Oct 2005 01:55:46 -0000 1.1
+++ rpm-guide-other-os-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,44 +1,42 @@
-<!-- $Id: -->
-<chapter id="ch-other-os">
-<title>RPM on Other Operating Systems</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Running RPM on other operating systems
- </para>
-
- <para>
- *Bootstrapping RPM on other operating systems
- </para>
-
- <para>
- *Setting up the RPM environment
- </para>
-
- <para>
- *Creating non-Linux RPMs
- </para>
-
- <para>
- *Setting up an RPM build environment
- </para>
+<!-- $Id: -->
+<chapter id="ch-other-os">
+ <title>RPM on Other Operating Systems</title>
<para>
- *Cross-building packages
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Running RPM on other operating systems
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Bootstrapping RPM on other operating systems
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Setting up the RPM environment
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Creating non-Linux RPMs
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Setting up an RPM build environment
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Cross-building packages
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
RPM was originally designed on Linux and for most of its life has
been a Linux-centric package management system. But most Linux
@@ -46,26 +44,22 @@
operating systems. Linux is, after all, a Unix-workalike operating
system.
</para>
-
<para>
The RPM system is no exception. It has been ported to a number of
operating systems, including quite a few Unix variants. The source
code is freely available, so you can port RPM to other systems as
well.
</para>
-
<para>
This chapter covers running RPM on non-Linux operating systems,
including getting the RPM system in the first place, bootstrapping
an RPM environment, and creating packages for other operating
systems.
</para>
-
<para>
The first step is to get RPM for your system, or port RPM if it
isn’t already available.
</para>
-
<sect1>
<title>Running RPM on Other Operating Systems</title>
<para>
@@ -454,7 +448,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Bootstrapping RPM On Other Operating Systems</title>
<para>
@@ -887,7 +880,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Setting Up the RPM System</title>
<para>
@@ -1359,7 +1351,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Creating Non-Linux RPMS</title>
<para>
@@ -1566,7 +1557,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -1616,6 +1606,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-package-structure-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-package-structure-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-package-structure-en.xml 4 Oct 2005 01:56:31 -0000 1.1
+++ rpm-guide-package-structure-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,32 +1,27 @@
-<!-- $Id: -->
-<chapter id="ch-package-structure">
-<title>RPM Package File Structure</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Appendix
- </para>
-
- <para>
- *RPM package file structure
- </para>
-
- <para>
- *RPM header entry formats
- </para>
+<!-- $Id: -->
+<chapter id="ch-package-structure">
+ <title>RPM Package File Structure</title>
<para>
- *Payload format
+ This appendix covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ RPM package file structure
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ RPM header entry formats
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Payload format
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
This appendix describes the format of RPM package files. You can
combine this information with C, Perl, or Python data structures to
@@ -35,30 +30,24 @@
attempt to access the files directly, as you may inadvertently
damage the RPM file.
</para>
-
<para>
Cross Reference
</para>
-
<para>
Chapters 16, 17, and 18 cover programming with C, Python, and Perl,
respectively.
</para>
-
<para>
The RPM package format described here has been standardized as part
of the Linux Standards Base, or LSB, version 1.3.
</para>
-
<para>
Cross Reference
</para>
-
<para>
The LSB 1.3 section on package file formats is available at
www.linuxbase.org/spec/refspecs/LSB_1.3.0/gLSB/gLSB.html#PACKAGEFMT.
</para>
-
<sect1>
<title>The Package File</title>
<para>
@@ -2565,6 +2554,7 @@
</sect2>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-packaging-guidelines-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-packaging-guidelines-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-packaging-guidelines-en.xml 4 Oct 2005 01:57:07 -0000 1.1
+++ rpm-guide-packaging-guidelines-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,28 +1,22 @@
-<!-- $Id: -->
-<chapter id="ch-packaging-guidelines">
-<title>Packaging Guidelines</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Avoiding common mistakes
- </para>
+<!-- $Id: -->
+<chapter id="ch-packaging-guidelines">
+ <title>Packaging Guidelines</title>
<para>
- *Following good practices
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Avoiding common mistakes
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Following good practices
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
RPM is a complex system that helps manage thousands of packages for
a complex operating system. Furthermore, RPM is very, very flexible.
@@ -31,12 +25,10 @@
problems with your RPMs. Following some best practices guidelines
will help you avoid future problems as you release RPM updates.
</para>
-
<para>
This chapter covers ways to avoid common problems as well as
best-practice guidelines for creating your own RPMs.
</para>
-
<sect1>
<title>Avoiding Common Problems</title>
<para>
@@ -282,7 +274,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Following Good Practices</title>
<para>
@@ -652,7 +643,6 @@
</sect3>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -685,6 +675,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-programming-c-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-programming-c-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-programming-c-en.xml 4 Oct 2005 01:57:51 -0000 1.1
+++ rpm-guide-programming-c-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,73 +1,65 @@
-<!-- $Id: -->
-<chapter id="ch-programming-c">
-<title>Programming RPM with C</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Using the RPM C library
- </para>
-
- <para>
- *Setting up a development environment
- </para>
-
- <para>
- *Programming with the RPM C library
- </para>
-
- <para>
- *The power of popt for command-line argument processing
- </para>
+<!-- $Id: -->
+<chapter id="ch-programming-c">
+ <title>Programming RPM with C</title>
<para>
- *Comparing package files to installed packages
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Using the RPM C library
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Setting up a development environment
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Programming with the RPM C library
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The power of <command>popt</command> for command-line argument
+ processing
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Comparing package files to installed packages
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
The RPM C library allows you to perform all the operations of the
rpm command from within your own C or C++ programs.
</para>
-
<para>
The reason is simple: The rpm command was created using the RPM
libraries. These same libraries are available for you to use in your
own programs.
</para>
-
<para>
The rpm command itself is quick and, for the most part, simple. So,
why would you want to write RPM programs?
</para>
-
<para>
There are many reasons, some of which are listed here:
</para>
-
<para>
*Speed: If you need to perform a task on many RPM files such as
verifying a large set of files, then performing the task from one
program will be a lot faster than launching the rpm command for each
file.
</para>
-
<para>
*Custom options: If you need to do something the rpm command doesn't
offer, or doesn't make easy, then you may want to write your own
program.
</para>
-
<para>
*Convenience: If you need to make many packages quickly, with custom
options, your best bet may be to create a program suited for your
@@ -76,7 +68,6 @@
writing RPM shell scripts goes much faster than writing whole
programs.
</para>
-
<para>
*Installation programs: The Windows world has standardized on
graphical installation programs such as InstallShield or
@@ -85,12 +76,10 @@
best of both worlds by writing a graphical installation program on
top of the RPM system.
</para>
-
<para>
*Integration with environments: You may want to better integrate RPM
with a Linux desktop environment such as GNOME or KDE.
</para>
-
<para>
*Working with other languages: This book covers programming RPM with
C, the core language for the library, as well as the Python and Perl
@@ -98,7 +87,6 @@
bind with other languages such as Tcl, Ruby, or even C# (especially
one of the C# implementations for Linux).
</para>
-
<para>
This chapter and the next cover RPM programming. This chapter covers
the RPM C programming library, which provides low-level access to
@@ -108,7 +96,6 @@
your best bet is to try the Python API first. Even so, there is a
lot you can do with the RPM C library.
</para>
-
<sect1>
<title>Programming with the C Library</title>
<para>
@@ -968,7 +955,6 @@
</sect3>
</sect2>
</sect1>
-
<sect1>
<title>The Power of popt</title>
<para>
@@ -2265,7 +2251,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Working with RPM Files</title>
<para>
@@ -2744,7 +2729,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Programming with the RPM Database</title>
<para>
@@ -3083,7 +3067,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Comparing an RPM File to an Installed Package</title>
<para>
@@ -3913,7 +3896,6 @@
jikes Fri 25 Oct 2002 06:49:38 PM CDT
</para>
</sect1>
-
<sect1>
<title>Where to Go from Here</title>
<para>
@@ -3947,7 +3929,6 @@
organization can help you locate the functions you need.
</para>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -3981,6 +3962,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
@@ -3988,4 +3970,3 @@
fill-column: 72
End:
-->
-
Index: rpm-guide-programming-perl-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-programming-perl-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-programming-perl-en.xml 4 Oct 2005 01:58:18 -0000 1.1
+++ rpm-guide-programming-perl-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,37 +1,33 @@
-<!-- $Id: -->
-<chapter id="ch-programming-perl">
-<title>Programming RPM with Perl</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Using the RPM2 module to access information on package files
- </para>
-
- <para>
- *Querying the RPM database from Perl
- </para>
-
- <para>
- *Cross-referencing capabilities by the packages that provide and
- require capabilities
- </para>
+<!-- $Id: -->
+<chapter id="ch-programming-perl">
+ <title>Programming RPM with Perl</title>
<para>
- *Extracting information on packages
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Using the RPM2 module to access information on package files
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Querying the RPM database from Perl
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Cross-referencing capabilities by the packages that provide and
+ require capabilities
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Extracting information on packages
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
Perl is one of the most popular scripting languages. Used by system
administrators, software developers, and a host of other users, Perl
@@ -39,24 +35,20 @@
Perl stands for Practical Extraction and Report Language, or
sometimes Pathologically Eclectic Rubbish Lister.
</para>
-
<para>
Note
</para>
-
<para>
In the same vein, LISP stands for Lots of Irritating Single
Parenthesis and COBOL for Completely Obnoxious Business Oriented
Language.
</para>
-
<para>
I began my book Cross-Platform Perl (John Wiley & Sons, 2000) by
mentioning that when I first started learning Perl, I thought it was
an evil plot. I still do. But it is a very practical evil plot. You
can get a lot of work done with Perl, and quickly.
</para>
-
<para>
Because of a long history of text processing, Perl is especially
popular among system administrators. Perl also supports add-on
@@ -66,30 +58,24 @@
like the Perl syntax script with Perl anyway, because the available
modules save a lot of time.
</para>
-
<para>
Cross Reference
</para>
-
<para>
See search.cpan.org, the Comprehensive Perl Archive Network, for a
listing of many Perl modules.
</para>
-
<para>
This chapter covers working with RPM files and the RPM database
using Perl. You can combine RPM usage with other Perl usage, such as
generating HTML files or downloading RPMs over a network link.
</para>
-
<para>
Cross Reference
</para>
-
<para>
Many of the RPM tools covered in Chapter 8 are written in Perl.
</para>
-
<sect1>
<title>Getting and Using the Perl RPM Modules</title>
<para>
@@ -127,7 +113,6 @@
objects: RPM files and installed packages.
</para>
</sect1>
-
<sect1>
<title>Working with RPM Files</title>
<para>
@@ -355,7 +340,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Programming with the RPM Database</title>
<para>
@@ -1489,7 +1473,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Where to Go from Here</title>
<para>
@@ -1550,7 +1533,6 @@
You can download all these modules from the CPAN site.
</para>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -1580,6 +1562,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-programming-python-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-programming-python-en.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- rpm-guide-programming-python-en.xml 21 Oct 2005 00:20:31 -0000 1.2
+++ rpm-guide-programming-python-en.xml 26 Oct 2005 01:54:11 -0000 1.3
@@ -1,40 +1,37 @@
-<!-- $Id: -->
-<chapter id="ch-rpm-programming-python">
-<title>Programming RPM with Python</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Using the RPM with Python
- </para>
-
- <para>
- *Installing the necessary modules
- </para>
-
- <para>
- *Programming with the RPM database
- </para>
-
- <para>
- *Programming with RPM files
- </para>
+<!-- $Id: -->
+<chapter id="ch-rpm-programming-python">
+ <title>Programming RPM with Python</title>
<para>
- *Installing packages programmatically
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Using the RPM with Python
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Installing the necessary modules
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Programming with the RPM database
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Programming with RPM files
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Installing packages programmatically
+ </para>
+ </listitem>
+ </itemizedlist>
<sect1>
<title>Setting Up a Python Development Environment</title>
<para>
@@ -123,7 +120,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>The Python API Hierarchy</title>
<para>
@@ -251,7 +247,6 @@
version.
</para>
</sect1>
-
<sect1>
<title>Programming with the RPM Database</title>
<para>
@@ -1321,7 +1316,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Reading Package Files</title>
<para>
@@ -1623,7 +1617,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Dependency Comparisons</title>
<para>
@@ -1759,7 +1752,6 @@
a package isn't installed.
</para>
</sect1>
-
<sect1>
<title>Installing and Upgrading Packages</title>
<para>
@@ -3009,7 +3001,6 @@
</sect3>
</sect2>
</sect1>
-
<sect1>
<title>Where to Go from Here</title>
<para>
@@ -3047,7 +3038,6 @@
the Vaults of Parnassus listing of tutorials.
</para>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -3077,6 +3067,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
@@ -3084,4 +3075,3 @@
fill-column: 72
End:
-->
-
Index: rpm-guide-rpm-evolution-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-rpm-evolution-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-rpm-evolution-en.xml 4 Oct 2005 02:00:07 -0000 1.1
+++ rpm-guide-rpm-evolution-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,16 +1,7 @@
-<!-- $Id: -->
-<chapter id="ch-rpm-evolution">
-<title>RPM Feature Evolution</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
+<!-- $Id: -->
+<chapter id="ch-rpm-evolution">
+ <title>RPM Feature Evolution</title>
<para>
Although RPM implementations are largely compatible from version to
version, RPM packagers must remember that RPM is a still-evolving
@@ -25,13 +16,11 @@
considering these revisions of RPM, the main releases of interest
are RPM 2.5, RPM 3.0.5, RPM 4.0.4, and RPM 4.1.
</para>
-
<para>
RPM 2.5 is not widely used anymore; packages should target RPM 2.5
only if the intention is for the RPM package to install using
absolutely all RPM versions.
</para>
-
<para>
RPM 3.0.5 is the final release of the 3.x series of RPM. It was the
release of RPM shipped with Red Hat Linux 6.2 and older releases. It
@@ -39,7 +28,6 @@
distributions use an RPM implementation version based on RPM 3.0.5,
for example. (Red Hat Linux was upgraded to RPM 4 via an errata.)
</para>
-
<para>
RPM 4.0.4 was used with the 7.x releases of Red Hat Linux, and RPM
4.1 first shipped with Red Hat Linux 8.0. Packages produced
@@ -47,7 +35,6 @@
RPM still in use today. Packages produced targeting RPM 4.0.4 or RPM
4.1 will work only with recent RPM implementations.
</para>
-
<para>
RPM 2.5 is the oldest version of RPM that can, by any stretch of the
imagination, still be considered in use. With RPM 2.5, most of the
@@ -57,48 +44,40 @@
also the first version of RPM to use the RPM version 3 RPM file
format.
</para>
-
<para>
RPM 2.5.3 added support for Epochs to the RPM header, implementing
RPMTAG_EPOCH.
</para>
-
<para>
RPM 2.5.4 introduced the %license and %readme file types, which can
be used in the RPM spec file to indicate license and README files.
</para>
-
<para>
RPM 2.5.6 added support for usage of the Epoch: keyword in the RPM
spec file, allowing you to force an Epoch for your package. The
Epoch: keyword replaced the older Serial: keyword, which
semantically behaved similarly.
</para>
-
<para>
RPM 2.5.7 enforced the previously implied standard that the "-"
character should not be used within the Version or Release fields in
the RPM spec file.
</para>
-
<para>
RPM 2.90 introduced support for signing and verifying RPM package
files using GPG, the GNU Privacy Guard.
</para>
-
<para>
RPM 2.91 allowed the usage of Provides: directives that defined
absolute paths to provided files. Prior to RPM 2.91, Provides: could
be used only for listing provided capabilities, not for using
statements like Provides: /path/to/file to indicate provided files.
</para>
-
<para>
RPM 3.0.2 permitted usage of multiple Provides: lines for the first
time, eliminating the need to combine all provided capabilities and
files on the same line in the spec file.
</para>
-
<para>
RPM 3.0.3 added support for versioned dependencies. Prior to RPM
3.0.3, spec files could indicate that a package required another
@@ -106,30 +85,24 @@
indicate the acceptable versions of the required package or which
version of the capability the package provided.
</para>
-
<para>
RPM 3.0.4 introduced CompressedFileNames support to RPM. Prior to
RPM 3.0.4, RPM packaged the absolute paths of all archived files
within the package file. Package file headers contained statements
such as
</para>
-
<para>
fileName #0: /usr/bin/ar
</para>
-
<para>
fileName #1: /usr/bin/as
</para>
-
<para>
fileName #2: /usr/bin/gasp
</para>
-
<para>
fileName #3: /usr/bin/gprof
</para>
-
<para>
With CompressedFileNames support, the RPM package file header
instead stores the directory name, then just the base name of files
@@ -137,31 +110,24 @@
such as the following for a given directory with a number of files
within that directory:
</para>
-
<para>
dirName #0: /usr/bin
</para>
-
<para>
baseName dirIndex
</para>
-
<para>
#0 ar 0
</para>
-
<para>
#1 as 0
</para>
-
<para>
#2 gasp 0
</para>
-
<para>
#3 gprof 0
</para>
-
<para>
Each file entry now holds the file's base name within the directory,
as well as an index number that refers to the directory entry. Since
@@ -169,7 +135,6 @@
CompressedFileNames support results in significant memory savings
when processing packages for installation.
</para>
-
<para>
RPM 3.0.5 added PayloadIsBzip2 support to RPM, allowing the data
payload of RPM package files to be compressed using bzip2 instead of
@@ -181,7 +146,6 @@
version 4 file format packages; packages produced with RPM 3.0.5 can
only be RPM version 3 file format, however.
</para>
-
<para>
RPM 4.0 implemented several significant changes to RPM. RPM 4.0
created package files using RPM version 4 package file format. RPM
@@ -211,12 +175,10 @@
removing the need to provide self-capabilities within the package
spec file.
</para>
-
<para>
RPM 4.0.2 introduced the use of SHA-1 message digests to validate
RPM header regions.
</para>
-
<para>
RPM 4.0.3 added the %dev(type,major,minor) spec file directive,
allowing creation of device nodes. In addition, the %configure spec
@@ -227,7 +189,6 @@
files in RPM version 3 package file format by default, although it
still supports RPM version 4 package file format as well.
</para>
-
<para>
RPM 4.0.4 provided PartialHardlinkSets support. RPM package files
are sometimes created which contain multiple copies of the same
@@ -246,12 +207,10 @@
determined dependencies. In addition, RPM 4.0.4 provides transaction
support for RPM.
</para>
-
<para>
RPM 4.1 adds separate header DSA and RSA signatures, allowing
verification of RPM package headers.
</para>
-
<para>
Finally, when considering the RPM features required by your prepared
package, remember that some required RPM features are specified
Index: rpm-guide-rpm-overview-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-rpm-overview-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-rpm-overview-en.xml 4 Oct 2005 02:00:40 -0000 1.1
+++ rpm-guide-rpm-overview-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,45 +1,38 @@
-<!-- $Id: -->
-<chapter id="ch-rpm-overview">
-<title>RPM Overview</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Understanding the package file
- </para>
-
- <para>
- *Querying the RPM database
- </para>
+<!-- $Id: -->
+<chapter id="ch-rpm-overview">
+ <title>RPM Overview</title>
<para>
- *Running RPM commands
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Understanding the package file
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Querying the RPM database
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Running RPM commands
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
Working with RPM packages, files, commands, and databases can be
complicated. There are thousands of files, for hundreds if not
thousands of packages, installed on your system. You need some way
to manage it all. The RPM system can help you do that.
</para>
-
<para>
This chapter provides an overview of the components that make up the
RPM system for package management: package files, databases, and RPM
commands.
</para>
-
<sect1>
<title>Understanding the Package File</title>
<para>
@@ -235,7 +228,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Querying the RPM Database</title>
<para>
@@ -335,7 +327,6 @@
5.
</para>
</sect1>
-
<sect1>
<title>Running RPM Commands</title>
<para>
@@ -701,7 +692,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -717,6 +707,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-rpmbuild-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-rpmbuild-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-rpmbuild-en.xml 4 Oct 2005 01:59:30 -0000 1.1
+++ rpm-guide-rpmbuild-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,51 +1,46 @@
-<!-- $Id: -->
-<chapter id="ch-rpmbuild">
-<title>Controlling the Build with rpmbuild</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Building with the rpmbuild command
- </para>
-
- <para>
- *Building RPMs without an external spec file
- </para>
-
- <para>
- *Working with source RPMs
- </para>
-
- <para>
- *Optimizing builds
- </para>
+<!-- $Id: -->
+<chapter id="ch-rpmbuild">
+ <title>Controlling the Build with <command>rpmbuild</command></title>
<para>
- *Signing built RPMs
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Building with the <command>rpmbuild</command> command
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Building RPMs without an external spec file
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Working with source RPMs
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Optimizing builds
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Signing built RPMs
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
The preceding chapters in this Part cover details on how to put
together RPMs. This chapter rounds out the discussion by delving
into more details on the rpmbuild command.
</para>
-
<para>
You can customize how rpmbuild creates RPMs, and you can use RPM
commands to test and debug your package.
</para>
-
<sect1>
<title>Building RPMs with the rpmbuild Command</title>
<para>
@@ -526,7 +521,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Building RPMs Without an External Spec File</title>
<para>
@@ -718,7 +712,6 @@
<para/>
</sect2>
</sect1>
-
<sect1>
<title>Working with Source RPMs</title>
<para>
@@ -1095,7 +1088,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Signing Built RPMs</title>
<para>
@@ -1750,7 +1742,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -1785,6 +1776,7 @@
<para/>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-scripting-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-scripting-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-scripting-en.xml 4 Oct 2005 02:02:12 -0000 1.1
+++ rpm-guide-scripting-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,32 +1,27 @@
-<!-- $Id: -->
-<chapter id="ch-scripting">
-<title>Automating RPM with Scripts</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Deciding when to program and when to script
- </para>
-
- <para>
- *Examining RPM files with scripts
- </para>
+<!-- $Id: -->
+<chapter id="ch-scripting">
+ <title>Automating RPM with Scripts</title>
<para>
- *Querying the RPM database with scripts
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Deciding when to program and when to script
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Examining RPM files with scripts
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Querying the RPM database with scripts
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
The rpm command provides a very high-level view of package
management. Most of the operations you need to perform require only
@@ -34,12 +29,10 @@
command tend to get very complex, however, especially for detailed
queries. That’s where scripting can help.
</para>
-
<para>
This chapter covers scripting, specifically shell scripting, with
the rpm command, especially for newcomers to Linux scripting
</para>
-
<sect1>
<title>Scripting</title>
<para>
@@ -94,7 +87,6 @@
Don’t get caught up in this. Use the right tool for the job.
</para>
</sect1>
-
<sect1>
<title>Distinguishing Scripting Languages from Programming Languages</title>
<para>
@@ -191,7 +183,6 @@
</tgroup>
</informaltable>
</sect1>
-
<sect1>
<title>Deciding When to Program and When to Script</title>
<para>
@@ -238,7 +229,6 @@
and Chapter 18 covers Perl scripting.
</para>
</sect1>
-
<sect1>
<title>Shell Scripting Basics</title>
<para>
@@ -857,7 +847,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Examining RPM Files</title>
<para>
@@ -1005,7 +994,6 @@
install.
</para>
</sect1>
-
<sect1>
<title>Querying the RPM Database</title>
<para>
@@ -1119,7 +1107,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Where to Go From Here</title>
<para>
@@ -1152,7 +1139,6 @@
perform.
</para>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -1178,6 +1164,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-specfile-syntax-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-specfile-syntax-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-specfile-syntax-en.xml 4 Oct 2005 02:03:52 -0000 1.1
+++ rpm-guide-specfile-syntax-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,29 +1,30 @@
-<!-- $Id: -->
-<chapter id="ch-specfile-syntax">
-<title>Spec File Syntax</title>
-
- <para>
- In This Appendix
- </para>
-
- <para>
- *The package information tags
- </para>
+<!-- $Id: -->
+<chapter id="ch-specfile-syntax">
+ <title>Spec File Syntax</title>
<para>
- *Build sections
+ This appendix covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ The package information tags
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Build sections
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
The RPM spec file is divided into two main parts: the package
information tags, such as the name of the package, and the build
sections, such as the commands to compile the software.
</para>
-
<para>
The following sections summarize the spec file syntax.
</para>
-
<sect1>
<title>Package Information Tags</title>
<para>
@@ -297,7 +298,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Macros</title>
<para>
@@ -658,7 +658,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Build Sections</title>
<para>
@@ -776,7 +775,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>File Tags</title>
<para>
@@ -848,7 +846,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>The Change Log</title>
<para>
@@ -873,6 +870,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
@@ -880,4 +878,3 @@
fill-column: 72
End:
-->
-
Index: rpm-guide-specfiles-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-specfiles-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-specfiles-en.xml 4 Oct 2005 02:15:56 -0000 1.1
+++ rpm-guide-specfiles-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,40 +1,37 @@
-<!-- $Id: -->
-<chapter id="ch-specfiles">
-<title>Working with Spec Files</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Writing spec files
- </para>
-
- <para>
- *Defining package information
- </para>
-
- <para>
- *Controlling the build
- </para>
-
- <para>
- *Listing the files in the package
- </para>
+<!-- $Id: -->
+<chapter id="ch-specfiles">
+ <title>Working with Spec Files</title>
<para>
- *Defining spec file macros
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Writing spec files
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Defining package information
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Controlling the build
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Listing the files in the package
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Defining spec file macros
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
The previous chapter introduces the concepts of how to build RPMs,
and briefly covered the spec file, which controls how RPM packages
@@ -42,13 +39,11 @@
files and the next chapter covers advanced spec file topics such as
using conditional commands and making relocatable packages.
</para>
-
<para>
A spec file defines all the commands and values that are required
for creating a package, everything from the name and version number
to the actual commands used to build the program you are packaging.
</para>
-
<para>
This chapter covers the spec file syntax and how to write spec
files. In goes in depth into defining information about your
@@ -56,7 +51,6 @@
exactly should go into the package, and customizing your build with
RPM macros.
</para>
-
<sect1>
<title>Reading Spec Files</title>
<para>
@@ -104,7 +98,6 @@
these sections.
</para>
</sect1>
-
<sect1>
<title>Writing Spec Files</title>
<para>
@@ -311,7 +304,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Defining Package Information</title>
<para>
@@ -840,7 +832,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Controlling the Build</title>
<para>
@@ -1522,7 +1513,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Filling the List of Files</title>
<para>
@@ -2134,7 +2124,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Adding Change Log Entries</title>
<para>
@@ -2162,7 +2151,6 @@
- updated to 1.3
</para>
</sect1>
-
<sect1>
<title>Defining Spec File Macros</title>
<para>
@@ -2670,7 +2658,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Creating XML Spec Files</title>
<para>
@@ -2866,7 +2853,6 @@
format will likely change.
</para>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -2916,6 +2902,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-transactions-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-transactions-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-transactions-en.xml 4 Oct 2005 02:04:58 -0000 1.1
+++ rpm-guide-transactions-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,27 +1,32 @@
-<!-- $Id: -->
-<chapter id="ch-transactions">
-<title>Transactions</title>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Understanding transactions
- </para>
-
- <para>
- *Querying for packages based on transactions
- </para>
-
- <para>
- *Rolling back transactions
- </para>
+<!-- $Id: -->
+<chapter id="ch-transactions">
+ <title>Transactions</title>
<para>
- *Saving old packages when upgrading
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Understanding transactions
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Querying for packages based on transactions
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Rolling back transactions
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Saving old packages when upgrading
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
When packages depend on other packages, you may have to install
multiple packages to add a single application. Some of the packages
@@ -30,7 +35,6 @@
RPM system understood this problem and added the concept of
transactions to RPM.
</para>
-
<para>
This chapter covers transactions and how they can help you cleanly
install a set of dependent packages. But transactions won’t solve
@@ -38,7 +42,6 @@
dependencies by using the techniques provided in the last three
chapters.
</para>
-
<sect1>
<title>Understanding Transactions</title>
<para>
@@ -117,7 +120,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Transactions with the rpm Command</title>
<para>
@@ -510,7 +512,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Saving Old Packages</title>
<para>
@@ -634,7 +635,6 @@
Download rpmrebuild from http://rpmrebuild.sourceforge.net/.
</para>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -672,6 +672,7 @@
<para/>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-using-rpm-db-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-using-rpm-db-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-using-rpm-db-en.xml 4 Oct 2005 02:07:01 -0000 1.1
+++ rpm-guide-using-rpm-db-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,64 +1,66 @@
-<!-- $Id: -->
-<chapter id="ch-using-rpm-db">
-<title>Using the RPM Database</title>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Querying the RPM database
- </para>
-
- <para>
- *Getting information on RPM files
- </para>
-
- <para>
- * Finding out which packages own files on your system
- </para>
-
- <para>
- * Verifying installed packages
- </para>
-
- <para>
- *Backing up the RPM database
- </para>
+<!-- $Id: -->
+<chapter id="ch-using-rpm-db">
+ <title>Using the RPM Database</title>
<para>
- *Repairing damaged RPM databases
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Querying the RPM database
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Getting information on RPM files
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Finding out which packages own files on your system
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Verifying installed packages
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Backing up the RPM database
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Repairing damaged RPM databases
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
Every package you install with RPM is recorded in the RPM database.
The RPM system includes commands to query this database to find out
which packages are installed and to provide quite a few details
about these packages.
</para>
-
<para>
This chapter covers querying both the RPM database and RPM package
files. Both types of query are important:
</para>
-
<para>
*Query the RPM database to see what is installed, or not installed,
on your system.
</para>
-
<para>
*Query package files to see what the files require, as well as what
the files provide.
</para>
-
<para>
In addition to querying the RPM database, you can use the database
to verify packages. Since this database is so important to the
management of your Linux system, this chapter covers how to back it
up, as well as how to repair a damaged RPM database.
</para>
-
<sect1>
<title>Querying the RPM Database</title>
<para>
@@ -713,7 +715,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Getting Information on Packages</title>
<para>
@@ -3617,7 +3618,6 @@
</informaltable>
</sect2>
</sect1>
-
<sect1>
<title>Getting Information on Package Files</title>
<para>
@@ -3767,7 +3767,6 @@
</informaltable>
<para/>
</sect1>
-
<sect1>
<title>Verifying Installed RPM Packages</title>
<para>
@@ -4220,7 +4219,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Working With the RPM Database</title>
<para>
@@ -4480,7 +4478,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -4501,6 +4498,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
Index: rpm-guide-using-rpm-en.xml
===================================================================
RCS file: /cvs/docs/rpm-guide/rpm-guide-using-rpm-en.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- rpm-guide-using-rpm-en.xml 4 Oct 2005 02:08:57 -0000 1.1
+++ rpm-guide-using-rpm-en.xml 26 Oct 2005 01:54:11 -0000 1.2
@@ -1,34 +1,27 @@
-<!-- $Id: -->
-<chapter id="ch-using-rpm">
-<title>Using RPM</title>
-
- <para>
- Copyright (c) 2005 by Eric Foster-Johnson. This material may be
- distributed only subject to the terms and conditions set forth in
- the Open Publication License, v1.0 or later (the latest version is
- presently available at http://www.opencontent.org/openpub/).
- </para>
-
- <para/>
-
- <para>
- In This Chapter
- </para>
-
- <para>
- *Installing and upgrading software
- </para>
+<!-- $Id: -->
+<chapter id="ch-using-rpm">
+ <title>Using RPM</title>
<para>
- *Removing software
+ This chapter covers:
</para>
-
+ <itemizedlist>
+ <listitem>
+ <para>
+ Installing and upgrading software
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Removing software
+ </para>
+ </listitem>
+ </itemizedlist>
<para>
This chapter covers the most common uses for RPM: installing,
removing, and upgrading software. These are the most frequently used
RPM commands.
</para>
-
<para>
The RPM system includes the options you might expect, such as
installing a package, but there’s a lot more you can do. For
@@ -37,7 +30,6 @@
rpm options you can use to get information and feedback on
installation, for example.
</para>
-
<sect1>
<title>The rpm Command</title>
<para>
@@ -50,7 +42,6 @@
reading this chapter.
</para>
</sect1>
-
<sect1>
<title>Upgrading and Installing Software</title>
<para>
@@ -1737,7 +1728,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Removing Software</title>
<para>
@@ -1925,7 +1915,6 @@
</para>
</sect2>
</sect1>
-
<sect1>
<title>Other rpm Command Options</title>
<para>
@@ -2037,7 +2026,6 @@
--pipe command_to_send_out_to
</para>
</sect1>
-
<sect1>
<title>Summary</title>
<para>
@@ -2148,6 +2136,7 @@
</para>
</sect1>
</chapter>
+
<!--
Local variables:
mode: xml
More information about the Fedora-docs-commits
mailing list