r20208 by jghali - some adjustments to msvc build instructions

Wed Jun 24 23:34:04 UTC 2015

Author: jghali
Date: Wed Jun 24 23:34:03 2015
New Revision: 20208

URL: http://scribus.net/websvn/listing.php?repname=Scribus&sc=1&rev=20208
Log:
some adjustments to msvc build instructions

Modified:
    branches/Version14x/Scribus/BUILDING_win32_msvc.txt

Modified: branches/Version14x/Scribus/BUILDING_win32_msvc.txt
URL: http://scribus.net/websvn/diff.php?repname=Scribus&rev=20208&path=/branches/Version14x/Scribus/BUILDING_win32_msvc.txt
==============================================================================

--- branches/Version14x/Scribus/BUILDING_win32_msvc.txt (original)
+++ branches/Version14x/Scribus/BUILDING_win32_msvc.txt Wed Jun 24 23:34:03 2015
@@ -6,12 +6,12 @@
 related tools will be provided.
 
 You will need:
-	- Microsoft Windows XP, Vista, 7 or a more recent version
-	- Microsoft Visual Studio 2008 (for 32bit build) or Microsoft Visual Studio 2012 (for 32/64bit build)
-	- A recent Qt release built with corresponding Visual Studio version (version >= 4.6)
-	- Common libraries kit downloaded from http://sourceforge.net/projects/scribus/files/scribus-libs/
-	- Scribus 14x libraries kit downloaded from http://sourceforge.net/projects/scribus/files/scribus-libs/
-	
+- Microsoft Windows XP, Vista, 7 or a more recent version
+- Microsoft Visual Studio 2008 (for 32bit build) or Microsoft Visual Studio 2012 (for 32/64bit build)
+- A recent Qt release built with corresponding Visual Studio version (version >= 4.6)
+- Common libraries kit downloaded from http://sourceforge.net/projects/scribus/files/scribus-libs/
+- Scribus 14x libraries kit downloaded from http://sourceforge.net/projects/scribus/files/scribus-libs/
+
 It is possible to use Microsoft Visual Studio 2008 or 2012 Express editions. However in the case of Microsoft
 Visual Studio 2008 Express, SP1 is required in order to build the dependency archive.
 
@@ -30,15 +30,14 @@
 Download the latest Qt 4 release from http://download.qt.io/official_releases/qt/4.8/ and unpack it to C:\Developer.
 
 Start a command line and import your Visual Studio environment:
-\path\to\visual\studio\VC\vcvarsall.bat x86 (for 32bit build)
-or 
-\path\to\visual\studio\VC\vcvarsall.bat x86_amd64 (for 64bit build)
+- for building 32bit : \path\to\visual\studio\VC\vcvarsall.bat x86
+- for building 64bit : \path\to\visual\studio\VC\vcvarsall.bat x86_amd64
 
-Note: with Visual Studio Express Editions, it is not possible to compile in 64bit mode prior to Visual Studio 2012.
+Note: with Visual Studio Express editions, it is not possible to compile in 64bit mode prior to Visual Studio 2012.
 
-now cd to C:\Developer\qt-everywhere-whatever and run configure:
-	- Visuak Studio 2008 : configure -platform win32-msvc2008 -debug-and-release -no-qt3support -no-webkit -no-script -noscripttools 
-	- Visuak Studio 2012 : configure -platform win32-msvc2012 -debug-and-release -no-qt3support -no-webkit -no-script -noscripttools 
+Now cd to C:\Developer\qt-everywhere-whatever and run configure:
+- Visuak Studio 2008 : configure -platform win32-msvc2008 -debug-and-release -no-qt3support -no-webkit -no-script -noscripttools 
+- Visuak Studio 2012 : configure -platform win32-msvc2012 -debug-and-release -no-qt3support -no-webkit -no-script -noscripttools 
 
 After configure has finished its work, run nmake.
 
