[blfs-book] r21627 - in trunk/BOOK: . introduction/welcome multimedia/libdriv xincludes

renodr at higgs.linuxfromscratch.org renodr at higgs.linuxfromscratch.org
Sun May 26 13:07:26 PDT 2019


Author: renodr
Date: Sun May 26 13:07:26 2019
New Revision: 21627

Log:
Minor tweaks to the gstreamer section:

gst-plugins-good: Remove the libtool caution, we're using meson/ninja now so it no longer applies
gst-plugins-*: Convert the 'dependency for a given plugin needs to be installed first' into an XInclude
gst-*: With the move to Meson, the developers put in a sanity check to ensure that there is an ObjC compiler on the system. This was originally intended for macOS, and the build continues normally without it. I've added an XInclude containing a note to all pages affected to document this, since it describes itself as a 'fatal error'

Added:
   trunk/BOOK/xincludes/gst10-objc-error.xml   (contents, props changed)
      - copied, changed from r21626, trunk/BOOK/xincludes/gtk-doc-rebuild-problem.xml
   trunk/BOOK/xincludes/gst10-plugins.xml   (contents, props changed)
      - copied, changed from r21626, trunk/BOOK/xincludes/gtk-doc-rebuild-problem.xml
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/multimedia/libdriv/gst10-libav.xml
   trunk/BOOK/multimedia/libdriv/gst10-plugins-bad.xml
   trunk/BOOK/multimedia/libdriv/gst10-plugins-base.xml
   trunk/BOOK/multimedia/libdriv/gst10-plugins-good.xml
   trunk/BOOK/multimedia/libdriv/gst10-plugins-ugly.xml
   trunk/BOOK/multimedia/libdriv/gstreamer10-vaapi.xml
   trunk/BOOK/multimedia/libdriv/gstreamer10.xml

Modified: trunk/BOOK/general.ent
==============================================================================
--- trunk/BOOK/general.ent	Sat May 25 08:32:35 2019	(r21626)
+++ trunk/BOOK/general.ent	Sun May 26 13:07:26 2019	(r21627)
@@ -1,12 +1,12 @@
 <!-- $LastChangedBy$ $Date$ -->
 
-<!ENTITY day          "24">                   <!-- Always 2 digits -->
+<!ENTITY day          "26">                   <!-- Always 2 digits -->
 <!ENTITY month        "05">                   <!-- Always 2 digits -->
 <!ENTITY year         "2019">
 <!ENTITY copyrightdate "2001-&year;">
 <!ENTITY copyholder   "The BLFS Development Team">
 <!ENTITY version      "&year;-&month;-&day;">
-<!ENTITY releasedate  "May 24th, &year;">
+<!ENTITY releasedate  "May 26th, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->
 <!ENTITY lfs-version  "development">          <!-- x.y|development -->

Modified: trunk/BOOK/introduction/welcome/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	Sat May 25 08:32:35 2019	(r21626)
+++ trunk/BOOK/introduction/welcome/changelog.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -42,6 +42,16 @@
     </listitem>
     -->
     <listitem>
+      <para>May 26th, 2019</para>
+      <itemizedlist>
+        <listitem>
+          <para>[renodr] - Perform some minor tweaks and cleanup to the
+          GStreamer pages.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>May 24th, 2019</para>
       <itemizedlist>
         <listitem>

Modified: trunk/BOOK/multimedia/libdriv/gst10-libav.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/gst10-libav.xml	Sat May 25 08:32:35 2019	(r21626)
+++ trunk/BOOK/multimedia/libdriv/gst10-libav.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -10,7 +10,6 @@
   <!ENTITY gst10-libav-size          "9.0 MB">
   <!ENTITY gst10-libav-buildsize     "87 MB">
   <!ENTITY gst10-libav-time          "less than 0.1 SBU (Using parallelism=4)">
-  <!-- A majority of the time spent compiling is ASM files. -->
 ]>
 
 <sect1 id="gst10-libav" xreflabel="gst-libav-&gst10-libav-version;">
