diff --git a/README.md b/README.md index f55555a0c4..4130d25ee5 100644 --- a/README.md +++ b/README.md @@ -423,13 +423,13 @@ git clone https://github.com/mesonbuild/meson.git ``` BUILDDIR=$PWD/winebuild/ export WINEPREFIX=$BUILDDIR/wine-prefix/ && mkdir -p $WINEPREFIX -# Setting the prefix is mandatory as it is used to setup symlinks during uninstalled development +# Setting the prefix is mandatory as it is used to setup symlinks within the development environment meson/meson.py $BUILDDIR --cross-file meson/cross/linux-mingw-w64-64bit.txt -Dgst-plugins-bad:vulkan=disabled -Dorc:gtk_doc=disabled --prefix=$BUILDDIR/wininstall/ -Djson-glib:gtk_doc=disabled meson/meson.py install -C $BUILDDIR/ ``` > __NOTE__: You should use `meson install -C $BUILDDIR` each time you make a change -> instead of the usual `ninja -C build` as the environment is not uninstalled. +> instead of the usual `ninja -C build` as this is not in the development environment. #### The development environment diff --git a/gst-uninstalled.py b/gst-uninstalled.py deleted file mode 120000 index 2025ace645..0000000000 --- a/gst-uninstalled.py +++ /dev/null @@ -1 +0,0 @@ -gst-env.py \ No newline at end of file diff --git a/meson.build b/meson.build index e5cf0e0c3b..525c7cf6d9 100644 --- a/meson.build +++ b/meson.build @@ -16,17 +16,17 @@ fs = import('fs') gnome = import('gnome') pkgconfig = import('pkgconfig') python3 = import('python').find_installation() -# Ensure that we're not being run from inside the gst-uninstalled env +# Ensure that we're not being run from inside the development environment # because that will confuse meson, and it might find the already-built # gstreamer. It's fine if people run `ninja` as long as it doesn't run # reconfigure because ninja doesn't care about the env. -ensure_not_uninstalled = ''' +ensure_not_devenv = ''' import os assert('GST_ENV' not in os.environ) ''' -cmdres = run_command(python3, '-c', ensure_not_uninstalled, check: false) +cmdres = run_command(python3, '-c', ensure_not_devenv, check: false) if cmdres.returncode() != 0 - error('Do not run `ninja` or `meson` for gst-build inside the uninstalled environment, you will run into problems') + error('Do not run `ninja` or `meson` for gst-build inside the development environment, you will run into problems') endif # Install gst-indent pre-commit hook @@ -395,7 +395,6 @@ if meson.can_run_host_binaries() and build_machine.system() == 'linux' and host_ endif endif -run_target('uninstalled', command : devenv_cmd) run_target('devenv', command : devenv_cmd) if orc_subproject.found() and orc_update_targets.length() > 0 diff --git a/subprojects/gst-devtools/debug-viewer/GstDebugViewer/Common/Main.py b/subprojects/gst-devtools/debug-viewer/GstDebugViewer/Common/Main.py index 3d6c6f780a..e7f8552ce8 100644 --- a/subprojects/gst-devtools/debug-viewer/GstDebugViewer/Common/Main.py +++ b/subprojects/gst-devtools/debug-viewer/GstDebugViewer/Common/Main.py @@ -238,9 +238,9 @@ class PathsBase (object): pass @classmethod - def setup_uninstalled(cls, source_dir): - """Set up paths for running 'uninstalled' (i.e. directly from the - source dist).""" + def setup_devenv(cls, source_dir): + """Set up paths for running the development environment + (i.e. directly from the source dist).""" pass @@ -251,7 +251,7 @@ class PathsBase (object): if cls.data_dir is None: source_dir = os.path.dirname( os.path.dirname(os.path.abspath(__file__))) - cls.setup_uninstalled(source_dir) + cls.setup_devenv(source_dir) def __new__(cls): @@ -275,9 +275,9 @@ class PathsProgramBase (PathsBase): cls.locale_dir = os.path.join(data_prefix, "locale") @classmethod - def setup_uninstalled(cls, source_dir): - """Set up paths for running 'uninstalled' (i.e. directly from the - source dist).""" + def setup_devenv(cls, source_dir): + """Set up paths for running the development environment + (i.e. directly from the source dist).""" # This is essential: The GUI module needs to find the .glade file. cls.data_dir = os.path.join(source_dir, "data") diff --git a/subprojects/gst-devtools/debug-viewer/gst-debug-viewer b/subprojects/gst-devtools/debug-viewer/gst-debug-viewer index 7bf451e2b8..e4e0197304 100755 --- a/subprojects/gst-devtools/debug-viewer/gst-debug-viewer +++ b/subprojects/gst-devtools/debug-viewer/gst-debug-viewer @@ -41,7 +41,8 @@ def main(): if data_dir: installed = True else: - # Substitution has not been run, we are running uninstalled: + # Substitution has not been run, we are running within a development + # environment: lib_dir = os.path.dirname(os.path.realpath(sys.argv[0])) installed = False @@ -61,7 +62,7 @@ def main(): else: # Assume that we reside inside the source dist. source_dir = os.path.dirname(os.path.realpath(sys.argv[0])) - GstDebugViewer.Paths.setup_uninstalled(source_dir) + GstDebugViewer.Paths.setup_devenv(source_dir) GstDebugViewer.run() diff --git a/subprojects/gst-devtools/validate/gst/validate/gst-validate-scenario.c b/subprojects/gst-devtools/validate/gst/validate/gst-validate-scenario.c index 3742057fda..896d5c3989 100644 --- a/subprojects/gst-devtools/validate/gst/validate/gst-validate-scenario.c +++ b/subprojects/gst-devtools/validate/gst/validate/gst-validate-scenario.c @@ -5305,7 +5305,7 @@ gst_validate_list_scenarios (gchar ** scenarios, gint num_scenarios, } } - /* Hack to make it work uninstalled */ + /* Hack to make it work within the development environment */ dir = g_file_new_for_path ("data/scenarios"); _list_scenarios_in_dir (dir, kf); g_object_unref (dir); diff --git a/subprojects/gst-docs/markdown/application-development/basics/helloworld.md b/subprojects/gst-docs/markdown/application-development/basics/helloworld.md index 7997cc30b5..9174173c10 100644 --- a/subprojects/gst-docs/markdown/application-development/basics/helloworld.md +++ b/subprojects/gst-docs/markdown/application-development/basics/helloworld.md @@ -225,8 +225,8 @@ GStreamer from source yourself instead of using pre-built packages), make sure the `PKG_CONFIG_PATH` environment variable is set to the correct location (`$libdir/pkgconfig`). -In the unlikely case that you are using an uninstalled GStreamer setup -(ie. gst-uninstalled), you will need to use libtool to build the hello +In the unlikely case that you are using the GStreamer development environment +(ie. gst-env), you will need to use libtool to build the hello world program, like this: ``` diff --git a/subprojects/gst-docs/markdown/frequently-asked-questions/developing.md b/subprojects/gst-docs/markdown/frequently-asked-questions/developing.md index bd2fae6a51..666fdcb015 100644 --- a/subprojects/gst-docs/markdown/frequently-asked-questions/developing.md +++ b/subprojects/gst-docs/markdown/frequently-asked-questions/developing.md @@ -33,12 +33,12 @@ For bigger projects, you should integrate `pkg-config` use in your Makefile, or with autoconf using the pkg.m4 macro (providing `PKG_CONFIG_CHECK`). -## How do I develop against an uninstalled GStreamer copy? +## How do I develop against a GStreamer copy within a development environment? -It is possible to develop and compile against an uninstalled copy of GStreamer -and its plugins, for example, against git checkouts. This enables you to test -the latest version of GStreamer without interfering with your system-wide -installation. See the [Building from source using +It is possible to develop and compile against a copy of GStreamer and its +plugins within a development environment, for example, against git checkouts. +This enables you to test the latest version of GStreamer without interfering +with your system-wide installation. See the [Building from source using meson](installing/building-from-source-using-meson.md) documentation. @@ -54,10 +54,9 @@ If what you want is automatic audio/video sinks, consider using the ## How do I debug these funny shell scripts that libtool makes? -When you link a program against uninstalled GStreamer using -libtool, funny shell scripts are made to modify your shared object -search path and then run your program. For instance, to debug -`gst-launch`, try: +When you link a program against a GStreamer within a development environment +using libtool, funny shell scripts are made to modify your shared object search +path and then run your program. For instance, to debug `gst-launch`, try: ``` libtool --mode=execute gdb /path/to/gst-launch diff --git a/subprojects/gst-docs/markdown/frequently-asked-questions/mono-repository.md b/subprojects/gst-docs/markdown/frequently-asked-questions/mono-repository.md index 4ee9120248..a3d55e2650 100644 --- a/subprojects/gst-docs/markdown/frequently-asked-questions/mono-repository.md +++ b/subprojects/gst-docs/markdown/frequently-asked-questions/mono-repository.md @@ -4,7 +4,7 @@ The GStreamer multimedia framework is a set of libraries and plugins split into a number of distinct modules which are released independently and which have so far been developed in separate git repositories in [freedesktop.org GitLab](https://gitlab.freedesktop.org/gstreamer/). -In addition to these separate git repositories there was a `gst-build` meta-repository that would use the Meson build systems's subproject feature to download each individual module and then build everything in one go. It would also provide an uninstalled development environment that made it easy to work on GStreamer and use or test versions other than the system-installed GStreamer version. +In addition to these separate git repositories there was a `gst-build` meta-repository that would use the Meson build systems's subproject feature to download each individual module and then build everything in one go. It would also provide a development environment that made it easy to work on GStreamer and use or test versions other than the system-installed GStreamer version. All of these modules have now (as of 28 September 2021) been merged into a single git repository ("Mono repository" or "monorepo") which should simplify development workflows and continuous integration, especially where changes need to be made to multiple modules at once. diff --git a/subprojects/gst-docs/markdown/installing/building-from-source-using-meson.md b/subprojects/gst-docs/markdown/installing/building-from-source-using-meson.md index 9bc3928135..d9a785b951 100644 --- a/subprojects/gst-docs/markdown/installing/building-from-source-using-meson.md +++ b/subprojects/gst-docs/markdown/installing/building-from-source-using-meson.md @@ -132,7 +132,7 @@ figure out on its own that `meson` needs to be re-run and will do that automatically. -## Entering the "uninstalled" environment +## Entering the development environment GStreamer is made of several tools, plugins and components. In order to make it easier for development and testing, there is a target (provided by `gst-build` diff --git a/subprojects/gst-plugins-bad/ext/wpe/WPEThreadedView.cpp b/subprojects/gst-plugins-bad/ext/wpe/WPEThreadedView.cpp index d3fefc0200..b85039c3bb 100644 --- a/subprojects/gst-plugins-bad/ext/wpe/WPEThreadedView.cpp +++ b/subprojects/gst-plugins-bad/ext/wpe/WPEThreadedView.cpp @@ -183,7 +183,7 @@ gpointer WPEContextThread::s_viewThread(gpointer data) static void initialize_web_extensions (WebKitWebContext *context) { - const gchar *local_path = gst_wpe_get_uninstalled_extension_path (); + const gchar *local_path = gst_wpe_get_devenv_extension_path (); const gchar *path = g_file_test (local_path, G_FILE_TEST_IS_DIR) ? local_path : G_STRINGIFY (WPE_EXTENSION_INSTALL_DIR); GST_INFO ("Loading WebExtension from %s", path); webkit_web_context_set_web_extensions_directory (context, path); diff --git a/subprojects/gst-plugins-bad/ext/wpe/gstwpe.cpp b/subprojects/gst-plugins-bad/ext/wpe/gstwpe.cpp index 1872811813..9bffacab69 100644 --- a/subprojects/gst-plugins-bad/ext/wpe/gstwpe.cpp +++ b/subprojects/gst-plugins-bad/ext/wpe/gstwpe.cpp @@ -33,7 +33,7 @@ GST_DEBUG_CATEGORY (wpe_video_src_debug); GST_DEBUG_CATEGORY (wpe_view_debug); GST_DEBUG_CATEGORY (wpe_src_debug); -const gchar *gst_wpe_get_uninstalled_extension_path (void) +const gchar *gst_wpe_get_devenv_extension_path (void) { return extension_path; } diff --git a/subprojects/gst-plugins-bad/ext/wpe/gstwpe.h b/subprojects/gst-plugins-bad/ext/wpe/gstwpe.h index 6d628da730..a997e7272e 100644 --- a/subprojects/gst-plugins-bad/ext/wpe/gstwpe.h +++ b/subprojects/gst-plugins-bad/ext/wpe/gstwpe.h @@ -21,4 +21,4 @@ #include -const gchar *gst_wpe_get_uninstalled_extension_path (void); +const gchar *gst_wpe_get_devenv_extension_path (void); diff --git a/subprojects/gst-plugins-base/gst-libs/gst/tag/licenses.c b/subprojects/gst-plugins-base/gst-libs/gst/tag/licenses.c index 708b885f1b..ecb39eaeae 100644 --- a/subprojects/gst-plugins-base/gst-libs/gst/tag/licenses.c +++ b/subprojects/gst-plugins-base/gst-libs/gst/tag/licenses.c @@ -87,7 +87,7 @@ gst_tag_get_license_translations_dictionary (void) gchar *data; gsize len; - /* for gst-uninstalled */ + /* for gst-env */ dict_path = g_getenv ("GST_TAG_LICENSE_TRANSLATIONS_DICT"); if (dict_path == NULL) diff --git a/subprojects/gstreamer/docs/gst/running.md b/subprojects/gstreamer/docs/gst/running.md index 42a9266ade..65f5e6fd24 100644 --- a/subprojects/gstreamer/docs/gst/running.md +++ b/subprojects/gstreamer/docs/gst/running.md @@ -38,8 +38,8 @@ the non-versioned one if it is set. Setting this variable to an empty string will cause GStreamer not to scan any system paths at all for plug-ins. This can be useful if you're -running uninstalled (for development purposes) or while running -testsuites. +running a development environment (for development purposes) or while +running testsuites. **`GST_PLUGIN_PATH`, `GST_PLUGIN_PATH_1_0`.** diff --git a/subprojects/gstreamer/docs/index.md b/subprojects/gstreamer/docs/index.md index 8240c79029..4237705e66 100644 --- a/subprojects/gstreamer/docs/index.md +++ b/subprojects/gstreamer/docs/index.md @@ -94,7 +94,7 @@ the non-versioned one if it is set. Setting this variable to an empty string will cause GStreamer not to scan any system paths at all for plug-ins. This can be useful if you're -running uninstalled (for development purposes) or while running +running a development environment (for development purposes) or while running testsuites. **GST_PLUGIN_PATH, GST_PLUGIN_PATH_1_0.** diff --git a/subprojects/gstreamer/gst/gstregistry.c b/subprojects/gstreamer/gst/gstregistry.c index 66e996f32a..2ae339f60e 100644 --- a/subprojects/gstreamer/gst/gstregistry.c +++ b/subprojects/gstreamer/gst/gstregistry.c @@ -1189,7 +1189,7 @@ gst_registry_scan_plugin_file (GstRegistryScanContext * context, /* Load plugin the old fashioned way... */ /* We don't use a GError here because a failure to load some shared - * objects as plugins is normal (particularly in the uninstalled case) + * objects as plugins is normal (particularly in the development environment case) */ newplugin = _priv_gst_plugin_load_file_for_registry (filename, context->registry, NULL); @@ -1229,7 +1229,7 @@ is_blacklisted_directory (const gchar * dirent) return TRUE; /* can also skip .git and .deps dirs, those won't contain useful files. - * This speeds up scanning a bit in uninstalled setups. */ + * This speeds up scanning a bit in development environment setups. */ if (strcmp (dirent, ".git") == 0 || strcmp (dirent, ".deps") == 0) return TRUE;