vlc_plugin: allow overriding module meta-infos

[vlc] / INSTALL

diff --git a/INSTALL b/INSTALL
index a27e29d8d875baaa82bba9a78b909a7f4c4a13f9..c0acd638b9c1e8137aa4f9cdd546280af8316881 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,39 +1,55 @@
-INSTALL file for vlc, the VideoLAN Client
+INSTALL file for the VLC media player
+=====================================
 
+More extensive information for *nix, Windows and Mac OS X users can be
+found here: http://wiki.videolan.org/Compile_VLC
 
-Building VideoLAN
+People installing VLC for Windows from source MUST read:
+http://wiki.videolan.org/Win32Compile
+
+Bootstrapping VLC
 =================
 
-A typical way to configure vlc is:
+If you retrieved VLC from the git server and do not have yet a "configure"
+script, please run:
+
+    ./bootstrap
+
+Configuring VLC
+===============
 
-   ./configure --prefix=/usr --enable-gnome --with-sdl
+A typical way to configure VLC is:
+
+   ./configure
 
 See `./configure --help' for more information.
 
-Then, run `make' to build vlc.
+If you intend to debug stuff, you may want to compile with debugging
+symbols:
+
+   make distclean ; ./configure --enable-debug
 
-Here is a shortcut to copy-paste for a complete build:
+We recommend using GCC to build VLC, though some people reported success
+with the Intel C compiler (version 8) as well. GCC version 3.3 or higher is
+required. On older systems (e.g. FreeBSD 4.x), please select a more recent
+version manually by setting the CC and CXX environment variables
+appropriately while running the ./configure shell script.
 
-   make distclean 2>/dev/null ; ./configure --prefix=/usr --enable-gnome \
-      --enable-fb --with-glide --with-ggi --with-sdl --enable-esd \
-      --enable-alsa --enable-mga --enable-gtk --enable-qt && make
 
-If you intend to debug stuff, you may want to disable optimizations:
+Building VLC
+============
 
-   make distclean 2>/dev/null ; ./configure --prefix=/usr --enable-gnome \
-      --enable-fb --with-glide --with-ggi --with-sdl --enable-esd \
-      --enable-alsa --enable-mga --enable-gtk --enable-qt \
-      --disable-optimizatons && make
+Once configured, run `make' to build VLC.
 
 
-Installing and running VideoLAN
-===============================
+Installing and running VLC
+==========================
 
-You can install the vlc and its plugins by typing:
+You can install the VLC and its plugins by typing:
 
    make install
 
-But you don't need to install it if you don't want to; vlc can be launched
+But you don't need to install it if you don't want to; VLC can be launched
 from the current directory as well:
 
    ./vlc
@@ -42,12 +58,7 @@ from the current directory as well:
 Building packages
 =================
 
-To build a Debian package, you may use:
-
-   dpkg-buildpackage -rfakeroot -us -uc
-
-
-To build RedHat packages, use:
-
-   rpm -ba vlc.spec
-
+To build a Debian package, you need to get the packaging info
+   git clone git://git.debian.org/pkg-multimedia/vlc.git debian
+and then
+   git-buildpackage