@@ -77,12 +76,14 @@
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
+      <xref linkend="ffmpeg"/> and
       <xref linkend="gst10-plugins-base"/>
     </para>
 
     <bridgehead renderas="sect4">Recommended</bridgehead>
     <para role="recommended">
-      <xref linkend="ffmpeg"/> and
+      <!-- With 1.14.x and before, an internal copy of FFMPEG was used.
+      This is no longer the case, so it is now required. -->
       <xref linkend="yasm"/>
     </para>
 
@@ -100,6 +101,9 @@
   <sect2 role="installation">
     <title>Installation of GStreamer Libav</title>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-objc-error.xml"/>
+    
     <para>
       Install <application>GStreamer Libav</application> by running the following
       commands:
@@ -126,15 +130,17 @@
 <screen role="root"><userinput>ninja install</userinput></screen>
   </sect2>
 
+  <!-- No longer included with Meson change
   <sect2 role="commands">
     <title>Command Explanations</title>
 
     <para>
-      <option>--with-libav-extra-configure="--disable-yasm"</option>: Use this
+      <option>- -with-libav-extra-configure="- -disable-yasm"</option>: Use this
       switch if you don't have <application>yasm</application> installed.
     </para>
 
   </sect2>
+  -->
 
   <sect2 role="content">
     <title>Contents</title>

Modified: trunk/BOOK/multimedia/libdriv/gst10-plugins-bad.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/gst10-plugins-bad.xml	Sat May 25 08:32:35 2019	(r21626)
+++ trunk/BOOK/multimedia/libdriv/gst10-plugins-bad.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -152,9 +152,11 @@
   <sect2 role="installation">
     <title>Installation of GStreamer Bad Plug-ins</title>
 
-    <note><para>If you need a plugin for a given dependency, that dependency
-      needs to be installed before this application.
-    </para></note>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-objc-error.xml"/>
+    
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-plugins.xml"/>
 
     <para>
       Install <application>GStreamer Bad Plug-ins</application> by running the

Modified: trunk/BOOK/multimedia/libdriv/gst10-plugins-base.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/gst10-plugins-base.xml	Sat May 25 08:32:35 2019	(r21626)
+++ trunk/BOOK/multimedia/libdriv/gst10-plugins-base.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -94,9 +94,7 @@
       <xref linkend="libogg"/>,
       <xref linkend="libtheora"/>,
       <xref linkend="libvorbis"/>, and
-      <xref linkend="xorg7-lib"/> <!-- build time requirements only...
-      That's not true: if X libraries are not installed, some plugins
-      are note built!-->
+      <xref linkend="xorg7-lib"/>
    </para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
@@ -120,14 +118,11 @@
   <sect2 role="installation">
     <title>Installation of GStreamer Base Plug-ins</title>
 
-    <note><para>If you need a plugin for a given dependency, that dependency
-      needs to be installed before this application.
-    </para></note>
-
-    <note><para>If you do not have a Objective-C compiler installed, the build
-      system for this package will throw a warning about a failed sanity check.
-      This is harmless, and it is safe to continue.
-    </para></note>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-objc-error.xml"/>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-plugins.xml"/>
 
     <para>
       Install <application>GStreamer Base Plug-ins</application> by running the

Modified: trunk/BOOK/multimedia/libdriv/gst10-plugins-good.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/gst10-plugins-good.xml	Sat May 25 08:32:35 2019	(r21626)
+++ trunk/BOOK/multimedia/libdriv/gst10-plugins-good.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -135,15 +135,19 @@
   <sect2 role="installation">
     <title>Installation of GStreamer Good Plug-ins</title>
 
-    <note><para>If you need a plugin for a given dependency, that dependency
-      needs to be installed before this application.
-    </para></note>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-objc-error.xml"/>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-plugins.xml"/>
+
+    <!-- No longer true since Meson/Ninja doesn't use libtool
     <caution><para>
       If you have Qt5 installed, the build may fail if you have Wayland support
       enabled in Qt. To fix this, run the <command>remove-la-files.sh</command>
       script that is in <xref linkend="la-files"/>.
     </para></caution>
