Imported Upstream version 2.3.0upstream/2.3.0

1 files changed, 35 insertions, 4 deletions

diff --git a/scons.1 b/scons.1
index 8738f49..67f777d 100644
--- a/scons.1
+++ b/scons.1
@@ -1,4 +1,4 @@
-.\" Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 The SCons Foundation
+.\" Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 The SCons Foundation
 .\"
 .\" Permission is hereby granted, free of charge, to any person obtaining
 .\" a copy of this software and associated documentation files (the
@@ -19,9 +19,9 @@
 .\" OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 .\" WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 .\"
-.\" doc/man/scons.1 issue-2856:2676:d23b7a2f45e8 2012/08/05 15:38:28 garyo
+.\" doc/man/scons.1  2013/03/03 09:48:35 garyo
 .\"
-.TH SCONS 1 "August 2012"
+.TH SCONS 1 "March 2013"
 .\" ES - Example Start - indents and turns off line fill
 .rm ES
 .de ES
@@ -2372,7 +2372,9 @@ Installs one or more source files or directories
 in the specified target,
 which must be a directory.
 The names of the specified source files or directories
-remain the same within the destination directory.
+remain the same within the destination directory. The
+sources may be given as a string or as a node returned by
+a builder.
 
 .ES
 env.Install('/usr/local/bin', source = ['foo', 'bar'])
@@ -2391,6 +2393,14 @@ and
 source
 arguments list different numbers of files or directories.
 
+'\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.IP InstallVersionedLib()
+.IP env.InstallVersionedLib()
+Installs a versioned shared library. The \fB$SHLIBVERSION\fP
+construction variable should be defined in the environment
+to confirm the version number in the library name.
+The symlinks appropriate to the architecture will be generated.
+
 .ES
 env.InstallAs(target = '/usr/local/bin/foo',
               source = 'foo_debug')
@@ -3446,6 +3456,19 @@ On some platforms, there is a distinction between a shared library
 and a loadable module (explicitly loaded by user action).
 For maximum portability, use the \fBLoadableModule\fP() builder for the latter.
 
+When the \fB$SHLIBVERSION\fP construction variable is defined a versioned
+shared library is created. This modifies the \fB$SHLINKFLAGS\fP as required,
+adds the version number to the library name, and creates the symlinks that
+are needed. \fB$SHLIBVERSION\fP needs to be of the form X.Y.Z, where X
+and Y are numbers, and Z is a number but can also contain letters to designate
+alpha, beta, or release candidate patch levels.
+
+This builder may create multiple links to the library. On a POSIX system,
+for the shared library libbar.so.2.3.1, the links created would be
+libbar.so, libbar.so.2, and libbar.so.2.3; on a Darwin (OSX) system
+the library would be libbar.2.3.1.dylib and the link would be
+libbar.dylib.
+
 On Windows systems, specifying
 .B register=1
 will cause the \fB.dll\fP to be
@@ -11496,6 +11519,14 @@ The prefix used for shared library file names.
 .IP SHLIBSUFFIX
 The suffix used for shared library file names.
 
+.IP SHLIBVERSION
+When this construction variable is defined, a versioned shared library
+is created. This modifies the \fB$SHLINKFLAGS\fP as required, adds
+the version number to the library name, and creates the symlinks that
+are needed. \fB$SHLIBVERSION\fP needs to be of the form X.Y.Z,
+where X and Y are numbers, and Z is a number but can also contain
+letters to designate alpha, beta, or release candidate patch levels.
+
 .IP SHLINK
 The linker for programs that use shared libraries.