@@ -51,37 +50,37 @@
 Building 3rd party libraries:
 -----------------------------
 
-Archives with ready-to-build solutions for scribus dependencies have been made available on sourceforge. These archives can be used to
-compile all dependencies necessary for Scribus.
+Archives with ready-to-build solutions for scribus dependencies have been made available on Sourceforge: 
+http://sourceforge.net/projects/scribus/files/scribus-libs/
+These archives can be used to compile all dependencies necessary for Scribus.
 
 Two different archives are needed :
-	- common libraries for 14x and trunk : contains boost and python, no compilation is required here
-	- Scribus 14x specific libraries : libraries used to compile current Scribus 1.4.x releases
+- scribus-commmon-libs-YYYYMMDD.7z : common libraries for 14x and trunk, no compilation is required here
+- scribus-14x-libs-msvcXXXX-YYYYMMDD.7z : Scribus 14x specific libraries used for current Scribus 1.4.x releases
 
-Common libraries and version specific libraries can be downloaded on Sourceforge from this directory:
-http://sourceforge.net/projects/scribus/files/scribus-libs/
+These archives are named using a scheme where:
+- msvcXXXX represent the Visual Studio version needed to compile provided Visual Studio solution
+- YYYYMMDD represents the date where the archive has been prepared/uploaded to Sourceforge.
 
-Common libraries are named with following scheme : scribus-commmon-libs-XXXXXX where XXXXX represents a date.
-Archives with version specific libraries are named using following scheme scribus-14x-libs-msvcXXXX-XXXXXX where :
-	- msvcXXXX represent the Visual Studio version needed to compile provided Visual Studio solution
-	- XXXXXX is a series of numbers representing a date.
-
-For building 14x, archives are provided for Visual Studio 2008 and Visual Studio 2012. The Visual Studio 2008 archives allows to build 
-libraries targeted at Windows 2000 SP4, Windows XP and more recent Windows systems. The Visual Studio 2012 archives allows to build 
-libraries for 32bit and 64bit platforms. Produced binaries can be used on Windows Vista and up. If you plan to use a more recent 
-Visual Studio version than Visual Studio 2012, download the archives for Visual Studio 2012.
+For building 14x dependencies, archives are provided for Visual Studio 2008 and Visual Studio 2012. The Visual Studio 2008 archive 
+allows to build libraries targeted at Windows 2000 SP4, Windows XP and more recent Windows systems. The Visual Studio 2012 archive 
+allows to build libraries for 32bit and 64bit platforms which can be used on Windows Vista and up. If you plan to use a more recent 
+Visual Studio version, download the archives for Visual Studio 2012.
 
 Once you downloaded the two appropriate archives :
-	- decompress them in the *same* directory.
-	- open the visual studio solution (*.sln) located in the scribus-1.4.x-libs-* directory
-	- build debug and release configurations for all platforms (Win32 and/or x64) you plan to execute scribus on
+- decompress them in the *same* directory so as to get a layout similar to this one :
+    - your_script_libs_directory
+       |- scribus-1.4.x-libs-msvcXXXX
+       |- scribus-common-libs
+- open the visual studio solution (*.sln) located in the scribus-1.4.x-libs-* directory
+- build debug and release configurations for all platforms (Win32 and/or x64) you plan to execute scribus on
 
 BUILDING SCRIBUS
 ====================
 
 After having installed all dependencies:
-	- msvc 2008 : open Scribus-build-props.vsprops files located in Scribus\win32\vc9 in a text editor 
-	- msvc 2012 : open Scribus-build-props.props files located in Scribus\win32\vc11 in a text editor
+- msvc 2008 : open Scribus-build-props.vsprops files located in Scribus\win32\vc9 in a text editor 
+- msvc 2012 : open Scribus-build-props.props files located in Scribus\win32\vc11 in a text editor
 Update the dependency paths to match your system.
 
 Open the Visual Studio solution located in same directoy and start building.