+    -->
 
     <para>
       Install <application>GStreamer Good Plug-ins</application> by running the

Modified: trunk/BOOK/multimedia/libdriv/gst10-plugins-ugly.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/gst10-plugins-ugly.xml	Sat May 25 08:32:35 2019	(r21626)
+++ trunk/BOOK/multimedia/libdriv/gst10-plugins-ugly.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -112,9 +112,11 @@
   <sect2 role="installation">
     <title>Installation of GStreamer Ugly Plug-ins</title>
 
-    <note><para>If you need a plugin for a given dependency, that dependency
-      needs to be installed before this application.
-    </para></note>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-objc-error.xml"/>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-plugins.xml"/>
 
     <para>
       Install <application>GStreamer Ugly Plug-ins</application> by running the following

Modified: trunk/BOOK/multimedia/libdriv/gstreamer10-vaapi.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/gstreamer10-vaapi.xml	Sat May 25 08:32:35 2019	(r21626)
+++ trunk/BOOK/multimedia/libdriv/gstreamer10-vaapi.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -90,6 +90,9 @@
   <sect2 role="installation">
     <title>Installation of gstreamer-vaapi</title>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-objc-error.xml"/>
+
     <para>
       Install <application>gstreamer-vaapi</application> by running the following
       commands:

Modified: trunk/BOOK/multimedia/libdriv/gstreamer10.xml
==============================================================================
--- trunk/BOOK/multimedia/libdriv/gstreamer10.xml	Sat May 25 08:32:35 2019	(r21626)
+++ trunk/BOOK/multimedia/libdriv/gstreamer10.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -106,6 +106,9 @@
   <sect2 role="installation">
     <title>Installation of gstreamer</title>
 
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="../../xincludes/gst10-objc-error.xml"/>
+
     <para>
       Install <application>gstreamer</application> by running the following
       commands:

Copied and modified: trunk/BOOK/xincludes/gst10-objc-error.xml (from r21626, trunk/BOOK/xincludes/gtk-doc-rebuild-problem.xml)
==============================================================================
--- trunk/BOOK/xincludes/gtk-doc-rebuild-problem.xml	Sat May 25 08:32:35 2019	(r21626, copy source)
+++ trunk/BOOK/xincludes/gst10-objc-error.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -5,8 +5,9 @@
     <!-- $LastChangedBy$
          $Date$ -->
 
-    <para><option>--enable-gtk-doc</option>: This parameter is normally
-    used if <application>GTK-Doc</application> is installed and you wish 
-    to rebuild and install the API documentation. It is broken for
-    this package due to the use of a long deprecated gtk-doc program
-    that is no longer available.</para>
+    <!-- As part of their move to Meson, the GStreamer developers included a
+         check for an ObjC compiler, since their primary user other than Linux
+         is macOS. -->
+    <note><para>If you do not have an Objective-C compiler installed, the
+    build system for this package will emit a warning about a failed sanity
+    check. This is harmless, and it is safe to continue.</para></note>

Copied and modified: trunk/BOOK/xincludes/gst10-plugins.xml (from r21626, trunk/BOOK/xincludes/gtk-doc-rebuild-problem.xml)
==============================================================================
--- trunk/BOOK/xincludes/gtk-doc-rebuild-problem.xml	Sat May 25 08:32:35 2019	(r21626, copy source)
+++ trunk/BOOK/xincludes/gst10-plugins.xml	Sun May 26 13:07:26 2019	(r21627)
@@ -5,8 +5,8 @@
     <!-- $LastChangedBy$
          $Date$ -->
 
-    <para><option>--enable-gtk-doc</option>: This parameter is normally
-    used if <application>GTK-Doc</application> is installed and you wish 
-    to rebuild and install the API documentation. It is broken for
-    this package due to the use of a long deprecated gtk-doc program
-    that is no longer available.</para>
+    <!-- Since this is referenced in every GStreamer Plugins page, simplify
+    the pages by adding an XInclude. -->
+
+    <note><para>If you need a plugin for a given dependency, that dependency
+    needs to be installed before this package.</para></note>


More information about the blfs-book mailing list