1
0
mirror of https://github.com/cookiengineer/audacity synced 2025-07-21 23:18:02 +02:00

* Update for wxwidgets 2.8.11

* Add note that "help" project requires Python
* Add missing section about optional "locale" project
This commit is contained in:
windinthew 2010-07-01 09:48:35 +00:00
parent 119451498b
commit d0f67d3e6b

View File

@ -14,7 +14,7 @@ Authors:
Martyn Shaw Martyn Shaw
======================================================================== ========================================================================
This version is currently accurate for Audacity version 1.3.11. This version is currently accurate for Audacity version 1.3.13. .
If the advice here is inaccurate or incomplete, please If the advice here is inaccurate or incomplete, please
email audacity-devel@lists.sourceforge.net. email audacity-devel@lists.sourceforge.net.
See also See also
@ -46,7 +46,7 @@ attempting to compile Audacity, or nothing will work!
wxWidgets is available at "http://www.wxwidgets.org/". wxWidgets is available at "http://www.wxwidgets.org/".
Audacity 1.3.11 requires wxWidgets 2.8.10. Audacity 1.3.13 requires wxWidgets 2.8.11.
To build on Windows only, download the wxMSW package To build on Windows only, download the wxMSW package
(installer or zip). (installer or zip).
@ -60,21 +60,21 @@ build it.
For wxWidgets' instructions on compilation For wxWidgets' instructions on compilation
(and details about static versus dll linkage), see (and details about static versus dll linkage), see
"C:\wxWidgets-2.8.10\docs\msw\install.txt". "C:\wxWidgets-2.8.11\docs\msw\install.txt".
Note therein that wx_dll.dsw adds the dependencies to Note therein that wx_dll.dsw adds the dependencies to
force the correct build order for DLLs, which wx.dsw force the correct build order for DLLs, which wx.dsw
does not. Because of this, wx_dll.dsw doesn't work for does not. Because of this, wx_dll.dsw doesn't work for
static libraries. static libraries.
1. Open "C:\wxWidgets-2.8.10\build\msw\wx_dll.dsw" with 1. Open "C:\wxWidgets-2.8.11\build\msw\wx_dll.dsw" with
Visual Studio 2008 (for VC9). Visual Studio 2008 (for VC9).
Make sure to use wx_dll.dsw, not wx.dsw, because wx.dsw Make sure to use wx_dll.dsw, not wx.dsw, because wx.dsw
does not have the correct dependencies for the DLL builds. does not have the correct dependencies for the DLL builds.
When you open wx_dll.dsw, Visual Studio will prompt whether When you open wx_dll.dsw, Visual Studio will prompt whether
to convert. Click "Yes To All". Next time you open a Visual to convert. Click "Yes To All". Next time you open a Visual
Studio session, you can avoid this prompt by opening Studio session, you can avoid this prompt by opening
"C\wxWidgets-2.8.10\build\msw\wx_dll.sln" instead of wx_dll.dsw. "C\wxWidgets-2.8.11\build\msw\wx_dll.sln" instead of wx_dll.dsw.
2. If you want to use the accessibility features, we have modified a 2. If you want to use the accessibility features, we have modified a
@ -85,9 +85,9 @@ static libraries.
You may want to make backups of the wxWidgets originals of these, You may want to make backups of the wxWidgets originals of these,
in case you also build without these accessibility features. in case you also build without these accessibility features.
* Copy access.cpp to "C:\wxWidgets-2.8.10\src\msw\ole\". * Copy access.cpp to "C:\wxWidgets-2.8.11\src\msw\ole\".
* Copy setup.h to "C:\wxWidgets-2.8.10\include\wx\msw\". * Copy setup.h to "C:\wxWidgets-2.8.11\include\wx\msw\".
Audacity releases are built with these accessibility features. Audacity releases are built with these accessibility features.
@ -124,7 +124,7 @@ static libraries.
wxbase28*_odbc*.* dbgrid. wxbase28*_odbc*.* dbgrid.
4. Note the directory "C\wxWidgets-2.8.10\lib\vc_dll". For each 4. Note the directory "C\wxWidgets-2.8.11\lib\vc_dll". For each
build of WxWidgets you made, you will need from here five DLLs build of WxWidgets you made, you will need from here five DLLs
appropriate to that build to go in the corresponding Audacity appropriate to that build to go in the corresponding Audacity
build directory. The DLLs required are noted at "Provide access build directory. The DLLs required are noted at "Provide access
@ -147,9 +147,9 @@ MSVC++ STEP 4: Set wxWidgets location for Audacity
Before you can start the build process, you must update the Before you can start the build process, you must update the
project settings to tell Visual C++ where to find wxWidgets. project settings to tell Visual C++ where to find wxWidgets.
There are three settings that need changing: There are three settings that need changing:
1. Include Directory (e.g., "C:\wxWidgets-2.8.10\include") 1. Include Directory (e.g., "C:\wxWidgets-2.8.11\include")
2. Resource Directory (e.g., "C:\wxWidgets-2.8.10\include") 2. Resource Directory (e.g., "C:\wxWidgets-2.8.11\include")
3. Library Directory (e.g., "C:\wxWidgets-2.8.10\lib") 3. Library Directory (e.g., "C:\wxWidgets-2.8.11\lib")
Fortunately, this is parameterized, using a Windows system Fortunately, this is parameterized, using a Windows system
environment variable. There are various ways to set these, so environment variable. There are various ways to set these, so
@ -158,7 +158,7 @@ environment variable WXWIN, set to the top-level directory
where you installed wxWidgets. For example, where you installed wxWidgets. For example,
in your "autoexec.bat" file, you might have a line: in your "autoexec.bat" file, you might have a line:
set WXWIN=C:\wxWidgets-2.8.10 set WXWIN=C:\wxWidgets-2.8.11
Note that you don't want a trailing backslash on that. Note that you don't want a trailing backslash on that.
@ -171,13 +171,14 @@ In the Audacity project file, there are declarations like
$(WXWIN)\include $(WXWIN)\include
that get interpreted as, e.g., "C:\wxWidgets-2.8.10\include". that get interpreted as, e.g., "C:\wxWidgets-2.8.11\include".
Once you have set the WXWIN environment variable correctly, Once you have set the WXWIN environment variable correctly,
the Audacity project file's declarations will do the rest. the Audacity project file's declarations will do the rest.
Note that you have to restart the IDE so it picks up changes Note that you have at least to restart the IDE so it picks up
in the environment variables. changes in the environment variables. It is safer to reboot
the computer to ensure the variables are read correctly.
----------------------- -----------------------
@ -190,13 +191,26 @@ Run Visual C++ and load the Audacity solution,
Optional Features Optional Features
Local help (optional, but required for a full 'release ready' version). 1. Locally installed help is optional, but required for a full release
Build the 'help' project. This will download a copy of the manual wiki build (the "help" folder is included in the installer, but removed from
onto your machine and copy it to the correct place for the build that the zip distribution). The Python library is required, obtainable from
you are doing. If the local copy needs updating at any time, run http://www.python.org/download/ . Add the location of the top-level
audacity\scripts\mw2html_audacity\wiki2htm.bat and re-run the 'help' project. directory where you installed Python to your Path environment
variable. For help with environment variables, see MSVC++ STEP 4 above.
Some functionality in Audacity is currently turned on its default Build the "help" project by enabling it in the MSVC++ Configuration
Manager. This will download a copy of the Manual wiki onto your machine
and copy it to the correct place for your build. If the local copy needs
updating at any time, run audacity\scripts\mw2html_audacity\wiki2htm.bat
and re-build the "help" project.
2. To support languages other than English in your build of Audacity,
you must enable and build the optional "locale" project. This is
required for a full release. You will need to obtain msgfmt.exe from
http://audacity.sourceforge.net/files/msgfmt.zip. Add the location of
the directory containing msgfmt.exe to your Path environment variable.
3. Some functionality in Audacity is currently turned on its default
configuration, but requires that extra libraries be downloaded configuration, but requires that extra libraries be downloaded
separately to use it. separately to use it.
@ -211,7 +225,7 @@ separately to use it.
To change the libraries that are enabled in Audacity, open the file To change the libraries that are enabled in Audacity, open the file
"win\configwin.h" and comment or uncomment the libraries as required. "win\configwin.h" and comment or uncomment the libraries as required.
DirectSound (Microsoft) and ASIO (Steinberg) are sound card interface 4. DirectSound (Microsoft) and ASIO (Steinberg) are sound card interface
protocols that are more efficient than the standard WMME. Unlike WMME, protocols that are more efficient than the standard WMME. Unlike WMME,
not all sound card drivers support them. not all sound card drivers support them.
@ -269,7 +283,7 @@ above. You can copy them to your Windows PATH, or more simply,
to the same directory as the executable. If you are building to the same directory as the executable. If you are building
Audacity for public release using the *.iss installer script, Audacity for public release using the *.iss installer script,
you must copy them to the executable directory. The DLLs required you must copy them to the executable directory. The DLLs required
are at "C:\wxWidgets-2.8.10\lib\vc_dll": are at "C:\wxWidgets-2.8.11\lib\vc_dll":
wxbase28*_net_vc_custom.dll wxbase28*_net_vc_custom.dll
wxbase28*_vc_custom.dll wxbase28*_vc_custom.dll
@ -416,9 +430,9 @@ Cygwin STEP 1: Installing Cygwin
Cygwin STEP 2: Download and install wxWidgets Cygwin STEP 2: Download and install wxWidgets
--------------------------------------- ---------------------------------------
1. Go to http://www.wxwidgets.org/ and download wxWidgets v2.8.10 or greater. Make 1. Go to http://www.wxwidgets.org/ and download wxWidgets v2.8.11 or greater. Make
sure you download the "wxAll" package that contains source code for all ports. The sure you download the "wxAll" package that contains source code for all ports. The
Win32 port will not work for compiling audacity, since it was compiled and installed Win32 port will not work for compiling Audacity, since it was compiled and installed
to work with MS Visual C++. to work with MS Visual C++.
2. Untar the archive from the Cygwin command line, using a command like: 2. Untar the archive from the Cygwin command line, using a command like: