mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-11-19 00:01:23 +00:00
Code Issues 1 Projects Releases Wiki Activity

faq: drop spaces before question marks

Browse source
This commit is contained in:
Reynaldo H. Verdejo Pinochet 2017-06-02 15:34:40 -07:00
parent 7b457867d1
commit 1afd513338
7 changed files with 39 additions and 39 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
markdown/frequently-asked-questions/dependencies.md
View file

@ -1,6 +1,6 @@
# Dependencies
## Why are there so many dependencies ?
## Why are there so many dependencies?
Making a full-featured media framework is a huge undertaking in
itself. By using the work done by others, we both reduce the amount of
@ -15,7 +15,7 @@ liborc, and very common stuff like glibc, a C compiler, and so on. All
other dependencies are optional.
In closing, let's rephrase the question to “Why are you giving me so
many choices and such a rich environment ?”
many choices and such a rich environment?”
## Is GStreamer X11 independent? Can it be used headless?
@ -36,7 +36,7 @@ available as GStreamer elements.
[ladspa]: https://en.wikipedia.org/wiki/LADSPA
[lv2]: http://lv2plug.in/
## Does GStreamer support MIDI ?
## Does GStreamer support MIDI?
There is some rudimentary MIDI support in GStreamer, but it's not complete yet.
@ -54,7 +54,7 @@ MIDI playback is provided by plugins such as `midiparse`, `fluiddec`,
[alsamidisrc]: https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-plugins/html/gst-plugins-base-plugins-alsamidisrc.html
## Does GStreamer depend on GNOME or GTK+ ?
## Does GStreamer depend on GNOME or GTK+?
No, it's just that many of the applications developed for GStreamer happen to
be GNOME or GTK+ applications, including some of our sample applications. There

12
markdown/frequently-asked-questions/developing.md
View file

@ -1,6 +1,6 @@
# Developing applications with GStreamer
## How do I compile programs that use GStreamer ?
## How do I compile programs that use GStreamer?
<!-- FIXME: update for windows, macOS, and meson build, get rid of libtool things -->
@ -33,7 +33,7 @@ For bigger projects, you should integrate pkg-config use in your
Makefile, or integrate 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 an uninstalled GStreamer copy?
It is possible to develop and compile against an uninstalled copy
of gstreamer and gst-plugins-\* (for example, against git checkouts).
@ -71,7 +71,7 @@ environment is used.
[gst-uninstalled]: http://cgit.freedesktop.org/gstreamer/gstreamer/tree/scripts/gst-uninstalled
[create-uninstalled]: http://cgit.freedesktop.org/gstreamer/gstreamer/tree/scripts/create-uninstalled-setup.sh
## How can I use GConf to get the system-wide defaults ?
## How can I use GConf to get the system-wide defaults?
For GNOME applications it's a good idea to use GConf to find the
default ways of outputting audio and video. You can do this by using the
@ -80,7 +80,7 @@ output. They will take care of everything GConf-related for you and
automatically use the outputs that the user configured. If you are using
gconfaudiosink, your application should set the 'profile' property.
## How do I debug these funny shell scripts that libtool makes ?
## 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
@ -99,7 +99,7 @@ be used and this is not a problem. You can run `gdb`, `valgrind` or any
debugging tools directly on the binaries Meson creates in the build
directory.
## Why is mail traffic so low on gstreamer-devel ?
## Why is mail traffic so low on gstreamer-devel?
Our main arena for coordination and discussion are IRC and bugzilla, not
mailing lists. Join us in [`#gstreamer`][irc-gstreamer] on irc.freenode.net.
@ -110,7 +110,7 @@ mailing list is never a bad idea, however.
[irc-gstreamer]: irc://irc.freenode.net/#gstreamer
[webchat-gstreamer]: https://webchat.freenode.net
## What kind of versioning scheme does GStreamer use ?
## What kind of versioning scheme does GStreamer use?
For public releases, GStreamer uses a standard MAJOR.MINOR.MICRO
version scheme. If the release consists of mostly bug fixes or

10
markdown/frequently-asked-questions/general.md
View file

