diff options
author | Bruno Haible <bruno@clisp.org> | 2006-10-09 12:26:13 +0000 |
---|---|---|
committer | Bruno Haible <bruno@clisp.org> | 2006-10-09 12:26:13 +0000 |
commit | 3fc0d6e82c20fcee926ba604d338afe433eaa24e (patch) | |
tree | c4fb0f9d5d3d77ca991b24f24ac0068e89a87899 /doc/gnulib-tool.texi | |
parent | 55e4f9a3f6b39cb87fc55567b7a57660e87f4b09 (diff) | |
download | gnulib-3fc0d6e82c20fcee926ba604d338afe433eaa24e.tar.gz |
Emphasize the drawbacks of the --symlink option.
Diffstat (limited to 'doc/gnulib-tool.texi')
-rw-r--r-- | doc/gnulib-tool.texi | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/doc/gnulib-tool.texi b/doc/gnulib-tool.texi index f8e3f83d50..01ea29d120 100644 --- a/doc/gnulib-tool.texi +++ b/doc/gnulib-tool.texi @@ -90,8 +90,14 @@ are copied into the directory specified by @samp{AC_CONFIG_AUX_DIR} in neither is specified, the current directory is assumed. @code{gnulib-tool} can make symbolic links instead of copying the -source files. Use the @samp{--symbolic} (or @samp{-s} for short) option -to do this. +source files. The option to specify for this is @samp{--symlink}, or +@samp{-s} for short. This can be useful to save a few kilobytes of disk +space. But it is likely to introduce bugs when @code{gnulib} is updated; +it is more reliable to use @samp{gnulib-tool --update} (see below) +to update to newer versions of @code{gnulib}. Furthermore it requires +extra effort to create self-contained tarballs, and it may disturb some +mechanism the maintainer applies to the sources. For these reasons, +this option is generally discouraged. @code{gnulib-tool} will overwrite any pre-existing files, in particular @file{Makefile.am}. Unfortunately, separating the |