[Bug 773917] New: gstreamer: tools: cleanup man pages and install them when building with meson

[GStreamer (GNOME Bugzilla)]

https://bugzilla.gnome.org/show_bug.cgi?id=773917

            Bug ID: 773917
           Summary: gstreamer: tools: cleanup man pages and install them
                    when building with meson
    Classification: Platform
           Product: GStreamer
           Version: unspecified
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: Normal
         Component: documentation
          Assignee: gstreamer-bugs at lists.freedesktop.org
          Reporter: ao2 at ao2.it
        QA Contact: gstreamer-bugs at lists.freedesktop.org
     GNOME version: ---

Created attachment 339080
  --> https://bugzilla.gnome.org/attachment.cgi?id=339080&action=edit
gstreamer: tools: cleanup man pages and install them when building with meson

Hi,

I was thinking about writing a man page for ges-launch-1.0 and ended up
cleaning up the man pages in gstreamer/tools and allow to install them with
meson...

See the patches in the attachment, note that they change a bit the current
look of the man pages, namely the program names now have the API version
number always appended to them (i.e.  gst-launch-1.0, instead of just
gst-launch, etc.) I think this makes sense because that's the form the
executable and the man pages file names use.

I took a gradual approach and kept the pre-processing with sed; IMHO in the
long run the pre-processing step could be dropped, and have
@GST_API_VERSION_NUMBER@ everywhere directly in the templates.

I didn't do this for now because in meson GST_API_VERSION is a quoted string,
and configure_file() would add the double quotes around the version number, so
I introduced a GST_API_VERSION_NUMBER variable and took care of this
difference in a shell script.

Ciao ciao,
   Antonio

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
You are the assignee for the bug.