@ -1,6 +1,6 @@
# General
## Is GStreamer a media player ?
## Is GStreamer a media player?
No, GStreamer is a development framework for creating applications like
media players, video editors, streaming media broadcasters and so on.
@ -8,7 +8,7 @@ That said, very good media players can easily be built on top of GStreamer
especially when using the high-level APIs we provide such as `GstPlayer` or
the `playbin` and `playbin3` elements.
## Why is GStreamer written in C ? Why not C++/Objective-C/... ?
## Why is GStreamer written in C? Why not C++/Objective-C/...?
We like C. Aside from "personal preference", there are a number
of technical reasons why C is nice in this project:
@ -96,7 +96,7 @@ You can see the effective license of a plugin as license field in
`gst-inspect-1.0`. In the future we might have the application enforce a
stricter policy (much like tainting in the kernel).
## Is GStreamer a sound server ?
## Is GStreamer a sound server?
No, GStreamer is not a sound server. GStreamer does, however, have
plugins supporting most of the major sound servers available today,
@ -110,7 +110,7 @@ Linux, Android, iOS, macOS, Windows, and *BSD, and there are official
SDK binary packages for Android, iOS, macOS and Windows made available
with every GStreamer release.
## What is GStreamer's relationship with the GNOME community ?
## What is GStreamer's relationship with the GNOME community?
GStreamer is an independent project, but we do traditionally have
a close relationship with the GNOME community. Many of our hackers
@ -119,7 +119,7 @@ is officially bundled with the GNOME desktop, as lots of GNOME applications
are using it. This does not exclude use of GStreamer by other communities
at all, of course.
## What is GStreamer's relationship with the KDE community ?
## What is GStreamer's relationship with the KDE community?
The GStreamer community wants to have as good a relationship as
possible with KDE, and we hope that someday KDE decides to adopt

12
markdown/frequently-asked-questions/getting.md
View file

@ -1,6 +1,6 @@
# Getting GStreamer
## How do I get GStreamer ?
## How do I get GStreamer?
Generally speaking, you have three options, ranging from easy to hard :
@ -48,7 +48,7 @@ unstable developer releases that should generally not be used.
You should download GStreamer 1.x. GStreamer-0.10 is no longer maintained.
## How can I install GStreamer from source ?
## How can I install GStreamer from source?
We provide tarballs of our releases on our own site, at
<http://gstreamer.freedesktop.org/src/>
@ -78,7 +78,7 @@ into one prefix with distro packages in another prefix can cause problems if
it's not done right, and it is very difficult for anyone to provide help with
such a setup.
## Are there premade binaries available ?
## Are there premade binaries available?
Yes, we currently provide [precompiled packages for Windows, OS/X,
Android and iOS](http://gstreamer.freedesktop.org/pkg/).
@ -87,7 +87,7 @@ We currently do not provide packages for Linux distributions, but rather
rely on the distributions for that. GStreamer packages should be
available for all major (and minor) distributions.
## Why don't you provide premade binaries for distribution XY ?
## Why don't you provide premade binaries for distribution XY?
GStreamer is run on a volunteer basis. The packages that are
provided are made by non-paid people who do this on their own time. The
@ -97,7 +97,7 @@ interested in maintaining GStreamer binaries for other distributions or
Unices we would be happy to hear from you. Contact us through the
GStreamer-devel mailing list.
## I am having trouble compiling GStreamer on my LFS installation, why ?
## I am having trouble compiling GStreamer on my LFS installation, why?
If you are running LFS our basic opinion is that you should be
knowledgeable enough to solve any build issues you get on your own.
@ -108,7 +108,7 @@ to be able to help you. That said, if you come to the \#gstreamer
channel on irc.openprojects.net we might of course be able to give you
some general hints and pointers.
## How do I get GStreamer through git ?
## How do I get GStreamer through git?
See this page : <http://gstreamer.freedesktop.org/dev/> for git
access (anonymous and developer).

18
markdown/frequently-asked-questions/legal.md
View file

@ -17,8 +17,8 @@ verified by FSF lawyer and law professor Eben Moglen.
> - MyPlayer, a GPL playback application
> - The binary-only Sorenson decoder
>
> together in one distribution/operating system ? If not, what needs to be
> changed to make this possible ?
> together in one distribution/operating system? If not, what needs to be
> changed to make this possible?
This would be a problem, because the GStreamer and MyPlayer
licenses would forbid it. In order to link GStreamer to MyPlayer, you
@ -38,14 +38,14 @@ writing.
>
> .. to decode Sorenson video, which will be shipped stand-alone,
> not part of a package like in the question above. Can Apple distribute
> this binary-only plugin ?
> this binary-only plugin?
Yes, modulo certain reverse engineering requirements in section 6
of the LGPL.
> If a program released under the GPL uses a library that is LGPL, and
> this library can dlopen plug-ins at runtime, what are the requirements
> for the license of the plug-in ?
> for the license of the plug-in?
You may not distribute the plug-in with the GPL application.
Distributing the plug-in alone, with the knowledge that it will be used
@ -55,13 +55,13 @@ it would be absolutely forbidden.
> Can someone in a country that does not have software patents
> distribute code covered by US patents under the GPL to people in, for
> example, Norway ? If he/she visits the US, can he/she be arrested ?
> example, Norway? If he/she visits the US, can he/she be arrested?
Yes, he can. No, there are no criminal penalties for patent
infringement in the US.
> Can someone from the US distribute software covered by US patents
> under the GPL to people in Norway ? To people in the US ?
> under the GPL to people in Norway? To people in the US?
This might infringe some patents, but the GPL would not forbid it
absent some actual restriction, such as a court judgement or agreement.
@ -71,7 +71,7 @@ infringing devices, including software.
> There are a lot of GPL- or LGPL-licensed libraries that handle media
> codecs which have patents. Take mad, an mp3 decoding library, as an
> example. It is licensed under the GPL. In countries where patents are
> valid, does this invalidate the GPL license for this project ?
> valid, does this invalidate the GPL license for this project?
The mere existence of a patent which might read on the program
does not change anything. However, if a court judgement or other
@ -85,7 +85,7 @@ distribute the Library at all.”
> So let's say there is a court judgement. Does this mean that the GPL
> license is invalid for the project everywhere, or only in the
> countries where it conflicts with the applicable patents ?
> countries where it conflicts with the applicable patents?
The GPL operates on a per-action, not per-program basis. That is,
if you are in a country which has software patents, and a court tells
@ -101,7 +101,7 @@ No.
> Is it correct that you cannot distribute the GPL mad library to decode
> mp3's, *even* in the case where you have obtained a valid license for
> decoding mp3 ?
> decoding mp3?
The only GPL-compatible patent licenses are those which are open
to all parties posessing copies of GPL software which practices the

4
markdown/frequently-asked-questions/troubleshooting.md
View file

@ -1,6 +1,6 @@
# Troubleshooting GStreamer
> Some application is telling me that I am missing a plug-in. What do I do ?
> Some application is telling me that I am missing a plug-in. What do I do?
Well, start by checking if you really are missing the plug-in.
@ -41,7 +41,7 @@ if your application does not support installation of missing plugins.
why it doesn't get built if you're sure you have the library needed
installed in a sane place.
> The GStreamer application I used stops with a segmentation fault. What can I do ?
> The GStreamer application I used stops with a segmentation fault. What can I do?
The first point of contact for any problems with a GStreamer application
should be the developers of that application. They will be able to investigate

14
markdown/frequently-asked-questions/using.md
View file

@ -1,6 +1,6 @@
# Using GStreamer
## Ok, I've installed GStreamer. What can I do next ?
## Ok, I've installed GStreamer. What can I do next?
First of all, verify that you have a working installation and that
you can inspect plugins by typing
@ -42,7 +42,7 @@ If `autovideosink` doesn't work, try an element that's specific for your
operating system and windowing system, such as `ximagesink` or `glimagesink`
or (on windows) `d3dvideosink`.
## Can my system play sound through GStreamer ?
## Can my system play sound through GStreamer?
You can test this by trying to play a sine tone. For this, you
need to link the audiotestsrc element to an output element that matches
@ -75,7 +75,7 @@ and see if you hear something. Make sure your volume is turned up, but
also make sure it is not too loud and you are not wearing your
headphones.
## How can I see what GStreamer plugins I have on my system ?
## How can I see what GStreamer plugins I have on my system?
To do this you use the gst-inspect command-line tool, which comes
standard with GStreamer. Invoked without any arguments,
@ -89,7 +89,7 @@ particular plugin, pass its name on the command line. For example,
will give you information about the volume plugin.
## Where should I report bugs ?
## Where should I report bugs?
Bugs are tracked in GNOME's Bugzilla at <http://bugzilla.gnome.org>, under
the product GStreamer. Using bugzilla you can view past bug history, report
@ -97,13 +97,13 @@ new bugs, submit patches etc. Bugzilla requires you to create an account there,
which might seem cumbersome, but allows us to at least have a chance at
contacting you for further information, as we will often have to do.
## How should I report bugs ?
## How should I report bugs?
When doing a bug report, you should at least describe
- your distribution, distribution version and GStreamer version
- how you installed GStreamer (from git, source, packages, which ?)
- how you installed GStreamer (from git, source, packages, which?)
- if you installed GStreamer before
@ -111,7 +111,7 @@ If the application you are having problems with is segfaulting, then
provide us with the necessary gdb output. See
[???](#troubleshooting-segfault)
## How do I use the GStreamer command line interface ?
## How do I use the GStreamer command line interface?
You access the GStreamer command line interface using the command
`gst-launch-1.0`. To play a file you could just use