Skip to content

Commit 9eb57dc

Browse files
committed
updated GettingStarted doc
1 parent 1bdccea commit 9eb57dc

2 files changed

Lines changed: 31 additions & 17 deletions

File tree

‎buildwin.cmd‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -52,18 +52,18 @@ set VS_VERSION=vs%1
5252
set VS_64_BIT_ENV=VC\bin\x86_amd64\vcvarsx86_amd64.bat
5353

5454
if not defined VCINSTALLDIR (
55-
if %VS_VERSION%==vs71 (call "%VS71COMNTOOLS%vsvars32.bat") else (
56-
if %VS_VERSION%==vs80 (call "%VS80COMNTOOLS%vsvars32.bat") else (
57-
if %VS_VERSION%==vs90 (
58-
if %5==x64 (call "%VS90COMNTOOLS%..\..\%VS_64_BIT_ENV%") else (
59-
call "%VS90COMNTOOLS%vsvars32.bat")) else (
60-
if %VS_VERSION%==vs100 (
61-
if %5==x64 (call "%VS100COMNTOOLS%..\..\%VS_64_BIT_ENV%") else (
62-
call "%VS100COMNTOOLS%vsvars32.bat")) else (
63-
if %VS_VERSION%==vs110 (
64-
if %5==x64 (call "%VS110COMNTOOLS%..\..\%VS_64_BIT_ENV%") else (
65-
call "%VS110COMNTOOLS%vsvars32.bat")
66-
)))))
55+
if %VS_VERSION%==vs71 (call "%VS71COMNTOOLS%vsvars32.bat") else (
56+
if %VS_VERSION%==vs80 (call "%VS80COMNTOOLS%vsvars32.bat") else (
57+
if %VS_VERSION%==vs90 (
58+
if %5==x64 (call "%VS90COMNTOOLS%..\..\%VS_64_BIT_ENV%") else (
59+
call "%VS90COMNTOOLS%vsvars32.bat")) else (
60+
if %VS_VERSION%==vs100 (
61+
if %5==x64 (call "%VS100COMNTOOLS%..\..\%VS_64_BIT_ENV%") else (
62+
call "%VS100COMNTOOLS%vsvars32.bat")) else (
63+
if %VS_VERSION%==vs110 (
64+
if %5==x64 (call "%VS110COMNTOOLS%..\..\%VS_64_BIT_ENV%") else (
65+
call "%VS110COMNTOOLS%vsvars32.bat")
66+
) ) ) ) ) )
6767

6868
if not defined VSINSTALLDIR (
6969
echo Error: No Visual C++ environment found.

‎doc/00200-GettingStarted.page‎

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -166,20 +166,29 @@ source.
166166
Microsoft Visual Studio 7.1 (2003), 8.0 (2005), 9.0 (2008) or 10.0
167167
(2010) is required to build the POCO C++ Libraries on Windows platforms.
168168
Solution and project files for all versions are included. For Visual
169-
Studio 2008 and 2010, 64-bit (x64) builds are supported as well.
169+
Studio 2008, 2010 and 2012, 64-bit (x64) builds are supported as well.
170170
You can either build from within Visual Studio (<*Build->Batch
171171
Build->Select All;Rebuild*>) or from the command line. To build from the
172172
command line, start the Visual Studio .NET 2003/2005/2008/2010 Command
173173
Prompt and go (<[cd]>) to the directory where you have extracted the POCO
174174
C++ Libraries sources. Then, simply start the <*buildwin.cmd*> script and
175-
pass as argument the version of visual studio (71, 80, 90 or 100). You
175+
pass as argument the version of visual studio (71, 80, 90, 100 or 110). You
176176
can customize what is being built by <*buildwin.cmd*> by passing appropriate
177177
command line arguments to it. Call <*buildwin.cmd*> without arguments to see
178-
what is available.
178+
what is available. Build environment is set up by the buildwin.cmd; to avoid
179+
build problems, it is recommended to start the build in a clean command
180+
prompt console, i.e. not in the one provided by Visual Studio for 32/64-bit
181+
builds (although those will work fine if used appropriately for the right
182+
32/64-bit build type).
183+
184+
Visual Studio Express builds have limited support. In particular, the
185+
coupling of the TesTSuite with MFC on Windows is the obstacle for clean
186+
ful VS Express builds. There are plans to alleviate this in the future
187+
relalses.
179188

180189
To disable certain components (e.g., NetSSL_OpenSSL or Data/MySQL) from
181190
the build, edit the text file named <*components*> in the distribution
182-
root directory and remove the respective lines.
191+
root directory and remove or comment the respective lines.
183192

184193
Certain libraries, like NetSSL_OpenSSL, Crypto or Data/MySQL have
185194
dependencies to other libraries. Since the build script does not know where to
@@ -223,7 +232,12 @@ To extract the sources and build all libraries, testsuites and samples, simply
223232
$ gmake -s
224233
----
225234

226-
See the configure script source for a list of possible options.
235+
For help, either invoke
236+
237+
$ ./configure --help
238+
----
239+
240+
Alternatively, you can read the configure script source for a list of possible options.
227241
For starters, we recommend <[--no-tests]> and <[--no-samples]>, to reduce build times.
228242
On a multicore or multiprocessor machine, use parallel makes to speed up
229243
the build (<[make -j4]>).

0 commit comments

Comments
 (0)