Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Remove autotools build system
  • Loading branch information
tp-m committed Oct 13, 2019
1 parent 2409f4f commit 289d8e5
Show file tree
Hide file tree
Showing 169 changed files with 56 additions and 7,919 deletions.
64 changes: 2 additions & 62 deletions .gitignore
@@ -1,63 +1,5 @@
aclocal.m4
autom4te.cache
config.h
config.h.in
config.log
config.status
config.guess
config.sub
config.rpath
configure
gstreamer-libs-uninstalled*.pc
gstreamer-libs*.pc
gstreamer-play-uninstalled*.pc
gstreamer-play*.pc
libtool
stamp-h
stamp-h.in
stamp-h1
gst-element-check-*.m4
ltmain.sh
missing
mkinstalldirs
compile
install-sh
depcomp
autoregen.sh
ABOUT-NLS
/INSTALL
_stdint.h

gst-plugins-base-*.tar*

.deps
.libs
*.lo
*.la
*.o
*~
*.bak
/m4
Makefile.in
Makefile
*.gir
*.typelib
*.gc??
.dirstamp

/gst-libs/gst/pbutils/gstpluginsbaseversion.h
/gst-libs/gst/tag/mklangtables
/gst-libs/gst/tag/mklicensestables

/gst-libs/gst/audio/audio-marshal.[ch]
/gst-libs/gst/video/video-marshal.[ch]
/gst-libs/gst/*/*-enumtypes.[ch]
/tests/examples/compositor/crossfade
/tests/examples/playback/playback-test

tmp-orc.c
gst*orc.h
tests/check/orc

Build
*.user
Expand All @@ -67,9 +9,7 @@ Build
*.opensdf
*.DS_Store

/test-driver
*.trs
*.log

# Meson
/build
/_build
/subprojects
3 changes: 0 additions & 3 deletions .gitmodules

This file was deleted.

86 changes: 0 additions & 86 deletions Makefile.am

This file was deleted.

103 changes: 50 additions & 53 deletions README
Expand Up @@ -9,17 +9,22 @@ WHERE TO START
--------------

We have a website at
http://gstreamer.freedesktop.org/

You should start by going through our FAQ at
http://gstreamer.freedesktop.org/data/doc/gstreamer/head/faq/html/
https://gstreamer.freedesktop.org

There is more documentation; go to
http://gstreamer.freedesktop.org/documentation
Our documentation, including tutorials, API reference and FAQ can be found at

You can subscribe to our mailing lists; see the website for details.
https://gstreamer.freedesktop.org/documentation/

We track bugs in GNOME's bugzilla; see the website for details.
You can subscribe to our mailing lists:

https://lists.freedesktop.org/mailman/listinfo/gstreamer-announce

https://lists.freedesktop.org/mailman/listinfo/gstreamer-devel

We track bugs, feature requests and merge requests (patches) in GitLab at

https://gitlab.freedesktop.org/gstreamer/

You can join us on IRC - #gstreamer on irc.freenode.org

Expand Down Expand Up @@ -137,12 +142,11 @@ PLATFORMS
---------

- Linux is of course fully supported
- FreeBSD is reported to work; other BSDs should work too
- Solaris is reported to work; a specific sunaudiosink plugin has been written
- MacOSX works, binary 1.x packages can be built using the cerbero build tool
- FreeBSD is reported to work; other BSDs should work too; same for Solaris
- MacOS works, binary 1.x packages can be built using the cerbero build tool
- Windows works; binary 1.x packages can be built using the cerbero build tool
- MSys/MinGW builds
- Microsoft Visual Studio builds are not yet available or supported
- Microsoft Visual Studio builds are also available and supported
- Android works, binary 1.x packages can be built using the cerbero build tool
- iOS works

Expand All @@ -151,36 +155,49 @@ 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, ...
Ubuntu, Mandrake, Arch Linux, 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

- 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 git.

Find more information about the various packages at
http://gstreamer.freedesktop.org/download/

https://gstreamer.freedesktop.org/download/

COMPILING FROM SOURCE TARBALLS
------------------------------

- again, make sure that you really need to install from source !
- 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
- you need a recent version of Meson installed, see

http://mesonbuild.com/Getting-meson.html

and

https://gitlab.freedesktop.org/gstreamer/gst-build/blob/master/README.md

- run
./configure
make

meson build
ninja -C build

to build GStreamer.

- if you want to install it (not required, but what you usually want to do), run
make install

ninja -C build install

- try out a simple test:
gst-launch -v fakesrc num_buffers=5 ! fakesink
(If you didn't install GStreamer, prefix gst-launch with tools/)
gst-launch-1.0 -v fakesrc num_buffers=5 ! fakesink
(If you didn't install GStreamer, run `./build/tools/gst-launch-1.0`)

If it outputs a bunch of messages from fakesrc and fakesink, everything is
ok.
Expand All @@ -196,45 +213,25 @@ COMPILING FROM SOURCE TARBALLS
COMPILING FROM GIT
------------------

When building from git sources, you will need to run autogen.sh to generate
the build system files.

You will need a set of additional tools typical for building from git,
including:
- autoconf
- automake
- libtool

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

Check autogen.sh options by running autogen.sh --help

autogen.sh can pass on arguments to configure

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"
You can build an uninstalled GStreamer from git for development or testing
purposes without affecting your system installation.

You can also run your whole git stack uninstalled in your home directory,
so that you can quickly test changes without affecting your system setup or
interfering with GStreamer installed from packages. Many GStreamer developers
use an uninstalled setup for their work.
Get started with:

There is a 'create-uninstalled-setup.sh' script in
git clone https://gitlab.freedesktop.org/gstreamer/gst-build
meson build
ninja -C build
ninja -C build uninstalled

http://cgit.freedesktop.org/gstreamer/gstreamer/tree/scripts/
For more information, see the `gst-build` module and its documentation:

to easily create an uninstalled setup from scratch.
https://gitlab.freedesktop.org/gstreamer/gst-build/blob/master/README.md


PLUG-IN DEPENDENCIES AND LICENSES
---------------------------------

GStreamer is developed under the terms of the LGPL (see LICENSE file for
GStreamer is developed under the terms of the LGPL (see COPYING file for
details). Some of our plug-ins however rely on libraries which are available
under other licenses. This means that if you are distributing an application
which has a non-GPL compatible license (for instance a closed-source
Expand Down

0 comments on commit 289d8e5

Please sign in to comment.