RE: [VOTE] release stdcxx 4.2.0

2007-10-19  Travis Vitek  <vitek@...>

        * README (Index): Update section names and numbers.
        (VisualStudio Directory Structure): Add new section
        describing expected directory structure.
        (VisualStudio Setup Instructions): Remove filename
        extension from the list of supported configuration
        options so that the provided names match the names
        allowed by the configure script.



Index: README
===================================================================
--- README (revision 585243)
+++ README (working copy)
@@ -25,14 +25,14 @@
   Contents ......................................................... 1
   Requirements ..................................................... 2
   Unpacking Instructions ........................................... 3
-  Directory Structure ...............................................4
-    Source Directory Structure ................................... 4.1
-    Library Files ................................................ 4.2
-    Library Utilities ............................................ 4.3
-    Locales ...................................................... 4.4
-    Test Suite Files ............................................. 4.5
-    Examples and Tutorials ....................................... 4.6
-    Build Directory Structure .................................... 4.7
+  Source Directory Structure ....................................... 4
+    Library Files ................................................ 4.1
+    Library Utilities ............................................ 4.2
+    Locales ...................................................... 4.3
+    Test Suite Files ............................................. 4.4
+    Examples and Tutorials ....................................... 4.5
+    Build Directory Structure .................................... 4.6
+      VisualStudio Build Directory Structure ................... 4.6.1
   Library Build Instructions ....................................... 5
     VisualStudio Setup Instructions .............................. 5.1
   Library Installation ............................................. 6
@@ -335,6 +335,38 @@
                /.depend/*.d       dependencies
 
 
+  4.6.1  VisualStudio Directory Structure
+  ---------------------------------------
+
+  The directory tree created and partially populated by  the configure
+  script, ${TOPDIR}/configure.bat, has the following structure:
+
+      ${BUILDDIR}/build_${CONFIG}.bat     Root build script
+       |         /*.{html,...}            Temporary files
+       +- ${CONFIG}/${CONFIG}.sln         Root solution
+       |         /${CONFIG}_ex.sln        Examples solution
+       |         /${CONFIG}_loc.sln       Locales solution
+       |         /${CONFIG}_run.sln       Run examples/tests solution
+       |         /${CONFIG}_tst.sln       Tests solution
+       |         /${CONFIG}_tstloc.sln    Locales tests solution
+       |         /${CONFIG}slngen.log     Configuration log file
+       +- Projects/*.vcproj               Project files
+       |          /examples/*.vcproj      Examples project files
+       |          /locales/*.vcproj       Locales project files
+       |          /tests/*.vcproj         Tests project files
+       |          /util/*.vcproj          Utilities project files
+       .
+       . ...${BUILDTYPE} directories generated by running build script
+       .
+       +- ${BUILDTYPE}/bin/*.{exe,...}    Binaries and temporary files
+                   /examples/*.{exe,...}  Binaries and temporary files
+                   /include/config.h      Generated config header
+                   /lib/*.{dll,lib,...}   Binaries and temporary files
+                   /src/*.{obj,...}       Temporary files
+                   /tests/*.{obj,...}     Binaries and temporary files
+                         /src/*.{obj,...} Temporary files
+
+
   5  Library Build Instructions
   -----------------------------
 
@@ -513,19 +545,19 @@
                 specified a current directory is assumed.
 
      <config>   name  (not  pathname)  of  a  config  file  containing
-                compiler options; the available configuration files
+                compiler options; the available configuration options
                 are:
-                icc-9.0.config  - for Intel C++ 9.0
-                icc-9.1.config  - for Intel C++ 9.1
-                icc-10.0.config - for Intel C++ 10.0
-                icc-10.0-x64.config - for Intel C++ 10.0 (x64 platform)
-                msvc-7.0.config - for Microsoft Visual C++ .NET
-                msvc-7.1.config - for Microsoft Visual C++ .NET 2003
-                msvc-8.0.config - for Microsoft Visual C++ .NET 2005
-                msvc-8.0-x64.config - for Microsoft Visual C++ .NET
-                                      2005 (x64 platform)
-                msvcex-8.0.config - for Microsoft Visual C++ Express
-                                    2005
+                icc-9.0         - for Intel C++ 9.0
+                icc-9.1         - for Intel C++ 9.1
+                icc-10.0        - for Intel C++ 10.0
+                icc-10.0-x64    - for Intel C++ 10.0 (x64 platform)
+                msvc-7.0        - for Microsoft Visual C++ .NET
+                msvc-7.1        - for Microsoft Visual C++ .NET 2003
+                msvc-8.0        - for Microsoft Visual C++ .NET 2005
+                msvc-8.0-x64    - for Microsoft Visual C++ .NET 2005
+                                  (x64 platform)
+                msvcex-8.0      - for Microsoft Visual C++ Express
+                                  2005
 
                 The  <config>  argument  is optional.  When  not
                 specified, the suitable config file will be selected