X-Git-Url: http://git.osdn.jp/view?a=blobdiff_plain;f=doc%2FBUILD-Cygwin;h=7f03ca824e97b65c05e9be0ec811fb0789383323;hb=033e32de9c380f54c7d1362a3979da205ebc3a29;hp=5bda0ae13795eee078f080cedbd32e42f78048a3;hpb=9c74658bc092154a42d8660e270f6c91fef78818;p=handbrake-jp%2Fhandbrake-jp-git.git diff --git a/doc/BUILD-Cygwin b/doc/BUILD-Cygwin index 5bda0ae1..7f03ca82 100644 --- a/doc/BUILD-Cygwin +++ b/doc/BUILD-Cygwin @@ -1,4 +1,4 @@ -Guide to Building HandBrake svn2252 (2009031001) on Cygwin +Guide to Building HandBrake svn2591 (2009062101) on Cygwin ********************************************************** Table of Contents @@ -19,6 +19,7 @@ Table of Contents 5.4.4 Contrib Touch and Untouch 5.4.5 Contrib Aggregates 5.5 Customizing Make +6 Troubleshooting Appendix A Project Repository Details @@ -63,11 +64,11 @@ Cygwin; but is not necessarily the only configuration that is possible: The following general tools are used on various platforms and it is recommended you use these versions or similar: - * subversion - 1.5.5 + * subversion - 1.6.2 * python - Python 2.4.6 - * curl - curl 7.19.3 (or wget) + * curl - curl 7.19.4 (or wget) * m4 - GNU M4 1.4.6 @@ -146,10 +147,10 @@ Configure the build system. Configure will automatically create a scratch build directory `build' unless you use GNU-style build procedures and first `cd' to a directory -other than top-level source. Additionally you may specify use `--build' -to specify the directory. The name of the directory is arbitrary but it -is recommended to use something which indicates transient files which -are not checked into the repository. +other than top-level source. Additionally you may use `--build' to +specify the directory. The name of the directory is arbitrary but it is +recommended to use something which indicates transient files which are +not checked into the repository. The `configure' utility accepts many options. It is recommended that you specify `--help' for the complete list of options. The following @@ -172,12 +173,13 @@ options are also documented here: `--launch' All-in-one option which launches the build and logs output - automatically. Useful for novices and quickstart procedures. + automatically. Useful for novices and quick-start procedures. `--disable-xcode' - Disable shunting the build through Xcode. If this option is - applied, `HandBrakeCLI' will be produced in a similare fashion as - it is on other platforms; sans Xcode. Mac OS X only. + Disable shunting the build through `xcodebuild'. If this option is + applied, `HandBrakeCLI' will be produced in a similar fashion as + it is on other platforms; sans Xcode and the Cocoa application + will not be produced. Mac OS X only. `--disable-gtk' Disable building the GTK GUI on applicable platforms such as @@ -213,7 +215,7 @@ some of the reasons why someone may choose to scrap an existing build: * build corruption is suspected There are generally two methods for scrapping a build. The `build' -directory can be recusrively removed which has the effect of loosing +directory can be recursively removed which has the effect of loosing your existing configuration but does guarantee no residuals are left behind. The other method is to ask the build system to perform an `make xclean'. This is known to work well but will leave empty directories @@ -242,7 +244,7 @@ log. The following command allows for up to 4 concurrent jobs via make: The build system supports passing many kinds of targets some of which become very useful in normal development cycles. The targets by convention are lower-case words passed to `make'. Global targets are -one-word targets. Scoped targets are usually two-words seperated by a +one-word targets. Scoped targets are usually two-words separated by a period. 5.4.1 Global @@ -300,13 +302,13 @@ scoped targets: --------------------- Contrib modules such as `a52dec', `bzip2', `faac', `faad2', `ffmpeg', -`lame', `libdca', `libdvdread', `libmkv', `libmp4v2', `libogg', -`libsamplerate', `libtheora', `libvorbis', `mpeg2dec', `x264', -`xvidcore' and `zlib' have the following scoped targets: +`lame', `libdca', `libdvdread', `libmkv', `libogg', `libsamplerate', +`libtheora', `libvorbis', `mp4v2', `mpeg2dec', `x264' and `zlib' have +the following scoped targets: `make MODULE.fetch' Download source tarball from the Internet and save to - `TOP/downloads' directory. No checksumming is performed. + `TOP/downloads' directory. No check-summing is performed. `make MODULE.extract' Extract source tarball into `build' tree. @@ -396,7 +398,7 @@ If the need arises to override settings in the build system (essentially gnu-make variables) the recommended method is to create optional include files which are automatically included if present and follow this naming convention; Do not check these files into the -respository: +repository: `_SRC_/custom.defs' Custom makevar definitions outside `build'. Suitable for settings @@ -423,14 +425,39 @@ be lost. Here is a short example of what the contents of `_SRC_/custom.defs' might contain: ## bump to gcc-4.2 in current path - GCC.gcc = gcc-4.2 + GCC.gcc = /usr/bin/gcc-4.2 - ## replace optimize for 'speed' with more agressive settings + ## replace optimize for 'speed' with more aggressive settings GCC.args.O.speed = -O3 -fomit-frame-pointer -msse4.2 See also `make report.help' which displays a set of reports used to dump makefile vars. +6 Troubleshooting +***************** + +When troubleshooting build issues, the following files relative to the +`build/' directory may be especially useful: + +`GNUmakefile' + Top-level makefile which contains build settings generated via + configure. + +`log/config.info.txt' + Record of output from configure. + +`log/config.verbose.txt' + Record of verbose output from configure. + +`log/build.txt' + Record of output from `configure --launch'. Similar output may be + recorded using `make' depending on which shell is in use, eg: + `make >& log/build.txt' or `make > log/build.txt 2>&1'. + +`log/xcodemake.env.txt' + Environment (variables) dump as seen when Xcode forks `make'. + Mac OS X only. + Appendix A Project Repository Details ************************************* @@ -438,7 +465,7 @@ Appendix A Project Repository Details root: svn://svn.handbrake.fr/HandBrake branch: trunk uuid: b64f7644-9d1e-0410-96f1-a4d463321fa5 - rev: 2252 - date: 2009-03-10 18:43:11 -0400 + rev: 2591 + date: 2009-06-21 13:15:04 -0400 type: developer