dev environment: update documentation

Add gst-dev.py usage with an external script.

gst-worktree: Add sub-commands: add and rm

`add` behaves the same as before. `rm` removes worktrees.

`git worktree remove` on the gst-build worktree will delete the
subproject worktrees inside it, but will not remove the references to
them in the main repository's subproject worktrees. The `rm` command
will.

Move checkout-branch-worktree to gst-worktree.py

We will add more actions to it than just 'checkout'. Also add
a wrapper shell script that calls gst-worktree.py with the correct
arguments.

.gitignore: Ignore subproject package cache

git-worktree: Fix indentation

git-worktree: Allow multiple worktrees for subproject branches

It's pretty common to have the same branch for a subproject in
multiple worktrees. F.ex., when you want to test a feature branch
common to a few gstreamer subprojects but not the rest.

git-worktree: Parse wrap files instead of meson introspect

meson introspect is the wrong approach since it:

* Requires a pre-existing build directory for some branch
* Gives us potentially incorrect information since it tells us
  subproject details for the current branch, not the branch we're
  checking out.
* Does not allow us to share the git repos for non-gst repos since it
  can't tell us the git branches for them.

Instead, parse the wrap files in the branch we're checking out since
they're just INI-style config files.

Add sqlite.wrap from wrapdb

This allows building libsoup support on platforms that does not have
sqlite.

python: Avoid using 'is' to compare strings

This is the wrong operator to use, which only seems to work because
`os.name` and `'nt'` happen to be the same object. Python 3.8 also
produces a `SyntaxWarning` when encountering this pattern.

gst-env: Fix the gst plugin file path regex for Linux platforms

On Linux, the library file is stored in the platform triplet directory under the
lib directory (hence for example
lib/x86_64-linux-gnu/gstreamer-1.0/libgstfoo.so) so the regex needs to take this
into account.

With this change the LD_LIBRARY_PATH on Linux now contains only the directories
with gst libs, ignoring the plugins, as initially intended in
c6613d8da2191aaf2bd7d1ddd4130a289b02e1ba.

Fixes #56

gst-env: Ensure target install filename is a list

At least in Meson 0.49, the target['install_name'] is a string, not a list, so
the heuristics declared in the is_library_target_and_not_plugin() can't apply
because Python is actually happy to iterate over a string without any warning.

meson: Specify encoding as utf-8 for msvc

Some projects does not have this option which causes verbose warnings

meson: Enable some msvc warnings

Enable following warnings
 - unused variable
 - unhandled enum value in switch/case

