X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Frelocatable-maint.texi;h=8780b8442f19b5b8a834e554bf1a46a41773c8cf;hb=46f5f314f34a08c9305758482d7d2fdb0e999d09;hp=72c6eaa92132a0e8b05bb0c38f5e9411e5410033;hpb=267667730ec5ce4b619b83db7bf686cd8cb925f4;p=gnulib.git diff --git a/doc/relocatable-maint.texi b/doc/relocatable-maint.texi index 72c6eaa92..8780b8442 100644 --- a/doc/relocatable-maint.texi +++ b/doc/relocatable-maint.texi @@ -8,7 +8,7 @@ and have it work correctly (including i18n). So many users need to go through @code{configure; make; make install} with all its dependencies, options, and hurdles. -Red Hat, Debian, and similar package systems solve the ``ease of +Red Hat, Debian, and other binary distributions solve the ``ease of installation'' problem, but they hardwire path names, usually to @file{/usr} or @file{/usr/local}. This means that users need root privileges to install a binary package, and prevents installing two @@ -89,6 +89,27 @@ bindtextdomain (PACKAGE, relocate (LOCALEDIR)); The prototype for this function is in @file{relocatable.h}. @item +The @code{set_program_name} function can also configure some +additional libraries to relocate files that they access, by defining +corresponding C preprocessor symbols to 1. The libraries for which +this is supported and the corresponding preprocessor symbols are: + +@table @asis +@item libcharset +@code{DEPENDS_ON_LIBCHARSET} + +@item libiconv +@code{DEPENDS_ON_LIBICONV} + +@item libintl +@code{DEPENDS_ON_LIBINTL} +@end table + +Defining the symbol for a library makes every program in the package +depend on that library, whether the program really uses the library or +not, so this feature should be used with some caution. + +@item If your package installs shell scripts, also import the @code{relocatable-script} module. Then, near the beginning of each shell script that your package installs, add the following: