Automatic update of common submodule

From 59cb678 to a825d27
This commit is contained in:
Tim-Philipp Müller 2020-10-20 15:09:52 +01:00
parent e846ef2221
commit c899387b54
2 changed files with 52 additions and 53 deletions

103
README
View file

@ -9,17 +9,24 @@ WHERE TO START
-------------- --------------
We have a website at We have a website at
http://gstreamer.freedesktop.org/
You should start by going through our FAQ at https://gstreamer.freedesktop.org
http://gstreamer.freedesktop.org/data/doc/gstreamer/head/faq/html/
There is more documentation; go to Our documentation, including tutorials, API reference and FAQ can be found at
http://gstreamer.freedesktop.org/documentation
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
Follow us on Twitter: https://twitter.com/GStreamer
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 You can join us on IRC - #gstreamer on irc.freenode.org
@ -137,12 +144,11 @@ PLATFORMS
--------- ---------
- Linux is of course fully supported - Linux is of course fully supported
- FreeBSD is reported to work; other BSDs should work too - FreeBSD is reported to work; other BSDs should work too; same for Solaris
- Solaris is reported to work; a specific sunaudiosink plugin has been written - MacOS works, binary 1.x packages can be built using the cerbero build tool
- MacOSX 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 - Windows works; binary 1.x packages can be built using the cerbero build tool
- MSys/MinGW builds - 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 - Android works, binary 1.x packages can be built using the cerbero build tool
- iOS works - iOS works
@ -151,36 +157,49 @@ INSTALLING FROM PACKAGES
You should always prefer installing from packages first. GStreamer is You should always prefer installing from packages first. GStreamer is
well-maintained for a number of distributions, including Fedora, Debian, well-maintained for a number of distributions, including Fedora, Debian,
Ubuntu, Mandrake, Gentoo, ... Ubuntu, Mandrake, Arch Linux, Gentoo, ...
Only in cases where you: Only in cases where you:
- want to hack on GStreamer
- want to verify that a bug has been fixed - want to hack on GStreamer
- do not have a sane distribution - 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. should you choose to build from source tarballs or git.
Find more information about the various packages at Find more information about the various packages at
http://gstreamer.freedesktop.org/download/
https://gstreamer.freedesktop.org/download/
COMPILING FROM SOURCE TARBALLS 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, If GStreamer is one of your first projects ever that you build from source,
consider taking on an easier project. 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 - run
./configure
make meson build
ninja -C build
to build GStreamer. to build GStreamer.
- if you want to install it (not required, but what you usually want to do), run - 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: - try out a simple test:
gst-launch -v fakesrc num_buffers=5 ! fakesink gst-launch-1.0 -v fakesrc num_buffers=5 ! fakesink
(If you didn't install GStreamer, prefix gst-launch with tools/) (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 If it outputs a bunch of messages from fakesrc and fakesink, everything is
ok. ok.
@ -196,39 +215,19 @@ COMPILING FROM SOURCE TARBALLS
COMPILING FROM GIT COMPILING FROM GIT
------------------ ------------------
When building from git sources, you will need to run autogen.sh to generate You can build an uninstalled GStreamer from git for development or testing
the build system files. purposes without affecting your system installation.
You will need a set of additional tools typical for building from git, Get started with:
including:
- autoconf
- automake
- libtool
autogen.sh will check for recent enough versions and complain if you don't have git clone https://gitlab.freedesktop.org/gstreamer/gst-build
them. You can also specify specific versions of automake and autoconf with meson build
--with-automake and --with-autoconf ninja -C build
ninja -C build uninstalled
Check autogen.sh options by running autogen.sh --help For more information, see the `gst-build` module and its documentation:
autogen.sh can pass on arguments to configure https://gitlab.freedesktop.org/gstreamer/gst-build/blob/master/README.md
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 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.
There is a 'create-uninstalled-setup.sh' script in
http://cgit.freedesktop.org/gstreamer/gstreamer/tree/scripts/
to easily create an uninstalled setup from scratch.
PLUG-IN DEPENDENCIES AND LICENSES PLUG-IN DEPENDENCIES AND LICENSES

2
common

@ -1 +1 @@
Subproject commit 59cb678164719ff59dcf6c8b93df4617a1075d11 Subproject commit a825d2773adaeec23369d0770098b2c44ca7377a