Those warnings might cause build error on CI pipeline, but not enabled
by default. For development environment, let's enable them to save
CI (and developer's time) resource.

Fixes: https://gitlab.freedesktop.org/gstreamer/gst-build/issues/31

instead of 'examples' use 'gst-examples' as option to build the respective subproject
we want to do this because the other "examples" in plugins (tests etc) need  a lot deps (qt5 etc)
that are not needed by gst-examples itself.

gst-env: Use locally built GStreamer utility programs

The host environment might not have gst-launch-1.0 and gst-inspect-1.0
installed.

Fixes #52

Add gst-examples in gitignore

subprojects: add wrap for libmicrodns

This library is used by the newly-merged mdns device provider
for discovering devices advertised over multicast dns.

Add subprojects/gst-docs in gitignore

gst-docs in only build on Linux if hotdoc is in the PATH.

A correct gitigonore is important for modern tools like ripgrep,
fd or skim.

Update ffmpeg to 4.1.4

Add support for wine+mingw environments

Rename 'uninstalled' to development environment

In the case of wine, the env can not be uninstalled, also developers
do not necessiraly care about the fact that it is "uninstalled", the
important thing is that it is a development environment, meaning
that they can work on GStreamer or with GStreamer in the environment.

I still keep the `uninstalled` target to avoid changing people's
habits for now.

Remove msys2_setup as it is not used, not tested, not documentated

gst-uninstalled: Don't add plugin paths to PATH or LD_LIBRARY_PATH

We don't need to do that, and adding it causes us to exceed the PATH
length limit on Windows, which makes the terminal completely unusable.

Add back gtk_doc option

This is needed to disable gtk_doc in subprojects that have that option
yielding.

Update .gitignore

Move to using GitHub binary releases

Can't update to 2.5.19 because of https://github.com/lexxmark/winflexbison/issues/48

Fixes https://gitlab.freedesktop.org/gstreamer/gst-build/issues/43

subprojects: proxy-libintl: fix push-url

Update the flexmeson windows binary version

The old binary/url is no longer available, and the layout of the
sourceforge archvie seems to have changed to include a new
old_versions/ directory where the previous binary is
relocated.

https://sourceforge.net/projects/winflexbison/files/old_versions/

While we could use that, it seem better to invest the effort to
adapt the scipt afterwards to use the github archives instead

https://github.com/lexxmark/winflexbison/releases

So for now bump the version to get the subproject building
till we switch to github releases.

uninstalled: Ensure bash prompt override even if bash script file does not exist

If automatic bash prompt override is enabled via the 'GST_BUILD_DISABLE_PS1_OVERRIDE',
We should set the bash prompt to have a visual indicator of the "gst-uninstalled" environment
even if bash script file does not exist.

add gst-examples repository to subproject list

gst-uninstalled: Fix loading of prefix libraries on Fedora 30

On Fedora 64-bit, libdir is 'lib64'. Just add it unconditionally
everywhere because we have no reliable way of detecting which distros
or OSes will use that.

Don't allow people to run meson inside the uninstalled env

People should not run `meson` on gst-build inside the uninstalled env.
It will cause problems because meson will detect the already-built
libraries and pkg-config files.

This is not obvious to people, and they often make this mistake.

uninstalled: Fix --sysroot implementation

This option was added so we could remove the sysroot path from the env
when cross-build is used over NFS. Though, the implementation wasn't complete
and went unnoticed.

This moves the sysroot path removal into the helper that prepends env so
that no more env get forgotten. This notably fixes the PATH environment.

cross: Fix cross compilation meson error

The doc is not currently built in cross-compilation, but we still had
some meson code that eneded up being called and failed.

meson: Bump minimal GLib version to 2.44

This means we can use some newer features and get rid of some
boilerplate code using the G_DECLARE_* macros.

As discussed on IRC, 2.44 is old enough by now to start depending on it.

uninstalled: update XDG_DATA_DIRS to point to our devhelp index

When using hotdoc, one can build the documentation for a single
subproject (eg. the GL plugins). In that case, hotdoc will look
up links in devhelp indexes available in standard locations.

To make sure this case works, we thus need to add the path to
our devhelp index to XDG_DATA_DIRS. This also means when running
devhelp from inside the environment, the devhelp books produced
by hotdoc will now show up.

meson: fix GstPluginsPath.json generation

The refactored code was only adding paths to plugins in projects
that build hotdoc, which is not the case of gst-python for example

uninstalled: Add libnice plugin to GST_PLUGIN_PATH

meson: Add a target to regenerate doc caches for all subprojects

Fixes https://gitlab.freedesktop.org/gstreamer/gst-docs/issues/36

Avoid making a dependency between plugins and the build.ninja file

Basically meson detects that we pass file paths to run_command to regenerate the build.ninja file when those change

meson.build: Fix typo in log message

meson: Remove spurious subdir_done

git-update: Make sure to download all subproject before applying manifest

Otherwise we might be missing some subprojects update

scripts: Add a script to check that all repos are clean

This is useful to check that a build didn't result in changes in the
code/generated files

This will be used to check that the plugins documentation cache file is
properly commited, and that necessary workaround for particular case
are adopted.

Generate the GST_PLUGIN_PATH using the `plugins` variable in subprojects

To build the documentation, we are maintaining a 'standardise' `plugins`
variable accross all modules to list all plugins and generate
documentation for them.

This is also used to get the right plugin path when inspecting plugins
for the documentation.

Build documentation with hotdoc

gst-uninstalled: Add gst-indent directory to $PATH

uninstalled: Add an option to strip off the sysroot path

As the data from meson is no longer relative path, it is not longer
possible to move gst-build around and run gst-uninstalled.py. This broke
cross-compilation usage, where you build on a host and run over NFS on
target. This adds an option to tell the script to strip off the host path
to the sysroot.

Fix link to meson "subprojects" documentation

README: minor clarification

Fixes #30.

subprojects: Add a wrap for gst-docs

Preparing for building API documentation with hotdoc

Build master again

Build 1.16.0 release

README: Add instructions for Windows with screenshots

Also add a note about installation

Move cross-files to the data subdirectory

We will add more data soon.

gitignore: Also ignore subproject symlinks

These subproject dirs are only ignored if they are directories if you
use a trailing slash.

Build master again

Build 1.15.90 release

subprojects: libsoup: pin to latest release

subprojects: orc: pin to 0.4.29 release

gitignore: Add top-level libnice symlink

Missed adjustment from commit d3029ec0d606016.

ffmpeg.wrap: Bump to 4.1.3

Tested on Windows.

gst-uninstalled: Try to use short names for env vars on Windows

Try even harder to not hit the maximum length limit for env var values
on Windows. Reduces the size by ~1000 characters on my machine.

gst-uninstalled: De-dedup before prepending to an env var

Helps us avoid breaching the maximum length limit for env var values
on Windows.

glib.wrap: Use the glib-2-60 stable branch instead of master

This fixes https://gitlab.freedesktop.org/gstreamer/gst-build/issues/21

add libnice as a top-level subproject.

When relying on a system-wide libnice, we end up not building
the nice elements, which means we can't use them, and by extension
webrtcbin, in the uninstalled environment.

This also introduces a way to avoid checking the version of
a given subproject, and makes use of it for libnice and pygobject,
which only passed the version check by chance, as its current
major version is 3.

README.md: Document how to build the qt5 plugin

gst-uninstalled: Add qt5 DLLs to PATH on Windows

This is needed for using the qmlgl out of the box inside
gst-uninstalled. Of course this won't work if the user is using
a native file to specify the path to `qmake`.

meson: Add a subproject wrap file for x264

This allows building x264enc from -ugly on all platforms.

uninstalled: Add support PowerShell on Windows

... depending on detected shell program. For instance,
if the nearest ancestor process is PowerShell, run uninstalled
environment via PowerShell. Otherwise, $COMSPEC (most likely cmd.exe)
will be used.

README: small updates

Add FFmpeg.wrap and update .gitignore

Tested on Linux and Windows (MSVC)

gst-uninstalled: make the bash prompt override optional

When using a custom prompt the automatic override may not look good, so
provide a mechanism to disable it.

Document that the user will have to use GST_ENV manually when setting
the prompt to have a visual indicator of the gst-uninstalled
environment.

Add gst-integration-testsuites as a subproject

Back to development

Build 1.15.2 release

meson: use new 'python' module instead of deprecated 'python3' one

https://github.com/mesonbuild/meson/pull/4169

Configure subprojects in the right order

Use an array instead of a dict to make sure we iterate over
the list of subprojects in the right order, which is first
GStreamer core, then gst-plugins-base, then other things.

Without this subprojects might get configured in random order,
in which case gstreamer or gst-plugins-base libs might get picked
up via pkg-config if they are also available installed, instead of
being picked up from the subproject. This breaks all kinds of
assumptions in gst-build and will likely have strange effects
and/or lead to build failures such as

subprojects/gst-plugins-good/tests/check/meson.build:144:2:
ERROR: 'gstreamer-plugins-base-1.0' is not a pkgconfig dependency

gst-uninstalled: Fix compatibility with meson 0.50

Starting with Meson 0.50, meson instrospect --targets uses a list
for the filename and install_filenames of each target. Handle both
lists and strings.

Add subprojects/libsoup/ to .gitignore

openh264.wrap: Update the upstream commit

Needed for building on Windows with MSVC.

New subproject win-nasm to provide nasm on Windows

This is needed for building openh264 as a subproject. Currently it's
downloaded unconditionally since the download is very small.

Add orc to gitignore

scripts: Auto-detect whether we can enable colors

Also do the setup necessary on Windows to enable ANSI colours on the
console (if available). That code is copied from Meson and is Apache2
licensed.

Add an orc wrap file for using orc subproject

Depending on the newly added 'orc' meson option, this make possible
to use orc subproject on gst-build.

subprojects: use libffi and gl-headers from gstreamer gitlab repos

https://gitlab.freedesktop.org/gstreamer/gstreamer-project/issues/28

Configure gst-rtsp-server before gst-devtools

Since gst-devtools checks for gst-rtsp-server and will
happily pick up an external dep which isn't what we want
if we configure it as subproject afterwards.

This assumes meson dicts are always stable, which may
not necessarily be the case, but it seems to work in
practice for now.

See #16

windows: unconditionally use flex / bison binaries

This to simplify the checks made when for example a flex binary
is available system wide: the build process was failing when
that system wide binary didn't have the required version. Instead
of adding more checks and making things more complex, let's just
always use our binary subproject.

Add wrap file for libsoup and libpsl

libpsl is a dependency if libsoup that has an upstream Meson build
system (in master only).

libsoup also needs libxml2 but we already have a wrap file for it.

The only remaining dependency that must come from the system is sqlite3.

gst-uninstalled: define GST_OMX_CONFIG_DIR

GST_OMX_CONFIG_DIR is used by gst-omx to load the gstomx.conf associated
with the selected OMX target.

gitignore: Add cscope files

Ignores top-level cscope files that might be used for a cross-project
cscope index.

gitignore: Add top-level pygobject symlink

subprojects: use upstream libnice

Meson port is upstream now.

subprojects: update libxml2 wrap to revision 5

Fixes build with MSVC.

Add example cross files

These are example cross files that will be used by the CI. They
could require manual editing to change hardcoded paths to toolchains
when used on different environment.

update: Re add support for manifests without a refname

update: Fetch the refname before checking out the specified sha

Working around freedesktop/freedesktop#95

Add 'nls' common option

Download libxml from http and not ftp

Add a libxml2 wrap to be used by GES