doc: misc improvements for the Windows section

Fix some orthography, wording and grammar issues; update the SDL section
with more current instructions; simplify lib.exe example command line;
drop outdated comments about libnut.
This commit is contained in:
Diego Biurrun 2012-05-10 14:18:10 +02:00
parent 7b089b79e6
commit d19f3e9a2a

View File

@ -84,7 +84,7 @@ instructions in the download section and the FAQ.
Libav does not build out-of-the-box with the packages the automated MinGW Libav does not build out-of-the-box with the packages the automated MinGW
installer provides. It also requires coreutils to be installed and many other installer provides. It also requires coreutils to be installed and many other
packages updated to the latest version. The minimum version for some packages packages updated to the latest version. The minimum versions for some packages
are listed below: are listed below:
@itemize @itemize
@ -104,17 +104,14 @@ Notes:
@item Building natively using MSYS can be sped up by disabling implicit rules @item Building natively using MSYS can be sped up by disabling implicit rules
in the Makefile by calling @code{make -r} instead of plain @code{make}. This in the Makefile by calling @code{make -r} instead of plain @code{make}. This
speed up is close to non-existent for normal one-off builds and is only speed up is close to non-existent for normal one-off builds and is only
noticeable when running make for a second time (for example in noticeable when running make for a second time (for example during
@code{make install}). @code{make install}).
@item In order to compile AVplay, you must have the MinGW development library @item In order to compile AVplay, you must have the MinGW development library
of @uref{http://www.libsdl.org/, SDL}. of @uref{http://www.libsdl.org/, SDL} and @code{pkg-config} installed.
Edit the @file{bin/sdl-config} script so that it points to the correct prefix
where SDL was installed. Verify that @file{sdl-config} can be launched from
the MSYS command line.
@item By using @code{./configure --enable-shared} when configuring Libav, @item By using @code{./configure --enable-shared} when configuring Libav,
you can build libavutil, libavcodec and libavformat as DLLs. you can build all libraries as DLLs.
@end itemize @end itemize
@ -134,7 +131,7 @@ you might have to modify the procedures slightly.
@subsection Using static libraries @subsection Using static libraries
Assuming you have just built and installed Libav in @file{/usr/local}. Assuming you have just built and installed Libav in @file{/usr/local}:
@enumerate @enumerate
@ -257,14 +254,11 @@ are stored.
@item Generate new import libraries with @file{lib.exe}: @item Generate new import libraries with @file{lib.exe}:
@example @example
lib /machine:i386 /def:..\lib\avcodec-53.def /out:avcodec.lib lib /machine:i386 /def:..\lib\foo-version.def /out:foo.lib
lib /machine:i386 /def:..\lib\avdevice-53.def /out:avdevice.lib
lib /machine:i386 /def:..\lib\avfilter-2.def /out:avfilter.lib
lib /machine:i386 /def:..\lib\avformat-53.def /out:avformat.lib
lib /machine:i386 /def:..\lib\avutil-51.def /out:avutil.lib
lib /machine:i386 /def:..\lib\swscale-2.def /out:swscale.lib
@end example @end example
Replace @code{foo-version} and @code{foo} with the respective library names.
@end enumerate @end enumerate
@anchor{Cross compilation for Windows with Linux} @anchor{Cross compilation for Windows with Linux}
@ -306,8 +300,8 @@ Then run
to make a static build. to make a static build.
The current @code{gcc4-core} package is buggy and needs this flag to build To build shared libraries add a special compiler flag to work around current
shared libraries: @code{gcc4-core} package bugs in addition to the normal configure flags:
@example @example
./configure --enable-shared --disable-static --extra-cflags=-fno-reorder-functions ./configure --enable-shared --disable-static --extra-cflags=-fno-reorder-functions
@ -327,11 +321,8 @@ yasm, libSDL-devel, libfaac-devel, libgsm-devel, libmp3lame-devel,
libschroedinger1.0-devel, speex-devel, libtheora-devel, libxvidcore-devel libschroedinger1.0-devel, speex-devel, libtheora-devel, libxvidcore-devel
@end example @end example
The recommendation for libnut and x264 is to build them from source by The recommendation for x264 is to build it from source, as it evolves too
yourself, as they evolve too quickly for Cygwin Ports to be up to date. quickly for Cygwin Ports to be up to date.
Cygwin 1.7.x has IPv6 support. You can add IPv6 to Cygwin 1.5.x by means
of the @code{libgetaddrinfo-devel} package, available at Cygwin Ports.
@section Crosscompilation for Windows under Cygwin @section Crosscompilation for Windows under Cygwin