[Qemu-devel] [PULL 32/39] qemu-doc: drop installation and compilation notes

[Paolo Bonzini]

These are in README or obsolete, and the detailed version can be on a
website instead.

Reviewed-by: Emilio G. Cota <address@hidden>
Signed-off-by: Paolo Bonzini <address@hidden>
---
 README        |   2 -
 qemu-doc.texi | 249 ----------------------------------------------------------
 2 files changed, 251 deletions(-)

diff --git a/README b/README
index f38193f..bd8060a 100644
--- a/README
+++ b/README
@@ -42,8 +42,6 @@ of other UNIX targets. The simple steps to build QEMU are:
   ../configure
   make
 
-Complete details of the process for building and configuring QEMU for
-all supported host platforms can be found in the qemu-tech.html file.
 Additional information can also be found online via the QEMU website:
 
   http://qemu-project.org/Hosts/Linux
diff --git a/qemu-doc.texi b/qemu-doc.texi
index 9f75c9d..e60c46b 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -32,11 +32,9 @@
 
 @menu
 * Introduction::
-* Installation::
 * QEMU PC System emulator::
 * QEMU System emulator for non PC targets::
 * QEMU User space emulator::
-* compilation:: Compilation from the sources
 * License::
 * Index::
 @end menu
@@ -121,39 +119,6 @@ accelerator is required to use more than one host CPU for 
emulation.
 @end itemize
 
 
address@hidden Installation
address@hidden Installation
-
-If you want to compile QEMU yourself, see @ref{compilation}.
-
address@hidden
-* install_linux::   Linux
-* install_windows:: Windows
-* install_mac::     Macintosh
address@hidden menu
-
address@hidden install_linux
address@hidden Linux
address@hidden installation (Linux)
-
-If a precompiled package is available for your distribution - you just
-have to install it. Otherwise, see @ref{compilation}.
-
address@hidden install_windows
address@hidden Windows
address@hidden installation (Windows)
-
-Download the experimental binary installer at
address@hidden://www.free.oszoo.org/@/download.html}.
-TODO (no longer available)
-
address@hidden install_mac
address@hidden Mac OS X
-
-Download the experimental binary installer at
address@hidden://www.free.oszoo.org/@/download.html}.
-TODO (no longer available)
-
 @node QEMU PC System emulator
 @chapter QEMU PC System emulator
 @cindex system emulation (PC)
@@ -2949,220 +2914,6 @@ Act as if the host page size was 'pagesize' bytes
 Run the emulation in single step mode.
 @end table
 
