Documentation for new variables in MSVC port.

[Peter Rosin]

Den 2009-01-13 10:39 skrev Peter Rosin:
> msvc-documentation.patch
> http://lists.gnu.org/archive/html/libtool-patches/2008-08/msg00136.html

2008-08-31  Peter Rosin  <address@hidden>

        * doc/libtool.texi (libtool script contents): Document
        new variables introduced by the MSVC port.

diff --git a/doc/libtool.texi b/doc/libtool.texi
index 1782811..5c46ece 100644
--- a/doc/libtool.texi
+++ b/doc/libtool.texi
@@ -5530,6 +5530,23 @@ are used within @code{ltmain.sh} (@pxref{Configuring}):
 The name of the system library archiver.
 @end defvar
 
address@hidden AR_FLAGS
+Flags to create an archive.
address@hidden defvar
+
address@hidden AR_TFLAGS
+Flags to list archive content.
address@hidden defvar
+
address@hidden AR_XFLAGS
+Flags to extract files (or a single file, see @var{ar_extract_one_by_one})
+from an archive.
address@hidden defvar
+
address@hidden AR_SEP
+Separator between @var{AR} flags (e.g. @var{AR_TFLAGS}) and @var{AR} files.
address@hidden defvar
+
 @defvar CC
 The name of the compiler used to configure libtool.  This will always
 contain the compiler for the current language (@pxref{Tags}).
@@ -5595,6 +5612,13 @@ using @var{export_symbols_cmds} before linking an 
archive.
 Set to @samp{yes} or @samp{no}.  Default is @samp{no}.
 @end defvar
 
address@hidden ar_extract_one_by_one
+Extract archive members one by one as listed by @var{AR} using the
+option @var{AR_TFLAGS} in case the archiver does not support
+extracting all archive members with the @var{AR_XFLAGS} option.
+Normally @samp{no}, enable with @samp{yes}.
address@hidden defvar
+
 @defvar archive_cmds
 @defvarx archive_expsym_cmds
 @defvarx old_archive_cmds
@@ -5620,6 +5644,10 @@ these commands, libtool will proceed to link against 
@var{$objdir/$newlib}
 instead of @var{soname}.
 @end defvar
 
address@hidden archiver_list_spec
+How to feed a file listing to the archiver.
address@hidden defvar
+
 @defvar build
 @defvarx build_alias
 @defvarx build_os
@@ -5637,6 +5665,11 @@ Whether libtool should build static libraries on this 
system.  Set to
 @samp{yes} or @samp{no}.
 @end defvar
 
address@hidden compile_tag
+Add tag specific option for the compiler. Normally disabled (i.e.
address@hidden is empty).
address@hidden defvar
+
 @defvar compiler_c_o
 Whether the compiler supports the @option{-c} and @option{-o} options
 simultaneously.  Set to @samp{yes} or @samp{no}.
@@ -5649,6 +5682,26 @@ convenience archives or a set of object file names can 
be passed via
 linker-specific options or linker scripts.
 @end defvar
 
address@hidden dashL_envvar
+When linking, move all paths specified with @option{-L} options to
+this variable, for toolchains where it makes sense to pass the library
+search paths in an environment variable. Normally disabled (i.e.
address@hidden empty).
address@hidden defvar
+
address@hidden dashL_envvar_spec
+When moving library search paths with @var{dashL_envvar}, prepend this
+to each @option{-L} path that is added to @var{dashL_envvar}. Unused
+if @var{dashL_envvar} is empty.
address@hidden defvar
+
address@hidden dashl_xform
address@hidden expression for transforming -l options for the linker. The
+input to the @code{sed} instance is the original argument to the
address@hidden option, the output is fed as an arguments to the linker.
+Normally disabled (i.e. @var{dashl_xform} empty).
address@hidden defvar
+
 @defvar dlopen_support
 Whether @code{dlopen} is supported on the platform.
 Set to @samp{yes} or @samp{no}.
@@ -5708,6 +5761,16 @@ and relinking at install time is triggered.  This also 
means that @var{DESTDIR}
 installation does not work as expected.
 @end defvar
 
address@hidden file_magic_glob
+How to find potential files when @var{deplibs_check_method} is
address@hidden @var{file_magic_glob} is a @code{sed} expression,
+and the @code{sed} instance is fed potential files, that is
+transformed by the @var{file_magic_glob} expression. Useful when the
+shell does not support the shell option @code{nocaseglob}, making
address@hidden inappropriate. Normally disabled (i.e.
address@hidden empty).
address@hidden defvar
+
 @defvar finish_cmds
 Commands to tell the dynamic linker how to find shared libraries in a
 specific directory.
@@ -5874,6 +5937,10 @@ Whether files must be locked to prevent conflicts when 
compiling
 simultaneously.  Set to @samp{yes} or @samp{no}.
 @end defvar
 
address@hidden nm_file_list_spec
+Specify filename containing input files for @var{NM}.
address@hidden defvar
+
 @defvar no_builtin_flag
 Compiler flag to disable builtin functions that conflict with declaring
 external global symbols as @code{char}.
@@ -5907,6 +5974,15 @@ Commands run after installing a shared or static 
library, respectively.
 Commands run after uninstalling a shared or static library, respectively.
 @end defvar
 
address@hidden postlink_cmds
+Commands necessary for finishing linking programs. @var{postlink_cmds}
+are executed immediately after the program is linked. Any occurance of
+the string @code{@@OUTPUT@@} in @var{postlink_cmds} is replaced by the
+name of the created executable (i.e. not the wrapper, if a wrapper is
+generated) prior to execution. Normally disabled (i.e.
address@hidden empty).
address@hidden defvar
+
 @defvar reload_cmds
 @defvarx reload_flag
 Commands to create a reloadable object. Set @var{reload_cmds} to
@@ -5971,6 +6047,13 @@ The library version numbering type.  One of 
@samp{libtool},
 @samp{osf}, @samp{sunos}, @samp{windows}, or @samp{none}.
 @end defvar
 
address@hidden want_nocaseglob
+Find potential files using the shell option @code{nocaseglob} when
address@hidden is @samp{file_magic}. Normally set to
address@hidden, set to @samp{yes} to enable the @code{nocaseglob} shell
+option when looking for potential files.
address@hidden defvar
+
 @defvar whole_archive_flag_spec
 Compiler flag to generate shared objects from convenience archives.
 @end defvar