@@ -115,25 +114,25 @@
  copy %SCRIBUS_SRC_PATH%\scribus\plugins\tools\pathfinder\*.png %SCRIBUS_INSTALL_PATH%\share\icons\ /y
 xcopy %SCRIBUS_SRC_PATH%\scribus\plugins\scriptplugin\scripts %SCRIBUS_INSTALL_PATH%\share\scripts /s /y /D
 xcopy %SCRIBUS_SRC_PATH%\scribus\plugins\scriptplugin\samples %SCRIBUS_INSTALL_PATH%\share\samples /s /y
-copy %SCRIBUS_SRC_PATH%\scribus\plugins\import\ps\import.prolog %SCRIBUS_INSTALL_PATH%\libs\import.prolog
-copy %SCRIBUS_SRC_PATH%\scribus\plugins\barcodegenerator\barcode.ps %SCRIBUS_INSTALL_PATH%\share\plugins\barcode.ps
-copy %SCRIBUS_SRC_PATH%\scribus\unicodemap\unicodenameslist.txt %SCRIBUS_INSTALL_PATH%\share\unicodenameslist.txt
-del %SCRIBUS_BUILD_ROOT%\*CMake* /s
-del %SCRIBUS_BUILD_ROOT%\*MakeFile* /s
+copy  %SCRIBUS_SRC_PATH%\scribus\plugins\import\ps\import.prolog %SCRIBUS_INSTALL_PATH%\libs\import.prolog
+copy  %SCRIBUS_SRC_PATH%\scribus\plugins\barcodegenerator\barcode.ps %SCRIBUS_INSTALL_PATH%\share\plugins\barcode.ps
+copy  %SCRIBUS_SRC_PATH%\scribus\unicodemap\unicodenameslist.txt %SCRIBUS_INSTALL_PATH%\share\unicodenameslist.txt
+del   %SCRIBUS_BUILD_ROOT%\*CMake* /s
+del   %SCRIBUS_BUILD_ROOT%\*MakeFile* /s
 
 Adjust SCRIBUS_SRC_PATH, SCRIBUS_BUILD_ROOT and SCRIBUS_INSTALL_PATH as needed and run batch script.
 
 To install common libs:
-	- open the scribus-common-libs directory where you uncompressed 14x/trunk libs
-	- open the copy-dlls-to-14x-build-dir.bat file from scribus-common-libs directory in a text editor
-	- modify the SCRIBUS_DEBUG_BUILD_*, SCRIBUS_RELEASE_BUILD_* and PYTHON_DIR_* variables appropriately
-	- execute batch file to copy appropriate files to build directory
+- open the scribus-common-libs directory where you uncompressed 14x/trunk libs
+- open the copy-dlls-to-14x-build-dir.bat file from scribus-common-libs directory in a text editor
+- modify the SCRIBUS_DEBUG_BUILD_*, SCRIBUS_RELEASE_BUILD_* and PYTHON_DIR_* variables appropriately
+- execute batch file to copy appropriate files to build directory
 
 To install version specific libs:
-	- open the scribus-14x-libs-msvc* directory where you uncompressed Scribus 14x libs
-	- open the copy-*-dlls-to-build-dir.bat file in a text editor
-	- modify the SCRIBUS_DEBUG_BUILD and SCRIBUS_RELEASE_BUILD variables appropriately (note: enclose path in double quotes if those contain spaces)
-	- execute batch file to copy appropriate dlls to build directory
+- open the scribus-14x-libs-msvc* directory where you uncompressed Scribus 14x libs
+- open the copy-*-dlls-to-build-dir.bat file in a text editor
+- modify the SCRIBUS_DEBUG_BUILD and SCRIBUS_RELEASE_BUILD variables appropriately (note: enclose path in double quotes if those contain spaces)
+- execute batch file to copy appropriate dlls to build directory
 
 Finally copy Qt DLLs to build directory and Qt plugins directory to "qtplugins" directory.
 Scribus should now run.