address@hidden compilation
address@hidden Compilation from the sources
-
address@hidden
-* Linux/Unix::
-* Windows::
-* Cross compilation for Windows with Linux::
-* Mac OS X::
-* Make targets::
address@hidden menu
-
address@hidden Linux/Unix
address@hidden Linux/Unix
-
address@hidden Compilation
-
-First you must decompress the sources:
address@hidden
-cd /tmp
-tar zxvf qemu-x.y.z.tar.gz
-cd qemu-x.y.z
address@hidden example
-
-Then you configure QEMU and build it (usually no options are needed):
address@hidden
-./configure
-make
address@hidden example
-
-Then type as root user:
address@hidden
-make install
address@hidden example
-to install QEMU in @file{/usr/local}.
-
address@hidden Windows
address@hidden Windows
-
address@hidden
address@hidden Install the current versions of MSYS and MinGW from
address@hidden://www.mingw.org/}. You can find detailed installation
-instructions in the download section and the FAQ.
-
address@hidden Download
-the MinGW development library of SDL 1.2.x
-(@file{SDL-devel-1.2.x-@/mingw32.tar.gz}) from
address@hidden://www.libsdl.org}. Unpack it in a temporary place and
-edit the @file{sdl-config} script so that it gives the
-correct SDL directory when invoked.
-
address@hidden Install the MinGW version of zlib and make sure
address@hidden and @file{libz.dll.a} are in
-MinGW's default header and linker search paths.
-
address@hidden Extract the current version of QEMU.
-
address@hidden Start the MSYS shell (file @file{msys.bat}).
-
address@hidden Change to the QEMU directory. Launch @file{./configure} and
address@hidden  If you have problems using SDL, verify that
address@hidden can be launched from the MSYS command line.
-
address@hidden You can install QEMU in @file{Program Files/QEMU} by typing
address@hidden install}. Don't forget to copy @file{SDL.dll} in
address@hidden Files/QEMU}.
-
address@hidden itemize
-
address@hidden Cross compilation for Windows with Linux
address@hidden Cross compilation for Windows with Linux
-
address@hidden
address@hidden
-Install the MinGW cross compilation tools available at
address@hidden://www.mingw.org/}.
-
address@hidden Download
-the MinGW development library of SDL 1.2.x
-(@file{SDL-devel-1.2.x-@/mingw32.tar.gz}) from
address@hidden://www.libsdl.org}. Unpack it in a temporary place and
-edit the @file{sdl-config} script so that it gives the
-correct SDL directory when invoked.  Set up the @code{PATH} environment
-variable so that @file{sdl-config} can be launched by
-the QEMU configuration script.
-
address@hidden Install the MinGW version of zlib and make sure
address@hidden and @file{libz.dll.a} are in
-MinGW's default header and linker search paths.
-
address@hidden
-Configure QEMU for Windows cross compilation:
address@hidden
-PATH=/usr/i686-pc-mingw32/sys-root/mingw/bin:$PATH ./configure 
--cross-prefix='i686-pc-mingw32-'
address@hidden example
-The example assumes @file{sdl-config} is installed under 
@file{/usr/i686-pc-mingw32/sys-root/mingw/bin} and
-MinGW cross compilation tools have names like @file{i686-pc-mingw32-gcc} and 
@file{i686-pc-mingw32-strip}.
-We set the @code{PATH} environment variable to ensure the MinGW version of 
@file{sdl-config} is used and
-use --cross-prefix to specify the name of the cross compiler.
-You can also use --prefix to set the Win32 install path which defaults to 
@file{c:/Program Files/QEMU}.
-
-Under Fedora Linux, you can run:
address@hidden
-yum -y install mingw32-gcc mingw32-SDL mingw32-zlib
address@hidden example
-to get a suitable cross compilation environment.
-
address@hidden You can install QEMU in the installation directory by typing
address@hidden install}. Don't forget to copy @file{SDL.dll} and 
@file{zlib1.dll} into the
-installation directory.
-
address@hidden itemize
-
-Wine can be used to launch the resulting qemu-system-i386.exe
-and all other address@hidden compiled for Win32.
-
address@hidden Mac OS X
address@hidden Mac OS X
-
-System Requirements:
address@hidden
address@hidden Mac OS 10.5 or higher
address@hidden The clang compiler shipped with Xcode 4.2 or higher,
-or GCC 4.3 or higher
address@hidden itemize
-
-Additional Requirements (install in order):
address@hidden
address@hidden libffi: @uref{https://sourceware.org/libffi/}
address@hidden gettext: @uref{http://www.gnu.org/software/gettext/}
address@hidden glib: @uref{http://ftp.gnome.org/pub/GNOME/sources/glib/}
address@hidden pkg-config: 
@uref{http://www.freedesktop.org/wiki/Software/pkg-config/}
address@hidden autoconf: 
@uref{http://www.gnu.org/software/autoconf/autoconf.html}
address@hidden automake: @uref{http://www.gnu.org/software/automake/}
address@hidden pixman: @uref{http://www.pixman.org/}
address@hidden enumerate
-
-* You may find it easiest to get these from a third-party packager
-such as Homebrew, Macports, or Fink.
-
-After downloading the QEMU source code, double-click it to expand it.
-
-Then configure and make QEMU:
address@hidden
-./configure
-make
address@hidden example
-
-If you have a recent version of Mac OS X (OSX 10.7 or better
-with Xcode 4.2 or better) we recommend building QEMU with the
-default compiler provided by Apple, for your version of Mac OS X
-(which will be 'clang'). The configure script will
-automatically pick this.
-
-Note: If after the configure step you see a message like this:
address@hidden
-ERROR: Your compiler does not support the __thread specifier for
-       Thread-Local Storage (TLS). Please upgrade to a version that does.
address@hidden example
-you may have to build your own version of gcc from source. Expect that to take
-several hours. More information can be found here:
address@hidden://gcc.gnu.org/install/} @*
-
-These are some of the third party binaries of gcc available for download:
address@hidden
address@hidden Homebrew: @uref{http://brew.sh/}
address@hidden @uref{https://www.litebeam.net/gcc/gcc_472.pkg}
address@hidden @uref{http://www.macports.org/ports.php?by=name&substr=gcc}
address@hidden itemize
-
-You can have several versions of GCC on your system. To specify a certain 
version,
-use the --cc and --cxx options.
address@hidden
-./configure --cxx=<path of your c++ compiler> --cc=<path of your c compiler> 
<other options>
address@hidden example
-
address@hidden Make targets
address@hidden Make targets
-
address@hidden @code
-
address@hidden make
address@hidden make all
-Make everything which is typically needed.
-
address@hidden install
-TODO
-
address@hidden install-doc
-TODO
-
address@hidden make clean
-Remove most files which were built during make.
-
address@hidden make distclean
-Remove everything which was built during make.
-
address@hidden make dvi
address@hidden make html
address@hidden make info
address@hidden make pdf
-Create documentation in dvi, html, info or pdf format.
-
address@hidden make cscope
-TODO
-
address@hidden make defconfig
-(Re-)create some build configuration files.
-User made changes will be overwritten.
-
address@hidden tar
address@hidden tarbin
-TODO
-
address@hidden table
 
 @node License
 @appendix License
-- 
2.7.4