ignore more; fix README
authorThomas Vander Stichele <thomas@apestaart.org>
Fri, 17 Jun 2005 08:59:41 +0000 (08:59 +0000)
committerThomas Vander Stichele <thomas@apestaart.org>
Fri, 17 Jun 2005 08:59:41 +0000 (08:59 +0000)
Original commit message from CVS:
ignore more; fix README

.gitignore
ChangeLog
README
check/.gitignore
examples/manual/.gitignore
gst/.gitignore
tests/check/.gitignore
tests/old/examples/manual/.gitignore

index 7ae0e3f..91ec20b 100644 (file)
@@ -34,3 +34,4 @@ install-sh
 mkinstalldirs
 py-compile
 registry.xml
+coverage-report.txt
index e2f80f1..f5447f8 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -6,6 +6,15 @@
 
 2005-06-09  Thomas Vander Stichele  <thomas at apestaart dot org>
 
+       * gst/elements/gstfakesrc.c: (gst_fakesrc_create):
+         fix debug output
+       * gst/schedulers/Makefile.am:
+         use libgst prefix
+       * gstreamer.spec.in:
+         fix spec for it
+
+2005-06-09  Thomas Vander Stichele  <thomas at apestaart dot org>
+
        * gstreamer.spec.in:
          clean up
 
diff --git a/README b/README
index 1dbcd0b..4799e5c 100644 (file)
--- a/README
+++ b/README
@@ -1,15 +1,46 @@
 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
-that will provide the various codec and other functionality.  The
-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
----------------------
+This is GStreamer, a framework for streaming media.
+
+This package is in the 0.9.x series.  This means that this is a
+development series leading up to a stable 0.10.x series.
+You have been warned.
+
+OVERVIEW
+--------
+GStreamer is split up over a number of modules, tarballs and packages:
+
+- gstreamer:
+  The core.  It contains the main library and header files, as well as
+  some fundamental elements.  Every GStreamer project needs at least this
+  installed.
+- gst-plugins-base:
+  A base set of plugins.  This set is the set we actively keep synchronized
+  with the core and are also meant to serve as examples on how to write
+  GStreamer elements.  It also contains a number of base classes for writing
+  GStreamer elements.
+
+INSTALLING FROM PACKAGES
+------------------------
+You should always prefer installing from packages first.  GStreamer is
+well-maintained for a number of distributions, including Fedora, Debian,
+Ubuntu, Mandrake, Gentoo, ...
+
+Only in cases where you:
+- want to hack on GStreamer
+- want to verify that a bug has been fixed
+- do not have a sane distribution
+should you choose to build from source tarballs or CVS.
+
+Find more information about the various packages at
+http://gstreamer.freedesktop.org/download/
+
+COMPILING FROM SOURCE TARBALLS
+------------------------------
+- again, make sure that you really need to install from source !
+  If GStreamer is one of your first projects ever that you build from source,
+  consider taking on an easier project.
+
 - check output of ./configure --help to see if any options apply to you
 - run
   ./configure
@@ -43,17 +74,13 @@ 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 
-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     (NOT Gentoo's genetic failure 1.4.2)
-* pkg-config    0.8.0
+You will need a set of additional tools typical for building from CVS,
+including:
+- autoconf
+- automake
+- libtool
 
-autogen.sh will check for these versions and complain if you don't have 
+autogen.sh will check for recent enough versions and complain if you don't have
 them.  You can also specify specific versions of automake and autoconf with
 --with-automake and --with-autoconf
 
@@ -70,3 +97,11 @@ 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"
 
+HISTORY
+-------
+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 that
+will provide the various codec and other functionality.  The 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.
index 5d45c6c..597c6e8 100644 (file)
@@ -1 +1,2 @@
 test-registry.xml
+*.gcno
index 2459423..964c94a 100644 (file)
@@ -11,6 +11,7 @@ dynamic
 elementget
 elementmake
 gnome
+fakesrc
 helloworld
 helloworld2
 init
@@ -26,6 +27,7 @@ ghostpad
 pad
 playbin
 query
+typefind
 
 xml-mp3
 xml
index e7125ab..125befe 100644 (file)
@@ -15,3 +15,4 @@ gstconfig.h
 *.bbg
 *.da
 *.def
+*.gcno
index 5d45c6c..597c6e8 100644 (file)
@@ -1 +1,2 @@
 test-registry.xml
+*.gcno
index 2459423..964c94a 100644 (file)
@@ -11,6 +11,7 @@ dynamic
 elementget
 elementmake
 gnome
+fakesrc
 helloworld
 helloworld2
 init
@@ -26,6 +27,7 @@ ghostpad
 pad
 playbin
 query
+typefind
 
 xml-mp3
 xml