yay for cookies

Original commit message from CVS:
yay for cookies

1 files changed, 44 insertions, 5 deletions

diff --git a/README b/README
index 99fd6aceb..12c083652 100644
--- a/README
+++ b/README
@@ -1,3 +1,5 @@
+WHAT IT IS
+----------
 This is GStreamer, a framework for streaming media.  The
 fundamental design comes from the video pipeline at Oregon Graduate
 Institute, as well as some ideas from DirectMedia.  It's based on plug-ins
@@ -6,22 +8,54 @@ interface hopefully is generic enough for various companies (ahem, Apple)
 to release binary codecs for Linux, until such time as they get a clue and
 release the source.
 
+COMPILING FROM SOURCE
+---------------------
+- check output of ./configure --help to see if any options apply to you
+- run
+  ./configure
+  make
 
-Developer note:  When building from CVS sources, you will need to run
-autogen.sh to generate the build system files.
+  to build GStreamer.
+- if you want to install it (not required), run
+  make install
+- You should create a registry for things to work.
+  If you ran make install in the previous step, run
+  gst-register
+  as root.
+
+  If you didn't install, run
+  tools/gst-register
+  as a normal user.
+
+- try out a simple test:
+  gst-launch fakesrc num_buffers=5 ! fakesink
+  (If you didn't install GStreamer, again prefix gst-launch with tools/)
+
+  If it outputs a bunch of messages from fakesrc and fakesink, everything is
+  ok.
+
+- After this, you're ready to install gst-plugins, which will provide the
+  functionality you're probably looking for by now, so go on and read
+  that README.
+
+COMPILING FROM CVS
+------------------
+When building from CVS sources, you will need to run autogen.sh to generate 
+the build system files.
 
 GStreamer is cutting-edge stuff.  To be a CVS developer, you need 
-cutting-edge tools.
+what used to be considered cutting-edge tools.
 
 ATM, most of us have at least these versions :
 
 * autoconf	2.52	(NOT 2.52d)
 * automake	1.5
-* libtool	1.4
+* libtool	1.4     (NOT Gentoo's genetic failure 1.4.2)
 * pkg-config    0.8.0
 
 autogen.sh will check for these versions and complain if you don't have 
-them.	
+them.  You can also specify specific versions of automake and autoconf with
+--with-automake and --with-autoconf
 
 Check autogen.sh options by running autogen.sh --help
 
@@ -30,3 +64,8 @@ from autogen.sh with -- between the two.
 prefix has been added to autogen.sh but will be passed on to configure because
 some build scripts like that.
 
+When you have done this once, you can use autoregen.sh to re-autogen with
+the last passed options as a handy shortcut.  Use it.
+
+After the autogen.sh stage, you can follow the directions listed in
+"COMPILING FROM SOURCE"