mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-20 07:16:55 +00:00
faq/git: Remove old autotools document
Instead point to the new "build from source using meson" document Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-docs/-/merge_requests/90>
This commit is contained in:
parent
7dd3be2d49
commit
b5a79eaa17
1 changed files with 2 additions and 96 deletions
|
@ -1,99 +1,5 @@
|
||||||
# Building GStreamer from git
|
# Building GStreamer from git
|
||||||
|
|
||||||
## Is there a way to test or develop against GStreamer from git without interfering with my system GStreamer installed from packages?
|
Refer to the [Building GStreamer from
|
||||||
|
source](installing/building-from-source-using-meson.md) Documentation.
|
||||||
|
|
||||||
Yes! You have two options: you can either run GStreamer in an
|
|
||||||
uninstalled setup (see [How do I develop against an uninstalled
|
|
||||||
GStreamer copy?](#developing-uninstalled-gstreamer)), or you can use
|
|
||||||
GNOME's jhbuild.
|
|
||||||
|
|
||||||
## How do I check out GStreamer from git?
|
|
||||||
|
|
||||||
GStreamer and its various official modules are hosted on Freedesktop.org. For
|
|
||||||
starters, you will likely be interested in the core `gstreamer` module and the
|
|
||||||
basic base functionality provided by the `gst-plugins-base` and
|
|
||||||
`gst-plugins-good` modules. Additionally, and in case you want more
|
|
||||||
comprehensive media format support, you might want to check out the
|
|
||||||
`gst-plugins-ugly`, `gst-plugins-bad` and `gst-libav` modules.
|
|
||||||
|
|
||||||
You can use the following command to download the latest source code for the
|
|
||||||
base modules:
|
|
||||||
|
|
||||||
```
|
|
||||||
for module in gstreamer gst-plugins-base gst-plugins-good; do
|
|
||||||
git clone https://gitlab.freedesktop.org/gstreamer/$module ;
|
|
||||||
done
|
|
||||||
```
|
|
||||||
|
|
||||||
This will create three directories in your current directory: `gstreamer`,
|
|
||||||
`gst-plugins-base`, and `gst-plugins-good`. If you want to get another module,
|
|
||||||
use the above `git clone` command line and replace `$module` with the name of
|
|
||||||
the module. Then you will need to go into each directory and run `./autogen.sh`,
|
|
||||||
this will, among other things, checkout the `common` module underneath each
|
|
||||||
module checkout.
|
|
||||||
|
|
||||||
You can get a list of active modules and their description from the
|
|
||||||
[modules page](http://gstreamer.freedesktop.org/modules/).
|
|
||||||
|
|
||||||
## How do I get developer access to GStreamer git?
|
|
||||||
|
|
||||||
If you want to gain developer access to the GStreamer source-code repositories,
|
|
||||||
you need to either send a request to the development lists, or directly ask one
|
|
||||||
of the maintainers. We usually only consider requests by developers who have
|
|
||||||
been active for some time and have shown to be competent GStreamer contributors.
|
|
||||||
|
|
||||||
## I ran autogen.sh, but it failed with aclocal errors. What's wrong?
|
|
||||||
|
|
||||||
```
|
|
||||||
+ running aclocal -I m4 -I common/m4 ...
|
|
||||||
aclocal: configure.ac: 8: macro `AM_DISABLE_STATIC' not found in library
|
|
||||||
aclocal: configure.ac: 17: macro `AM_PROG_LIBTOOL' not found in library
|
|
||||||
aclocal failed
|
|
||||||
```
|
|
||||||
|
|
||||||
What's wrong?
|
|
||||||
|
|
||||||
`aclocal` is unable to find two macros installed by `libtool` in a
|
|
||||||
file called `libtool.m4`. Normally, this would indicate that you don't have
|
|
||||||
`libtool`, but that would mean `autogen.sh` should have failed on not finding
|
|
||||||
`libtool`.
|
|
||||||
|
|
||||||
It is more likely that you installed `automake` (which provides `aclocal`)
|
|
||||||
and `libtool` in different prefixes. You can check this by examining in
|
|
||||||
what prefix `aclocal` and `libtool` are installed.
|
|
||||||
|
|
||||||
You can do three things to fix this :
|
|
||||||
|
|
||||||
1. install `automake` in the same prefix as `libtool`
|
|
||||||
|
|
||||||
2. force use of the `automake` installed in the same prefix as `libtool` by
|
|
||||||
using the `--with-automake` option
|
|
||||||
|
|
||||||
3. figure out what prefix `libtool` has been installed to and point
|
|
||||||
`aclocal` to the right location by running
|
|
||||||
|
|
||||||
```
|
|
||||||
export ACLOCAL_FLAGS="-I $(prefix)/share/aclocal"
|
|
||||||
```
|
|
||||||
where you need to replace `$(prefix)` with the one where `libtool` was
|
|
||||||
installed to.
|
|
||||||
|
|
||||||
## Why is "-Wall -Werror" being used?
|
|
||||||
|
|
||||||
`-Wall` is being used because it finds a lot of possible problems
|
|
||||||
with code. Not all of them are necessarily a problem, but it's better to
|
|
||||||
have the compiler report some false positives and find a work-around
|
|
||||||
than spending days chasing a bug the compiler was already hinting to.
|
|
||||||
|
|
||||||
`-Werror` is turned off for actual releases. It's turned on by default
|
|
||||||
for git and prereleases so that people actually notice and fix problems
|
|
||||||
found by `-Wall`. We want people to actively hit and report or fix them.
|
|
||||||
|
|
||||||
If for any reason you want to bypass these flags and you are certain
|
|
||||||
it's the right thing to do, you can run:
|
|
||||||
|
|
||||||
```
|
|
||||||
make ERROR_CFLAGS=""
|
|
||||||
```
|
|
||||||
|
|
||||||
to clear these error checking `CFLAGS`.
|
|
||||||
|
|
Loading…
Reference in a new issue