maint: replace misused "a" with "an"
[pspp] / doc / relocatable-maint.texi
index ab7cdcdfc7a287cf304e4333b1d214fb5e0b7bd9..58160cf7c7e4e79c8c98aba110f24eb4fa617c7b 100644 (file)
@@ -15,7 +15,7 @@ privileges to install a binary package, and prevents installing two
 different versions of the same binary package.
 
 A relocatable program can be moved or copied to a different location
 different versions of the same binary package.
 
 A relocatable program can be moved or copied to a different location
-on the filesystem.  It is possible to make symlinks to the installed
+on the file system.  It is possible to make symlinks to the installed
 and moved programs, and invoke them through the symlink. It is
 possible to do the same thing with a hard link @emph{only} if the hard
 link file is in the same directory as the real program.
 and moved programs, and invoke them through the symlink. It is
 possible to do the same thing with a hard link @emph{only} if the hard
 link file is in the same directory as the real program.
@@ -88,6 +88,27 @@ bindtextdomain (PACKAGE, relocate (LOCALEDIR));
 
 The prototype for this function is in @file{relocatable.h}.
 
 
 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
 @item
 If your package installs shell scripts, also import the
 @code{relocatable-script} module.  Then, near the beginning of each
@@ -142,6 +163,3 @@ If your @file{config.h} is not in @file{$(top_builddir)}, then set
 RELOCATABLE_CONFIG_H_DIR='$(top_builddir)/src'
 @end example
 @end enumerate
 RELOCATABLE_CONFIG_H_DIR='$(top_builddir)/src'
 @end example
 @end enumerate
-
-Set @var{RELOCATABLE_STRIP} to @code{:}.  This is needed so that
-@samp{make install} installs executables without stripping them.