head	1.4;
access;
symbols
	rpm-4_4_8-release:1.4
	rpm-4_4_7-release:1.4
	rpm-4_4_6-release:1.4
	rpm-4_4_5-release:1.4
	rpm-4_4_4-release:1.4
	rpm-4_4_3-release:1.4
	jbj_before_tklcpatches:1.4
	rpm-4_4_2-release:1.4
	pjones-sparse-experiment:1.4.0.6
	rpm-4_4_1-release:1.4
	rpm-4_4-release:1.4
	rpm-4_4:1.4.0.4
	rpm-4_3_1-start:1.4
	rpm-4_3:1.4.0.2
	rpm-4_2_1-release:1.3
	rpm-4_1_1-release:1.3
	rpm-4_2-release:1.3
	rpm-4_2:1.3.0.4
	rpm-4_1-release:1.3
	rpm-4_1:1.3.0.2
	rpm-4_0_4-release:1.1.10.2
	jbj-before-beecrypt:1.1.10.2
	rpm-4_0_3-release:1.1.10.2
	jbj_b4_rollback:1.1.10.2
	rpm-4_0_2-release:1.1
	rpm-4_0_1-release:1.1
	rpm-3_0_6-release:1.1
	rpm-4_0-release:1.1
	rpm-3_0_6:1.1
	rpm-4_0:1.1.0.10
	rpm-3_0_5:1.1.0.8
	jbj_sparc64:1.1.0.6
	rpm-3_0_4:1.1.0.4
	rpm-3_0_3:1.1.0.2;
locks; strict;
comment	@# @;


1.4
date	2003.12.30.13.14.50;	author jbj;	state Exp;
branches;
next	1.3;

1.3
date	2001.03.17.19.55.09;	author jbj;	state Exp;
branches
	1.3.4.1;
next	1.2;

1.2
date	2001.03.14.23.09.09;	author jbj;	state Exp;
branches;
next	1.1;

1.1
date	99.07.19.22.13.12;	author jbj;	state Exp;
branches
	1.1.10.1;
next	;

1.1.10.1
date	2001.03.15.18.32.54;	author jbj;	state Exp;
branches;
next	1.1.10.2;

1.1.10.2
date	2001.04.21.05.43.35;	author jbj;	state Exp;
branches;
next	;

1.3.4.1
date	2003.12.30.13.17.46;	author jbj;	state Exp;
branches;
next	;


desc
@@


1.4
log
@- spelling corrections (#112728).
@
text
@/*! \page relocatable Relocatable packages

Relocatable packages are a way to give the user a little control
over the installation location of a package.  For example, a vendor
may distribute their software to install in "/opt" but you'd like
it to install in "/usr/opt".  If the vendor were distributing a
relocatable RPM package, it would be easy.

\subsection relocatable_building Building a Relocatable Package

Not all software can be "relocatable".  Before continuing you should
think about how the program works, what files it accesses, what other
programs access *it* (and expect it to be in a certain place), etc.
If you determine that the location of the package doesn't matter,
then it can probably be built as "relocatable".

All you need to do to build a relocatable package is put one or more:

\verbatim
  Prefix: <dir>
\endverbatim

in your spec file.  The "<dir>" will usually be something like "/usr",
"/usr/local", or "/opt".  Every file in your %files list must start
with that prefix.  For example, if you have "Prefix: /usr" and your
%files list contains "/etc/foo.conf", the build will fail. The fix for
this is to put

\verbatim
  Prefix: /usr
  Prefix: /etc
\endverbatim

into the spec file so that the /usr and /etc directories may be
relocated separately when this package is installed.


\subsection relocatable_installing Installing Relocatable Packages

By default, RPM will install a relocatable package in the prefix
directory listed in the spec file.  You can override this on the
RPM install command line with "--prefix <dir>".  For example, if
the package in question were going to be installed in "/opt" but
you don't have enough disk space there (and it is a relocatable
package), you could install it "--prefix /usr/opt".

If there is more then one Prefix you may relocate each prefix
separately by using syntax like:

\verbatim
  rpm ... --relocate /opt=/usr/opt --relocate /etc=/usr/etc ...
\endverbatim

If any of the Prefixes is not being relocated they can be skipped on
the command line

*/
@


1.3
log
@Doco updates.
@
text
@d1 1
a1 1
/*! \page relocateable Relocateable packages
d9 1
a9 1
\subsection relcateable_building Building a Relocatable Package
d38 1
a38 1
\subsection relcateable_installing Installing Relocatable Packages
d54 1
a54 1
If any of the Prefixs are not being relocated they can be skipped on
@


1.3.4.1
log
@- spelling corrections (#112728).
@
text
@d1 1
a1 1
/*! \page relocatable Relocatable packages
d9 1
a9 1
\subsection relocatable_building Building a Relocatable Package
d38 1
a38 1
\subsection relocatable_installing Installing Relocatable Packages
d54 1
a54 1
If any of the Prefixes is not being relocated they can be skipped on
@


1.2
log
@Update to doxygen-1.2.6 configuration.
Add manual files to Doxfile.in.
lclint annotations.
@
text
@d9 1
a9 1
<h2>Building a Relocatable Package</h2>
d38 1
a38 1
<h2>Installing Relocatable Packages</h2>
@


1.1
log
@add pl translation and man pages (Tomasz K?oczko et al).
@
text
@d1 1
a1 2
RELOCATABLE PACKAGES
====================
d9 1
a9 2
Building a Relocatable Package
------------------------------
d19 1
d21 1
d29 1
d32 1
d38 1
a38 2
Installing Relocatable Packages
-------------------------------
d50 1
d52 1
d57 1
@


1.1.10.1
log
@- update per-interpreter dependency scripts, add sql/tcl (#20295).
- fix: rpmvercmp("1.a", "1.") returned -1, not +1 (#21392).
@
text
@d1 2
a2 1
/*! \page relocateable Relocateable packages
d10 2
a11 1
<h2>Building a Relocatable Package</h2>
a20 1
\verbatim
a21 1
\endverbatim
a28 1
\verbatim
a30 1
\endverbatim
d36 2
a37 1
<h2>Installing Relocatable Packages</h2>
a48 1
\verbatim
a49 1
\endverbatim
a53 1
*/
@


1.1.10.2
log
@Flush tos onto rpm-4_0 branch.
@
text
@d9 1
a9 1
\subsection relcateable_building Building a Relocatable Package
d38 1
a38 1
\subsection relcateable_installing Installing Relocatable Packages
@


