Changeset 765fd83


Ignore:
Timestamp:
01/19/2023 01:23:40 PM (17 months ago)
Author:
Pierre Labastie <pierre.labastie@…>
Branches:
11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal
Children:
bb4b217d
Parents:
6550bf6 (diff), ca1012d8 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.
Message:

Merge branch 'plabs/python-mods' into trunk

This branch introduces a new layout for python modules, similar
to what is done for perl modules. This allows to have useful python
modules in the book (sphinx, pytest, requests, gi-docgen), together
with their dependencies.

As a convenience for users who build by hand, a "Building
pythonhosted.org Files" section is added, which allows building all
the python modules dependencies in one go. It is generated from
the individual module pages, so the authoritative instructions are
on those individual pages.

Files:
42 added
1 deleted
45 edited
22 moved

Legend:

Unmodified
Added
Removed
  • .gitignore

    r6550bf6 r765fd83  
    44xxx
    55*.swp
     6general/prog/python-dependencies/pythonhosted.xml
  • Makefile

    r6550bf6 r765fd83  
     1# vim:ts=3
    12# Makefile for BLFS Book generation.
    23# By Tushar Teredesai <tushar@linuxfromscratch.org>
     
    910SHELL        = /bin/bash
    1011
     12PYHOSTED = general/prog/python-dependencies/pythonhosted.xml
    1113ALLXML := $(filter-out $(RENDERTMP)/%, \
    12         $(wildcard *.xml */*.xml */*/*.xml */*/*/*.xml */*/*/*/*.xml))
     14        $(filter-out $(PYHOSTED), \
     15        $(wildcard *.xml */*.xml */*/*.xml */*/*/*.xml */*/*/*/*.xml)))
    1316ALLXSL := $(filter-out $(RENDERTMP)/%, \
    1417        $(wildcard *.xsl */*.xsl */*/*.xsl */*/*/*.xsl */*/*/*/*.xsl))
     18
    1519
    1620ifdef V
     
    100104
    101105html: $(BASEDIR)/index.html
    102 $(BASEDIR)/index.html: $(RENDERTMP)/$(BLFSHTML) version
     106$(BASEDIR)/index.html: $(RENDERTMP)/$(BLFSHTML)
    103107        @echo "Generating chunked XHTML files..."
    104108        $(Q)xsltproc --nonet                                    \
     
    134138
    135139nochunks: $(BASEDIR)/$(NOCHUNKS_OUTPUT)
    136 $(BASEDIR)/$(NOCHUNKS_OUTPUT): $(RENDERTMP)/$(BLFSHTML) version
     140$(BASEDIR)/$(NOCHUNKS_OUTPUT): $(RENDERTMP)/$(BLFSHTML)
    137141        @echo "Generating non-chunked XHTML file..."
    138142        $(Q)xsltproc --nonet                                \
     
    157161
    158162validate: $(RENDERTMP)/$(BLFSFULL)
    159 $(RENDERTMP)/$(BLFSFULL): general.ent packages.ent $(ALLXML) $(ALLXSL) version
     163$(RENDERTMP)/$(BLFSFULL): $(PYHOSTED) version.ent
    160164        $(Q)[ -d $(RENDERTMP) ] || mkdir -p $(RENDERTMP)
    161165
     
    163167        $(Q)xsltproc --nonet                               \
    164168                --xinclude                            \
    165                 --output $(RENDERTMP)/$(BLFSHTML2)  \
     169                --output $(RENDERTMP)/$(BLFSHTML2)    \
    166170                --stringparam profile.revision $(REV) \
    167171                stylesheets/lfs-xsl/profile.xsl       \
     
    172176               --noent                             \
    173177               --postvalid                         \
    174                --output $(RENDERTMP)/$(BLFSFULL) \
     178               --output $(RENDERTMP)/$(BLFSFULL)   \
    175179               $(RENDERTMP)/$(BLFSHTML2)
    176180
    177181profile-html: $(RENDERTMP)/$(BLFSHTML)
    178 $(RENDERTMP)/$(BLFSHTML): $(RENDERTMP)/$(BLFSFULL) version
     182$(RENDERTMP)/$(BLFSHTML): $(RENDERTMP)/$(BLFSFULL)
    179183        @echo "Generating profiled XML for XHTML..."
    180184        $(Q)xsltproc --nonet                              \
    181185                --stringparam profile.condition html \
    182                 --output $(RENDERTMP)/$(BLFSHTML)  \
     186                --output $(RENDERTMP)/$(BLFSHTML)    \
    183187                stylesheets/lfs-xsl/profile.xsl      \
    184188                $(RENDERTMP)/$(BLFSFULL)
     
    189193          blfs-patches.sh > blfs-patch-list
    190194
    191 blfs-patches.sh: $(RENDERTMP)/$(BLFSFULL) version
     195blfs-patches.sh: $(RENDERTMP)/$(BLFSFULL)
    192196        @echo "Generating blfs patch script..."
    193197        $(Q)xsltproc --nonet                     \
     
    197201
    198202wget-list: $(BASEDIR)/wget-list
    199 $(BASEDIR)/wget-list: $(RENDERTMP)/$(BLFSFULL) version
     203$(BASEDIR)/wget-list: $(RENDERTMP)/$(BLFSFULL)
    200204        @echo "Generating wget list for $(REV) at $(BASEDIR)/wget-list ..."
    201205        $(Q)mkdir -p $(BASEDIR)
     
    206210
    207211test-links: $(BASEDIR)/test-links
    208 $(BASEDIR)/test-links: $(RENDERTMP)/$(BLFSFULL) version
     212$(BASEDIR)/test-links: $(RENDERTMP)/$(BLFSFULL)
    209213        @echo "Generating test-links file..."
    210214        $(Q)mkdir -p $(BASEDIR)
     
    249253systemd-units:
    250254        @VERSION=`grep "systemd-units-version " general.ent | cut -d\" -f2`; \
    251    UNITS="blfs-systemd-units-$$VERSION";                        \
    252    if [ ! -e $$UNITS.tar.xz ]; then                             \
    253      rm -rf $(RENDERTMP)/$$UNITS;                               \
    254      mkdir $(RENDERTMP)/$$UNITS;                                \
    255      cp -a ../systemd-units/* $(RENDERTMP)/$$UNITS;             \
    256      tar -cJhf $$UNITS.tar.xz -C $(RENDERTMP) $$UNITS;          \
     255   UNITS="blfs-systemd-units-$$VERSION";                                \
     256   if [ ! -e $$UNITS.tar.xz ]; then                                     \
     257     rm -rf $(RENDERTMP)/$$UNITS;                                       \
     258     mkdir $(RENDERTMP)/$$UNITS;                                        \
     259     cp -a ../systemd-units/* $(RENDERTMP)/$$UNITS;                     \
     260     tar -cJhf $$UNITS.tar.xz -C $(RENDERTMP) $$UNITS;                  \
    257261   fi
    258262
    259263dump-commands: $(DUMPDIR)
    260 $(DUMPDIR): $(RENDERTMP)/$(BLFSFULL) version
     264$(DUMPDIR): $(RENDERTMP)/$(BLFSFULL)
    261265        @echo "Dumping book commands..."
    262266        $(Q)xsltproc --output $(DUMPDIR)/          \
     
    266270
    267271.PHONY: blfs all world html nochunks tmpdir clean  \
    268    validate profile-html blfs-patch-list wget-list test-links \
    269    dump-commands  bootscripts systemd-units version
    270 
    271 version:
     272   validate profile-html blfs-patch-list wget-list \
     273        test-links dump-commands  bootscripts systemd-units
     274
     275version.ent: general.ent packages.ent $(ALLXML) $(ALLXSL)
    272276        $(Q)./git-version.sh $(REV)
     277
     278ALL_PYTHON_DEPS := $(filter-out $(PYHOSTED), \
     279                   $(wildcard general/prog/python-dependencies/*.xml))
     280
     281PYTHONHOSTED_MODS := requests sphinx_rtd_theme pytest gi-docgen
     282
     283PYTHONHOSTED_MOD_PAGES := $(addprefix general/prog/python-modules/,\
     284                          $(addsuffix .xml,$(PYTHONHOSTED_MODS)))
     285
     286$(PYHOSTED): $(ALL_PYTHON_DEPS)           \
     287             $(PYTHONHOSTED_MOD_PAGES)    \
     288             stylesheets/pyhosted-inc.xsl \
     289             stylesheets/pythonhosted.xsl | version.ent
     290        @echo Generating pythonhosted.xml
     291        $(Q)xsltproc --xinclude                                    \
     292                --output temp.xml                             \
     293                --stringparam packages "$(PYTHONHOSTED_MODS)" \
     294                stylesheets/pythonhosted.xsl                  \
     295                general/prog/python-modules.xml
     296        $(Q)mv temp.xml $@
  • archive/py2cairo.xml

    r6550bf6 r765fd83  
    7777      <bridgehead renderas="sect5">Optional</bridgehead>
    7878      <para role="optional">
     79        <!--TODO built for python2? -->
    7980        <ulink url="http://pytest.org">pytest</ulink>
    8081      </para>
  • general/genlib/gsl.xml

    r6550bf6 r765fd83  
    7272    <bridgehead renderas="sect4">Optional</bridgehead>
    7373    <para role="optional">
    74       <ulink url="https://www.sphinx-doc.org/en/stable/man/sphinx-build.html">Sphinx</ulink>
    75       with <ulink url="https://pypi.python.org/pypi/sphinx_rtd_theme">sphinx_rtd_theme</ulink>
     74      <xref linkend="sphinx_rtd_theme"/>
    7675    </para>
    7776
     
    9392
    9493    <para>
    95       If you have the optional <application>Sphinx</application> package
     94      If you have <xref linkend="sphinx_rtd_theme"/>
    9695      installed, build the documentation with:
    9796    </para>
  • general/genlib/libgusb.xml

    r6550bf6 r765fd83  
    8787    <bridgehead renderas="sect4">Optional</bridgehead>
    8888    <para role="optional">
    89       <ulink url="https://download.gnome.org/sources/gi-docgen/">gi-docgen</ulink>
     89      <xref linkend="gi-docgen"/>
    9090    </para>
    9191
     
    128128    <para>
    129129      <parameter>-Ddocs=false</parameter>: building documentation needs
    130       <application>gi-docgen</application>. Remove this switch if you have
     130      <xref linkend="gi-docgen"/>. Remove this switch if you have
    131131      installed <application>gi-docgen</application>, and you wish to build
    132132      the API documentation.
  • general/genlib/libportal.xml

    r6550bf6 r765fd83  
    8383    <bridgehead renderas="sect4">Optional</bridgehead>
    8484    <para role="optional">
    85       <xref linkend="vala"/> and
    86       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     85      <xref linkend="gi-docgen"/> and
     86      <xref linkend="vala"/>
    8787    </para>
    8888
     
    138138    <para>
    139139      <parameter>-Ddocs=false</parameter>: Remove this parameter if
    140       <application>gi-docgen</application> is installed and you wish to rebuild
     140      <xref linkend="gi-docgen"/> is installed and you wish to rebuild
    141141      and install the API documentation.
    142142    </para>
  • general/genlib/libwacom.xml

    r6550bf6 r765fd83  
    8585      <xref linkend="librsvg"/>,
    8686      <xref linkend="valgrind"/> (optional for some tests), and
    87       <ulink url="https://docs.pytest.org/en/stable/">pytest</ulink> with
     87      <xref linkend="pytest"/> with
    8888      <ulink url="https://pypi.org/project/libevdev/">python-libevdev</ulink> and
    8989      <ulink url="https://pypi.org/project/pyudev/">pyudev</ulink>
     
    120120      To test the results, issue: <command>ninja test</command>.
    121121      To run additional tests, install
    122       <ulink url="https://docs.pytest.org/en/stable/">pytest</ulink> and remove
     122      <xref linkend="pytest"/> and remove
    123123      the "-Dtests=disabled" option from the meson line above.
    124124    </para>
     
    140140    <para>
    141141      <parameter>-Dtests=disabled</parameter>: This parameter disables some of
    142       the more advanced tests because they require
    143       <ulink url="https://docs.pytest.org/en/stable/">pytest</ulink> to work
    144       properly.
     142      the more advanced tests because they require <xref linkend="pytest"/> to
     143      work properly.
    145144    </para>
    146145
  • general/graphlib/librsvg.xml

    r6550bf6 r765fd83  
    8787    <para role="optional">
    8888      <xref linkend="docutils"/> (for man pages),
     89      <xref linkend="gi-docgen"/> (for documentation),
    8990      <xref linkend="xorg7-font"/> (for tests), and
    90       <ulink url="&gi-docgen-url;">gi-docgen</ulink> (for documentation)
    9191    </para>
    9292
     
    154154    </para>
    155155
    156     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    157       href="../../xincludes/gtk-doc-rebuild.xml"/>
     156    <para>
     157      <option>--disable-gtk-doc</option>: This switch prevents building
     158      the API documentation, even if <xref linkend="gi-docgen"/> (despite
     159      the name of the option) is available.
     160    </para>
    158161
    159162  </sect2>
  • general/graphlib/libtiff.xml

    r6550bf6 r765fd83  
    9595      <xref linkend="freeglut"/> (required for <command>tiffgt</command>),
    9696      <xref linkend="libjpeg"/>,
     97      <xref linkend="sphinx"/>,
    9798      <xref linkend="libwebp"/>,
    98       <ulink url="https://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>,
    99       <ulink url="https://www.osgeo.org/projects/lerc-limited-error-raster-compression/">LERC</ulink>, and
    100       <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink>
     99      <ulink url="https://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>, and
     100      <ulink url="https://www.osgeo.org/projects/lerc-limited-error-raster-compression/">LERC</ulink>
    101101    </para>
    102102
  • general/graphlib/qpdf.xml

    r6550bf6 r765fd83  
    7979      <xref linkend="fop"/>,
    8080      <xref linkend="gnutls"/>, and
    81       <ulink url="https://www.sphinx-doc.org/en/master/index.html">sphinx</ulink>
     81      <xref linkend="sphinx"/>
    8282    </para>
    8383
  • general/prog/cmake.xml

    r6550bf6 r765fd83  
    9999      <xref linkend="mercurial"/> (for use during tests),
    100100      <xref linkend="qt5"/> (for the Qt-based GUI),
    101       <xref linkend="subversion"/> (for testing),
    102       <ulink url="http://rhash.sourceforge.net/">rhash</ulink>, and
    103       <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink> (for building documents)
     101      <xref linkend="sphinx"/> (for building documents),
     102      <xref linkend="subversion"/> (for testing), and
     103      <ulink url="http://rhash.sourceforge.net/">rhash</ulink>
    104104    </para>
    105105
  • general/prog/llvm.xml

    r6550bf6 r765fd83  
    190190      <xref linkend="pygments"/>,
    191191      <xref linkend="rsync"/> (for tests),
     192      <xref linkend="recommonmark"/> (for building documentation),
    192193      <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>),
    193194      <xref linkend="valgrind"/>,
     
    196197      <ulink url="https://ocaml.org/">OCaml</ulink>,
    197198      <ulink url="https://pypi.org/project/psutil/">psutil</ulink> (for tests),
    198       <ulink url="https://pypi.python.org/pypi/recommonmark">recommonmark</ulink>
    199       and <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink>
    200       (for building the documentation), and
    201       <ulink url="https://github.com/Z3Prover/z3">Z3</ulink>
     199      and <ulink url="https://github.com/Z3Prover/z3">Z3</ulink>
    202200    </para>
    203201
     
    282280
    283281    <para>
    284       If you have installed <application>Sphinx</application> and
    285       <application>recommonmark</application> and wish
    286       to generate the html documentation and manual pages, issue the following
    287       commands:
     282      If you have installed <xref linkend="recommonmark"/> and its
     283      dependencies, you can generate the html documentation and manual
     284      pages with the following commands:
    288285    </para>
    289286
     
    332329<!-- as of version 13.0.0, the install process seems to install the html
    333330     documentation and the manual pages. The llvm html documentation
    334      is installed into /usr/share/doc/llvm, while the clang html documentation
    335      is installed into /usr/doc/clang. So we have just to move it. -->
     331     is installed into /usr/share/doc/LLVM/llvm, while the clang html
     332     documentation is installed into /usr/share/doc/LLVM/clang. So we have
     333     just to move it. -->
    336334    <para>
    337335      If you have built the llvm documentation, it has been installed
  • general/prog/prog.xml

    r6550bf6 r765fd83  
    4747  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="python3.xml"/>
    4848  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="python-modules.xml"/>
     49  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="python-dependencies.xml"/>
    4950  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ruby.xml"/>
    5051  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="rust.xml"/>
  • general/prog/python-modules.xml

    r6550bf6 r765fd83  
    7676      <listitem>
    7777        <para>
     78          <xref linkend="doxypypy"/>
     79        </para>
     80      </listitem>
     81      <listitem>
     82        <para>
     83          <xref linkend="doxyqml"/>
     84        </para>
     85      </listitem>
     86      <listitem>
     87        <para>
     88          <xref linkend="gi-docgen"/>
     89        </para>
     90      </listitem>
     91      <listitem>
     92        <para>
     93          <xref linkend="packaging"/>
     94        </para>
     95      </listitem>
     96      <listitem>
     97        <para>
    7898          <xref linkend="py3c"/>
    7999        </para>
     
    166186        </para>
    167187      </listitem>
    168 <!--      <listitem>
    169         <para>
    170           <xref linkend="python-slip"/>
    171         </para>
    172       </listitem>
    173 -->
     188      <listitem>
     189        <para>
     190          <xref linkend="pyparsing"/>
     191        </para>
     192      </listitem>
     193      <listitem>
     194        <para>
     195          <xref linkend="pytest"/>
     196        </para>
     197      </listitem>
     198      <listitem>
     199        <para>
     200          <xref linkend="recommonmark"/>
     201        </para>
     202      </listitem>
     203      <listitem>
     204        <para>
     205          <xref linkend="requests"/>
     206        </para>
     207      </listitem>
    174208      <listitem>
    175209        <para>
     
    180214        <para>
    181215          <xref linkend="six"/>
     216        </para>
     217      </listitem>
     218      <listitem>
     219        <para>
     220          <xref linkend="sphinx"/>
     221        </para>
     222      </listitem>
     223      <listitem>
     224        <para>
     225          <xref linkend="sphinx_rtd_theme"/>
    182226        </para>
    183227      </listitem>
     
    191235
    192236  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    193     href="asciidoc.xml"/>
    194 
    195   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    196     href="cython.xml"/>
    197 
    198   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    199     href="dbus-python.xml"/>
     237    href="python-modules/asciidoc.xml"/>
     238
     239  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     240    href="python-modules/cython.xml"/>
     241
     242  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     243    href="python-modules/dbus-python.xml"/>
    200244
    201245<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     
    203247-->
    204248  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    205     href="docutils.xml"/>
    206 
    207   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    208     href="py3c.xml"/>
    209 
    210   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    211     href="pyatspi2.xml"/>
     249    href="python-modules/docutils.xml"/>
     250
     251  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     252    href="python-modules/doxypypy.xml"/>
     253
     254  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     255    href="python-modules/doxyqml.xml"/>
     256
     257  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     258    href="python-modules/gi-docgen.xml"/>
     259
     260  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     261    href="python-modules/packaging.xml"/>
     262
     263  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     264    href="python-modules/py3c.xml"/>
     265
     266  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     267    href="python-modules/pyatspi2.xml"/>
    212268<!--
    213269  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     
    215271-->
    216272  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    217     href="pycairo.xml"/>
    218 
    219   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    220     href="pycairo2.xml"/>
    221 
    222   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    223     href="pycryptodome.xml"/>
    224 
    225   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    226     href="python-dbusmock.xml"/>
    227 
    228   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    229     href="pygments.xml"/>
    230 
    231   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    232     href="pygobject2.xml"/>
    233 
    234   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    235     href="pygobject3.xml"/>
    236 
    237   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    238     href="pygtk.xml"/>
    239 
    240   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    241     href="pyxdg.xml"/>
     273    href="python-modules/pycairo.xml"/>
     274
     275  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     276    href="python-modules/pycairo2.xml"/>
     277
     278  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     279    href="python-modules/pycryptodome.xml"/>
     280
     281  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     282    href="python-modules/python-dbusmock.xml"/>
     283
     284  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     285    href="python-modules/pygments.xml"/>
     286
     287  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     288    href="python-modules/pygobject2.xml"/>
     289
     290  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     291    href="python-modules/pygobject3.xml"/>
     292
     293  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     294    href="python-modules/pygtk.xml"/>
     295
     296  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     297    href="python-modules/pyxdg.xml"/>
     298
     299  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     300    href="python-modules/recommonmark.xml"/>
    242301
    243302<!--
     
    253312
    254313  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    255     href="libxml2py2.xml"/>
    256 
    257   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    258     href="lxml.xml"/>
    259 
    260   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    261     href="markupsafe.xml"/>
    262 
    263   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    264     href="jinja2.xml"/>
    265 
    266   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    267     href="mako.xml"/>
    268 
    269 <!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    270     href="python-slip.xml"/>-->
    271 
    272   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    273     href="pyyaml.xml"/>
    274 
    275   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    276     href="scour.xml"/>
    277 
    278   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    279     href="six.xml"/>
     314    href="python-modules/libxml2py2.xml"/>
     315
     316  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     317    href="python-modules/lxml.xml"/>
     318
     319  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     320    href="python-modules/markupsafe.xml"/>
     321
     322  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     323    href="python-modules/jinja2.xml"/>
     324
     325  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     326    href="python-modules/mako.xml"/>
     327
     328  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     329    href="python-modules/pyparsing.xml"/>
     330
     331  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     332    href="python-modules/pytest.xml"/>
     333
     334  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     335    href="python-modules/pyyaml.xml"/>
     336
     337  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     338    href="python-modules/requests.xml"/>
     339
     340  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     341    href="python-modules/scour.xml"/>
     342
     343  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     344    href="python-modules/six.xml"/>
     345
     346  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     347    href="python-modules/sphinx.xml"/>
     348
     349  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     350    href="python-modules/sphinx_rtd_theme.xml"/>
    280351
    281352</sect1>
  • general/prog/python-modules/asciidoc.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    99  <!ENTITY asciidoc-md5sum        "ecac3af818f7a65596efc6e243b520a0">
    1010  <!ENTITY asciidoc-size          "212 KB">
    11   <!ENTITY asciidoc-buildsize     "2.6 MB">
     11  <!ENTITY asciidoc-buildsize     "4.3 MB">
    1212  <!ENTITY asciidoc-time          "less than 0.1 SBU">
    1313]>
    1414
    15 <!-- Begin Py3c -->
    1615  <sect2 id="asciidoc" xreflabel="asciidoc-&asciidoc-version;">
    1716
     
    8483    <sect3 role="installation">
    8584      <title>Installation of Asciidoc</title>
    86 <!-- version 9.x is from blfs 11.0. We are now at 11.1
     85
    8786      <para>
    88         If you are upgrading from version 9.x, remove the previously installed
    89         executables, as the <systemitem class="username">root</systemitem>
    90         user:
     87        Build the module:
    9188      </para>
    92 
    93 <screen role="root"><userinput>rm -rf /usr/bin/{asciidoc*,a2x*}</userinput></screen>
    94 -->
    95     <para> Build the module: </para>
    9689
    9790<screen><userinput>pip3 wheel -w dist --no-build-isolation --no-deps $PWD</userinput></screen>
    9891
    99     <para>
    100       This package does not come with a test suite.
    101     </para>
     92      <para>
     93        This package does not come with a test suite.
     94      </para>
    10295
    103     <para>
    104       Now, as the <systemitem class="username">root</systemitem> user:
    105     </para>
     96      <para>
     97        Now, as the <systemitem class="username">root</systemitem> user:
     98      </para>
    10699
    107100<screen role="root"><userinput>pip3 install --no-index --find-links dist --no-cache-dir --no-user asciidoc</userinput></screen>
     
    110103
    111104    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    112       href="../../xincludes/pip3-cmd-explain.xml"/>
     105      href="../../../xincludes/pip3-cmd-explain.xml"/>
    113106
    114107    <sect3 role="content">
  • general/prog/python-modules/cython.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    1313]>
    1414
    15 <!-- Begin Py3c -->
    1615  <sect2 id="cython" xreflabel="cython-&cython-version;">
    1716
     
    7170      <title>Installation of Cython</title>
    7271
    73     <para> Build the module: </para>
     72      <para>
     73        Build the module:
     74      </para>
    7475
    7576<screen><userinput>pip3 wheel -w dist --no-build-isolation --no-deps $PWD</userinput></screen>
    7677
    77     <para>
    78       This package does not come with a test suite.
    79     </para>
     78      <para>
     79        This package does not come with a test suite.
     80      </para>
    8081
    81     <para>
    82       Now, as the <systemitem class="username">root</systemitem> user:
    83     </para>
     82      <para>
     83        Now, as the <systemitem class="username">root</systemitem> user:
     84      </para>
    8485
    8586<screen role="root"><userinput>pip3 install --no-index --find-links dist --no-cache-dir --no-user Cython</userinput></screen>
     
    8889
    8990    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    90       href="../../xincludes/pip3-cmd-explain.xml"/>
     91      href="../../../xincludes/pip3-cmd-explain.xml"/>
    9192
    9293    <sect3 role="content">
     
    99100
    100101        <seglistitem>
    101           <seg>None</seg>
     102          <seg>cygdb cython cythonize</seg>
    102103          <seg>None</seg>
    103104          <seg>
    104             /usr/lib/python&python3-majorver;/site-packages/Cython and
    105             /usr/lib/python&python3-majorver;/site-packages/Cython-&cython-version;.dist-info
     105            /usr/lib/python&python3-majorver;/site-packages/Cython,
     106            /usr/lib/python&python3-majorver;/site-packages/Cython-&cython-version;.dist-info, and
     107            /usr/lib/python&python3-majorver;/site-packages/pyximport
    106108          </seg>
    107109        </seglistitem>
    108110      </segmentedlist>
    109111
     112      <variablelist>
     113        <bridgehead renderas="sect5">Short Descriptions</bridgehead>
     114        <?dbfo list-presentation="list"?>
     115        <?dbhtml list-presentation="table"?>
     116
     117        <varlistentry id="cygdb">
     118          <term><command>cygdb</command></term>
     119          <listitem>
     120            <para>
     121              is the Cython debugger
     122            </para>
     123            <indexterm zone="cython cygdb">
     124              <primary sortas="b-cygdb">cygdb</primary>
     125            </indexterm>
     126          </listitem>
     127        </varlistentry>
     128
     129        <varlistentry id="cython-prog">
     130          <term><command>cython</command></term>
     131          <listitem>
     132            <para>
     133              is a compiler for code written in the Cython language. It outputs
     134              a C/C++ program which can be compiled with a C/C++ compiler
     135            </para>
     136            <indexterm zone="cython cython-prog">
     137              <primary sortas="b-cython-prog">cython</primary>
     138            </indexterm>
     139          </listitem>
     140        </varlistentry>
     141
     142        <varlistentry id="cythonize">
     143          <term><command>cythonize</command></term>
     144          <listitem>
     145            <para>
     146              is a compiler for code written in the Cython language. It outputs
     147              an extension module which is directly importable from Python
     148            </para>
     149            <indexterm zone="cython cythonize">
     150              <primary sortas="b-cythonize">cythonize</primary>
     151            </indexterm>
     152          </listitem>
     153        </varlistentry>
     154
     155      </variablelist>
     156
    110157    </sect3>
    111158
  • general/prog/python-modules/dbus-python.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    8585       Optional (Required to build the API and HTML Documentation)</bridgehead>
    8686      <para role="optional">
    87         <xref linkend="docutils"/> and
    88         <ulink url="https://www.sphinx-doc.org/en/master/">Sphinx</ulink> with
    89         <ulink url="https://github.com/rtfd/sphinx_rtd_theme">sphinx_rtd_theme</ulink>
     87        <xref linkend="sphinx_rtd_theme"/>
    9088      </para>
    9189
  • general/prog/python-modules/jinja2.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    102102
    103103    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    104       href="../../xincludes/pip3-cmd-explain.xml"/>
     104      href="../../../xincludes/pip3-cmd-explain.xml"/>
    105105
    106106    <sect3 role="content">
  • general/prog/python-modules/libxml2py2.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
  • general/prog/python-modules/lxml.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    9797
    9898    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    99       href="../../xincludes/pip3-cmd-explain.xml"/>
     99      href="../../../xincludes/pip3-cmd-explain.xml"/>
    100100
    101101    <sect3 role="content">
  • general/prog/python-modules/mako.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    7676      <bridgehead renderas="sect5">Optional (for Testing)</bridgehead>
    7777      <para role="optional">
    78         <ulink url="https://pypi.org/project/pytest/">pytest</ulink>
     78        <xref linkend="pytest"/>
    7979      </para>
    8080
     
    106106
    107107    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    108       href="../../xincludes/pip3-cmd-explain.xml"/>
     108      href="../../../xincludes/pip3-cmd-explain.xml"/>
    109109
    110110    <sect3 role="content">
     
    130130      </segmentedlist>
    131131
     132      <variablelist>
     133        <bridgehead renderas="sect5">Short Descriptions</bridgehead>
     134        <?dbfo list-presentation="list"?>
     135        <?dbhtml list-presentation="table"?>
     136
     137        <varlistentry id="mako-render">
     138          <term><command>mako-render</command></term>
     139          <listitem>
     140            <para>
     141             renders a template
     142            </para>
     143            <indexterm zone="Mako mako-render">
     144              <primary sortas="b-mako-render">mako-render</primary>
     145            </indexterm>
     146          </listitem>
     147        </varlistentry>
     148
     149      </variablelist>
     150
    132151    </sect3>
    133152
  • general/prog/python-modules/markupsafe.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    9797
    9898    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    99       href="../../xincludes/pip3-cmd-explain.xml"/>
     99      href="../../../xincludes/pip3-cmd-explain.xml"/>
    100100
    101101    <sect3 role="content">
  • general/prog/python-modules/py3c.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    99  <!ENTITY py3c-md5sum        "53029afde7e0cf8672a2d69d378a0cfc">
    1010  <!ENTITY py3c-size          "47 KB">
    11   <!ENTITY py3c-buildsize     "608 KB">
    12   <!ENTITY py3c-time          "less than 0.1 SBU">
     11  <!ENTITY py3c-buildsize     "608 KB (with tests)">
     12  <!ENTITY py3c-time          "less than 0.1 SBU (with tests)">
    1313]>
    1414
  • general/prog/python-modules/pyatspi2.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
  • general/prog/python-modules/pycairo.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    7777      <para role="optional">
    7878        <ulink url="https://hypothesis.readthedocs.io">Hypothesis</ulink> and
    79         <ulink url="https://pypi.org/project/pytest/">pytest</ulink>
    80         (for tests)
     79        <xref linkend="pytest"/> (for tests)
    8180      </para>
    8281
     
    108107ninja</userinput></screen>
    109108
    110 
    111 <!--python3 setup.py build</userinput></screen>-->
    112 
    113109      <para>
    114110        To run the tests, this package requires the optional pytest module. If
    115111        it is installed, run the tests by running <command>ninja test</command>.
     112        The <emphasis>test_surface.py</emphasis> test has a failure.
    116113      </para>
    117114
     
    122119<screen role="root"><userinput>ninja install</userinput></screen>
    123120
    124 
    125 <!--python3 setup.py install - -optimize=1   &amp;&amp;
    126 python3 setup.py install_pycairo_header &amp;&amp;
    127 python3 setup.py install_pkgconfig</userinput></screen>-->
    128 <!-- Seems that install does the following too
    129 python2 setup.py install_pycairo_header &amp;&amp;
    130 python2 setup.py install_pkgconfig</userinput></screen>-->
    131 
    132 <!-- Python2 is no longer supported
    133 python2 setup.py install - -optimize=1   &amp;&amp;
    134 python2 setup.py install_pycairo_header &amp;&amp;
    135 python2 setup.py install_pkgconfig      &amp;&amp;-->
    136121    </sect3>
    137122
     
    149134          </seg>
    150135          <seg>
    151             <!--_cairo.so (python2) and -->
    152             _cairo.&python3-lib-suffix;.so
     136            None
    153137          </seg>
    154138          <seg>
    155139            /usr/include/pycairo,
    156 <!--            /usr/lib/python&python2-majorver;/site-packages/cairo,
    157             /usr/lib/python&python2-majorver;/site-packages/pycairo-&pycairo-version;-py&python2-majorver;.egg,
    158             /usr/lib/python&python3-majorver;/site-packages/cairo--> and
    159             /usr/lib/python&python3-majorver;/site-packages/pycairo-&pycairo-version;-py&python3-majorver;.egg
     140            /usr/lib/python&python3-majorver;/site-packages/cairo, and
     141            /usr/lib/python&python3-majorver;/site-packages/pycairo-&pycairo-version;.egg-info
    160142          </seg>
    161143        </seglistitem>
  • general/prog/python-modules/pycairo2.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
  • general/prog/python-modules/pycryptodome.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    9292
    9393    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    94       href="../../xincludes/pip3-cmd-explain.xml"/>
     94      href="../../../xincludes/pip3-cmd-explain.xml"/>
    9595
    9696    <sect3 role="content">
     
    110110          </seg>
    111111          <seg>
     112            /usr/lib/python&python3-majorver;/site-packages/Crypto
    112113            /usr/lib/python&python3-majorver;/site-packages/pycryptodome-&pycryptodome-version;.dist-info
    113114          </seg>
  • general/prog/python-modules/pygments.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    9191
    9292    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    93       href="../../xincludes/pip3-cmd-explain.xml"/>
     93      href="../../../xincludes/pip3-cmd-explain.xml"/>
    9494
    9595    <sect3 role="content">
     
    109109           </seg>
    110110          <seg>
    111             /usr/lib/python&python3-majorver;/site-packages/pygments amd
     111            /usr/lib/python&python3-majorver;/site-packages/pygments and
    112112            /usr/lib/python&python3-majorver;/site-packages/Pygments-&pygments-version;.dist-info
    113113          </seg>
     
    115115      </segmentedlist>
    116116
     117      <variablelist>
     118        <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     119        <?dbfo list-presentation="list"?>
     120        <?dbhtml list-presentation="table"?>
     121
     122        <varlistentry id="pygmentize">
     123          <term><command>pygmentize</command></term>
     124          <listitem>
     125            <para>
     126              highlights an input file and writes the result to an output file
     127            </para>
     128            <indexterm zone="pygments pygmentize">
     129              <primary sortas="b-pygmentize">pygmentize</primary>
     130            </indexterm>
     131          </listitem>
     132        </varlistentry>
     133
     134      </variablelist>
     135
    117136    </sect3>
    118137
  • general/prog/python-modules/pygobject2.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
  • general/prog/python-modules/pygobject3.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    1111  <!ENTITY pygobject3-md5sum        "c5b31bb58156661c0954f1dbfc950fc9">
    1212  <!ENTITY pygobject3-size          "548 KB">
    13   <!ENTITY pygobject3-buildsize     "14 MB">
    14   <!ENTITY pygobject3-time          "0.1 SBU">
     13  <!ENTITY pygobject3-buildsize     "8.0 MB (add 2.5 MB for tests)">
     14  <!ENTITY pygobject3-time          "0.1 SBU (with tests)">
    1515]>
    1616
     
    8383        <ulink url="https://pypi.python.org/pypi/pep8">pep8</ulink>,
    8484        <ulink url="https://pypi.python.org/pypi/pyflakes">pyflakes</ulink>, and
    85         <ulink url="https://pypi.python.org/pypi/pytest">pytest</ulink>
     85        <xref linkend="pytest"/>
    8686        <!-- pytest brings in a lot of dependencies - upwards of 10 -->
    8787      </para>
     
    132132
    133133      <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    134         href="../../xincludes/meson-buildtype-release.xml"/>
     134        href="../../../xincludes/meson-buildtype-release.xml"/>
    135135    </sect3>
    136136
     
    148148           </seg>
    149149          <seg>
    150             <!--/usr/lib/python&python2-majorver;/site-packages/gi/_gi{,_cairo}.so and/or-->
    151150            /usr/lib/python&python3-majorver;/site-packages/gi/_gi{,_cairo}.&python3-lib-suffix;.so
    152151           </seg>
    153152          <seg>
    154153            /usr/include/pygobject-3.0 and
    155              <!--/usr/lib/python&python2-majorver;/site-packages/{gi,pygtkcompat} and/or-->
    156154            /usr/lib/python&python3-majorver;/site-packages/{gi,pygtkcompat}
    157155          </seg>
  • general/prog/python-modules/pygtk.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
  • general/prog/python-modules/python-dbusmock.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    9696
    9797    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    98       href="../../xincludes/pip3-cmd-explain.xml"/>
     98      href="../../../xincludes/pip3-cmd-explain.xml"/>
    9999
    100100    <sect3 role="content">
  • general/prog/python-modules/pyxdg.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    9797
    9898    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    99       href="../../xincludes/pip3-cmd-explain.xml"/>
     99      href="../../../xincludes/pip3-cmd-explain.xml"/>
    100100
    101101    <sect3 role="content">
  • general/prog/python-modules/pyyaml.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    9797
    9898    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    99       href="../../xincludes/pip3-cmd-explain.xml"/>
     99      href="../../../xincludes/pip3-cmd-explain.xml"/>
    100100
    101101    <sect3 role="content">
  • general/prog/python-modules/scour.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    9797
    9898    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    99       href="../../xincludes/pip3-cmd-explain.xml"/>
     99      href="../../../xincludes/pip3-cmd-explain.xml"/>
    100100
    101101    <sect3 role="content">
  • general/prog/python-modules/six.xml

    r6550bf6 r765fd83  
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    4   <!ENTITY % general-entities SYSTEM "../../general.ent">
     4   <!ENTITY % general-entities SYSTEM "../../../general.ent">
    55  %general-entities;
    66
     
    120120
    121121    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    122       href="../../xincludes/pip3-cmd-explain.xml"/>
     122      href="../../../xincludes/pip3-cmd-explain.xml"/>
    123123
    124124    <sect3 role="content">
  • general/sysutils/systemd.xml

    r6550bf6 r765fd83  
    118118      <xref linkend="qrencode"/>,
    119119      <xref linkend="rsync"/>,
     120      <xref linkend="sphinx"/>,
    120121      <xref linkend="valgrind"/>,
    121122      <xref linkend="zsh"/> (for the zsh completions),
     
    128129      <ulink url="https://lz4.github.io/lz4/">lz4</ulink>,
    129130      <!--<ulink url="http://fukuchi.org/works/qrencode/">qrencode</ulink>,-->
    130       <ulink url="https://sourceforge.net/projects/linuxquota/">quota-tools</ulink>,
    131       <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink>, and
     131      <ulink url="https://sourceforge.net/projects/linuxquota/">quota-tools</ulink>, and
    132132      <ulink url="https://tpm2-tss.readthedocs.io/en/latest/">tpm2-tss</ulink>
    133133    </para>
  • gnome/applications/evince.xml

    r6550bf6 r765fd83  
    102102      <xref linkend="gspell"/>,
    103103      <xref linkend="gst10-plugins-base"/>,
     104      <xref linkend="gi-docgen"/>,
    104105      <xref linkend="gtk-doc"/>,
    105106      <xref linkend="libgxps"/>,
     
    107108      <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>),
    108109      <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
    109       <ulink url="&gi-docgen-url;">gi-docgen</ulink>,
    110110      <ulink url="http://www.freedesktop.org/wiki/Software/libspectre/">libspectre</ulink>,
    111111      <ulink url="https://github.com/jlaurens/synctex">Synctex</ulink>, and
  • gnome/applications/file-roller.xml

    r6550bf6 r765fd83  
    9999    <bridgehead renderas="sect4">Optional (for the API documentation)</bridgehead>
    100100    <para role="optional">
    101       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     101      <xref linkend="gi-docgen"/>
    102102    </para>
    103103
     
    160160    <para>
    161161      <option>-Dapi_docs=enabled</option>: Use this switch if you have
    162       <ulink url="&gi-docgen-url;">gi-docgen</ulink> installed and wish to
     162      <xref linkend="gi-docgen"/> installed and wish to
    163163      generate the API documentation.
    164164    </para>
  • gnome/platform/gcr.xml

    r6550bf6 r765fd83  
    9090    <bridgehead renderas="sect4">Optional</bridgehead>
    9191    <para role="optional">
    92       <!--<xref linkend="gtk-doc"/> and-->
    93       <xref linkend="valgrind"/> and
    94       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     92      <xref linkend="gi-docgen"/> and
     93      <xref linkend="valgrind"/>
    9594    </para>
    9695
  • gnome/platform/gcr4.xml

    r6550bf6 r765fd83  
    9090    <bridgehead renderas="sect4">Optional</bridgehead>
    9191    <para role="optional">
    92       <xref linkend="valgrind"/> and
    93       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     92      <xref linkend="gi-docgen"/> and
     93      <xref linkend="valgrind"/>
    9494    </para>
    9595
  • gnome/platform/libgweather.xml

    r6550bf6 r765fd83  
    8989    <bridgehead renderas="sect4">Optional</bridgehead>
    9090    <para role="optional">
    91       <xref linkend="llvm"/> (for clang-format),
    92       <ulink url="&gi-docgen-url;">gi-docgen</ulink>,
    93       <ulink url="https://pypi.org/project/pylint/">pylint</ulink>, and
    94       for the bundled gi-docgen module:
    95       <phrase revision="sysv"><xref linkend="Jinja2"/>,
    96       <xref linkend="MarkupSafe"/>,</phrase>
    97       <xref linkend="pygments"/>,
    98       <ulink url="https://pypi.org/project/Markdown/">Markdown</ulink>,
    99       <ulink url="https://pypi.org/project/toml/">toml</ulink>, and
    100       <ulink url="https://pypi.org/project/typogrify/">typogrify</ulink>
     91      <xref linkend="gi-docgen"/> (gi-docgen is also provided as a meson
     92      subproject, which will be used if <option>-Dgtk_doc=false</option>
     93      is not passed to <command>meson</command>),
     94      <xref linkend="llvm"/> (for clang-format), and
     95      <ulink url="https://pypi.org/project/pylint/">pylint</ulink>
    10196    </para>
    10297
     
    147142      <parameter>-Dgtk_doc=false</parameter>: allows building without using
    148143      the bundled <application>gi-docgen</application> module. Remove this
    149       switch if you have the needed dependencies, and you wish to rebuild
    150       and install the API documentation.
     144      switch if you have installed <xref linkend="gi-docgen"/>, and wish to
     145      build and install the API documentation.
    151146    </para>
    152147
  • gnome/platform/libpeas.xml

    r6550bf6 r765fd83  
    8484    <bridgehead renderas="sect4">Optional</bridgehead>
    8585    <para role="optional">
    86       <ulink url="&gi-docgen-url;">gi-docgen</ulink>,
     86      <xref linkend="gi-docgen"/>,
    8787      <ulink url="http://glade.gnome.org/">Glade</ulink>,
    8888      <ulink url="https://pypi.org/project/embed">embed</ulink>,
     
    149149      <option>-Dgtk_doc=true</option>: Add this switch if you wish to
    150150      build the reference manual and you have
    151       <ulink url="&gi-docgen-url;">gi-docgen</ulink> installed on your system.
     151      <xref linkend="gi-docgen"/> installed on your system.
    152152    </para>
    153153
  • gnome/platform/libshumate.xml

    r6550bf6 r765fd83  
    7676    <bridgehead renderas="sect4">Optional</bridgehead>
    7777    <para role="optional">
    78       <xref linkend="gtk-doc"/> and
    79       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     78      <xref linkend="gi-docgen"/> and
     79      <xref linkend="gtk-doc"/>
    8080    </para>
    8181
     
    118118    <para>
    119119      <parameter>-Dgtk_doc=false</parameter>: This switch disables documentation
    120       generation because it requires
    121       <ulink url="&gi-docgen-url;">gi-docgen</ulink>. Remove this if you have
    122       gi-docgen installed and wish to generate the API documentation.
     120      generation. Remove this if you have both <xref linkend="gtk-doc"/> and
     121      <xref linkend="gi-docgen"/> installed and wish to generate the API
     122      documentation.
    123123    </para>
    124124  </sect2>
  • gnome/platform/nautilus.xml

    r6550bf6 r765fd83  
    9696    <bridgehead renderas="sect4">Optional</bridgehead>
    9797    <para role="optional">
    98       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     98      <xref linkend="gi-docgen"/>
    9999    </para>
    100100
  • gnome/platform/rest.xml

    r6550bf6 r765fd83  
    8585    <bridgehead renderas="sect4">Optional</bridgehead>
    8686    <para role="optional">
    87       <xref linkend="libadwaita1"/> (to build the demo),
    88       <xref linkend="vala"/>, and
    89       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     87      <xref linkend="gi-docgen"/>,
     88      <xref linkend="libadwaita1"/> (to build the demo), and
     89      <xref linkend="vala"/>
    9090    </para>
    9191
     
    132132    <para>
    133133      <parameter>-Dgtk_doc=false</parameter>: Remove this option if
    134       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     134      <xref linkend="gi-docgen"/>
    135135      is installed and you wish to build and install the API documentation.
    136136    </para>
  • introduction/welcome/changelog.xml

    r6550bf6 r765fd83  
    5757      <itemizedlist>
    5858        <listitem>
     59          <para>[pierre] - Change external references to python modules
     60          now in the book to internal references.</para>
     61        </listitem>
     62        <listitem>
    5963          <para>[ken] - Update to firefox-102.7.0 (security update), also
    6064          update to JS-102.7.0 (normal update). Fixes
     
    138142      <para>January 13th, 2023</para>
    139143      <itemizedlist>
     144        <listitem>
     145          <para>[pierre] - Add an XSL stylesheet for generating the
     146          pythonhosted.xml page from the information contained in
     147          the python modules and dependencies sections, and use it
     148          in Makefile.</para>
     149        </listitem>
    140150        <listitem>
    141151          <para>[bdubbs] - Update to llvm-15.0.7. Fixes
     
    11201130          <ulink url="&blfs-ticket-root;17036">#17036</ulink>.</para>
    11211131        </listitem>
     1132        <listitem>
     1133          <para>[ken] - Patch python module Requests to use the same
     1134          environment variable as Pip to access system certificates,
     1135          therefore remove the unneeded dependency of Certifi.</para>
     1136        </listitem>
    11221137      </itemizedlist>
    11231138    </listitem>
  • kde/extra-cmake-modules.xml

    r6550bf6 r765fd83  
    7777    <bridgehead renderas="sect4">Optional</bridgehead>
    7878    <para role="optional">
     79      <xref linkend="sphinx"/> (for building documentation) and
    7980      <ulink url="https://pypi.org/project/PyQt5/">PyQt</ulink> (experimental
    80       support for building KDE Python bindings), and
    81       <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink> (for
    82          building documentation)
     81      support for building KDE Python bindings)
    8382    </para>
    8483
  • kde/kf5/kf5-frameworks.xml

    r6550bf6 r765fd83  
    124124  <bridgehead renderas="sect4">Additional recommended dependencies for kapidox</bridgehead>
    125125  <para role="recommended">
    126     <xref role="runtime" linkend="doxygen"/> (Run time)<phrase revision="sysv">,
    127     <xref linkend="Jinja2"/>, and
    128     <xref linkend="PyYAML"/></phrase>
    129     <phrase revision="systemd"> and
    130     <xref linkend="PyYAML"/></phrase>
    131   </para>
    132 
    133   <bridgehead renderas="sect4">Other python modules needed by kapidox</bridgehead>
    134   <para role="optional">
    135     <ulink url="https://pypi.org/simple/doxypypy/">doxypypy</ulink>,
    136     <ulink url="https://pypi.org/simple/doxyqml/">doxyqml</ulink>, and
    137     <ulink url="https://pypi.org/simple/requests/">requests</ulink>, which
    138     itself depends on
    139     <ulink url="https://pypi.org/simple/certifi/">certifi</ulink>,
    140     <ulink url="https://pypi.org/simple/charset-normalizer/">charset-normalizer</ulink>,
    141     <ulink url="https://pypi.org/simple/idna/">idna</ulink>, and
    142     <ulink url="https://pypi.org/simple/urllib3/">urllib3</ulink> (all will be
    143     installed by the <command>pip3 install</command> command below)
     126    <xref role="runtime" linkend="doxygen"/> (Run time),
     127    <xref linkend="doxypypy"/>,
     128    <xref linkend="doxyqml"/>,
     129    <phrase revision="sysv"><xref linkend="Jinja2"/>,</phrase>
     130    <xref linkend="PyYAML"/>, and
     131    <xref linkend="requests"/>
    144132  </para>
    145133
     
    365353      case $name in
    366354        kapidox)
    367           # First install some python module dependencies
    368           as_root pip3 install --no-user doxypypy doxyqml requests
    369 
    370355          pip3 wheel -w dist --no-build-isolation --no-deps $PWD
    371356          as_root pip3 install --no-index --find-links dist --no-cache-dir --no-user kapidox
  • networking/netlibs/libsoup3.xml

    r6550bf6 r765fd83  
    9393      <xref linkend="brotli"/>,
    9494      <xref linkend="curl"/> (required to run the test suite),
    95       <xref linkend="sysprof"/> (for profiling),
     95      <xref linkend="gi-docgen"/>,
    9696      <xref linkend="mitkrb"/> (required to run the test suite),
    97       <!--<xref linkend="gtk-doc"/>,-->
    98          <!-- It seems that XMLRPC is part of PHP 5.4.10 -->
     97   <!-- It seems that XMLRPC is part of PHP 5.4.10 -->
    9998      <xref linkend="php"/> compiled with XMLRPC-EPI
    10099      support (only used for the XMLRPC regression tests),
    101100      <xref linkend="samba"/> (ntlm_auth is required to run the test suite), and
    102       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     101      <xref linkend="sysprof"/> (for profiling)
    103102    </para>
    104103
     
    158157      <option>-Ddocs=enabled</option>: Use this option if you want to build
    159158      the documentation. Note that you must have
    160       <ulink url="&gi-docgen-url;">gi-docgen</ulink> installed.
     159      <xref linkend="gi-docgen"/> installed.
    161160    </para>
    162161
  • networking/netlibs/nghttp2.xml

    r6550bf6 r765fd83  
    8181      <xref linkend="jansson"/>, <!-- required to build the HPACK tools -->
    8282      <xref linkend="libevent"/>, <!--required to build the examples-->
     83      <xref linkend="sphinx"/>, <!--required to build documentation-->
    8384      <!--<xref linkend="python2"/>,--> <!--required for the python bindings)-->
    84 <!---      <phrase revision="systemd">
    85         <xref linkend="setuptools"/>, <!- -(required for the python bindings- ->
    86       </phrase> -->
    8785      <ulink url="http://cunit.sourceforge.net/">CUnit</ulink> (required for
    8886      the test suite),
     
    9391      <ulink url="http://software.schmorp.de/pkg/libev.html">libev</ulink>,
    9492      <!--required to build the applications-->
    95       <ulink url="https://mruby.org/">mruby</ulink>, <!--provides ruby support
    96       in the sample HTTP server-->
    97 <!--      <phrase revision="sysv">
    98         <ulink url="https://pypi.python.org/pypi/setuptools/">Setuptools</ulink>,
    99       </phrase> -->
    100       <ulink url="https://tatsuhiro-t.github.io/spdylay/">Spdylay</ulink>, and
     93      <ulink url="https://mruby.org/">mruby</ulink>, and
     94      <!--provides ruby support in the sample HTTP server-->
     95      <ulink url="https://tatsuhiro-t.github.io/spdylay/">Spdylay</ulink>,
    10196      <!--provide SPDY functionality-->
    102       <ulink url="https://www.sphinx-doc.org/">Sphinx</ulink>. <!--required to build
    103       documentation-->
    10497    </para>
    10598
  • networking/netprogs/samba.xml

    r6550bf6 r765fd83  
    148148      Install in listed order:
    149149      <xref linkend="six"/>,
     150      <xref linkend="pytest"/>,
    150151      <ulink url="&pypi;/argparse/">argparse</ulink>,
    151152      <ulink url="&pypi;/extras/">extras</ulink>,
    152       <ulink url="&pypi;/py/">py</ulink>,
    153153      <!--<ulink url="&pypi;/enum34/">enum34</ulink>,-->
    154154      <ulink url="&pypi;/hypothesis/">hypothesis</ulink>,
    155       <ulink url="&pypi;/pytest/">pytest</ulink>,
    156155      <ulink url="&pypi;/coverage/">coverage</ulink>,
    157156      <ulink url="&pypi;/pytest-cov/">pytest-cov</ulink>,
  • networking/netutils/bind-utils.xml

    r6550bf6 r765fd83  
    8484      <xref linkend="libcap-pam"/>,
    8585      <xref linkend="libxml2"/>, and
    86       <ulink url="https://www.sphinx-doc.org/en/master/">Sphinx</ulink>
     86      <xref linkend="sphinx"/>
    8787    </para>
    8888
     
    148148      <command>make -C doc</command>: This command builds the
    149149      manual pages if the optional Python module
    150       <ulink url="https://www.sphinx-doc.org/en/master/">Sphinx</ulink>
    151       is installed.
     150      <xref linkend="sphinx"/> is installed.
    152151    </para>
    153152
  • packages.ent

    r6550bf6 r765fd83  
    512512<!ENTITY dbus-python-version          "1.3.2">
    513513<!ENTITY docutils-version             "0.19">
     514<!ENTITY doxypypy-version             "0.8.8.6">
     515<!ENTITY doxyqml-version              "0.5.1">
     516<!ENTITY gi-docgen-version            "2022.1">
    514517<!ENTITY py3c-version                 "1.4">
    515518<!ENTITY pyatspi2-version             "2.46.0">
     
    522525<!ENTITY pygobject3-version           "3.42.2">
    523526<!ENTITY pygtk-version                "2.24.0">
     527<!ENTITY pyparsing-version            "3.0.9">
     528<!ENTITY pytest-version               "7.1.3">
    524529<!ENTITY pyxdg-version                "0.28">
    525530<!-- libxml2 for Python2 shares the version of libxml2 -->
     
    528533<!ENTITY Jinja2-version               "3.1.2">
    529534<!ENTITY mako-version                 "1.2.4">
     535<!ENTITY recommonmark-version         "0.7.1">
     536<!ENTITY requests-version             "2.28.1">
    530537<!ENTITY scour-version                "0.38.2">
    531538<!ENTITY six-version                  "1.16.0">
     539<!ENTITY sphinx-version               "5.2.2">
     540<!ENTITY sphinx_rtd_theme-version     "1.0.0">
    532541<!ENTITY PyYAML-version               "6.0">
     542
     543<!-- Python module versions used in the Python Dependencies instructions -->
     544<!-- sc = sphinxcontrib -->
     545<!ENTITY alabaster-version              "0.7.12">
     546<!ENTITY attrs-version                  "22.1.0">
     547<!ENTITY babel-version                  "2.10.3">
     548<!ENTITY certifi-version                "2022.9.24">
     549<!ENTITY charset-normalizer-version     "2.1.1">
     550<!ENTITY commonmark-version             "0.9.1">
     551<!ENTITY flit_core-version              "3.7.1">
     552<!ENTITY idna-version                   "3.4">
     553<!ENTITY iniconfig-version              "1.1.1">
     554<!ENTITY imagesize-version              "1.4.1">
     555<!ENTITY markdown-version               "3.4.1">
     556<!ENTITY packaging-version              "21.3">
     557<!ENTITY pluggy-version                 "1.0.0">
     558<!ENTITY py-version                     "1.11.0">
     559<!ENTITY pytz-version                   "2022.4">
     560<!ENTITY setuptools_scm-version         "7.0.5">
     561<!ENTITY snowballstemmer-version        "2.2.0">
     562<!ENTITY sc-applehelp-version           "1.0.2">
     563<!ENTITY sc-devhelp-version             "1.0.2">
     564<!ENTITY sc-htmlhelp-version            "2.0.0">
     565<!ENTITY sc-jsmath-version              "1.0.1">
     566<!ENTITY sc-qthelp-version              "1.0.3">
     567<!ENTITY sc-serializinghtml-version     "1.1.5">
     568<!ENTITY smartypants-version            "2.0.1">
     569<!ENTITY toml-version                   "0.10.2">
     570<!ENTITY tomli-version                  "2.0.1">
     571<!ENTITY typing_extensions-version      "4.4.0">
     572<!ENTITY typogrify-version              "2.0.7">
     573<!ENTITY urllib3-version                "1.26.12">
    533574
    534575<!-- Part IV -->
  • postlfs/filesystems/btrfs-progs.xml

    r6550bf6 r765fd83  
    9595      <xref linkend="lvm2"/> (<command>dmsetup</command> is used in tests),
    9696      <xref linkend="reiserfs"/> (for tests), and
    97       <ulink url="https://www.sphinx-doc.org/">Sphinx</ulink> (required to build documentation),
     97      <xref linkend="sphinx"/> (required to build documentation),
    9898
    9999    </para>
  • postlfs/filesystems/fuse3.xml

    r6550bf6 r765fd83  
    7474    <para role="optional">
    7575      <xref linkend="doxygen"/> (to rebuild the API documentation) and
    76       <ulink url="https://pypi.org/project/pytest/">pytest</ulink> (required for tests)
     76      <xref linkend="pytest"/> (required for tests)
    7777    </para>
    7878
     
    146146
    147147    <para>
    148       The <ulink url="https://pypi.org/project/pytest/">pytest</ulink> Python
     148      The <xref linkend="pytest"/> Python
    149149      module is required for the tests.  One test named
    150150      <filename>test_cuse</filename> will fail if the
  • postlfs/security/cyrus-sasl.xml

    r6550bf6 r765fd83  
    105105      <xref linkend="mitkrb"/>,
    106106      <xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>,
    107       <!--<xref linkend="openjdk"/>, Removed in 2.1.28 -->
    108107      <xref linkend="openldap"/>,
    109108      <xref linkend="postgresql"/>,
     109      <xref linkend="sphinx"/>,
    110110      <xref linkend="sqlite"/>,
    111111      <ulink url="https://stuff.mit.edu/afs/net.mit.edu/project/attic/krb4/">krb4</ulink>,
    112       <ulink url="https://dmalloc.com/">Dmalloc</ulink>,
    113       <ulink url="https://metacpan.org/pod/Pod::POM::View::Restructured">Pod::POM::View::Restructured</ulink>,
    114       and <ulink url="https://pypi.org/project/Sphinx">Sphinx</ulink>
     112      <ulink url="https://dmalloc.com/">Dmalloc</ulink>, and
     113      <ulink url="https://metacpan.org/pod/Pod::POM::View::Restructured">Pod::POM::View::Restructured</ulink>
    115114    </para>
    116115
  • postlfs/virtualization/qemu.xml

    r6550bf6 r765fd83  
    106106    </para>
    107107
    108     <bridgehead renderas="sect4">Optional dependencies for installing the documentation</bridgehead>
     108    <bridgehead renderas="sect4">Optional (for building the documentation)</bridgehead>
    109109    <para role="optional">
    110       <ulink url="https://www.sphinx-doc.org/en/master/index.html">sphinx</ulink> with the
    111       <ulink url="https://pypi.org/project/sphinx-rtd-theme/">sphinx-rtd-theme</ulink> theme
     110      <xref linkend="sphinx_rtd_theme"/>
    112111    </para>
    113112
  • server/databases/mariadb.xml

    r6550bf6 r765fd83  
    109109      <xref linkend="pcre2"/>,
    110110      <xref linkend="ruby"/>,
     111      <xref linkend="sphinx"/>,
    111112      <xref linkend="unixodbc"/>,
    112113      <xref linkend="valgrind"/>,
     
    119120      <ulink url="https://www.mruby.org/">mruby</ulink>,
    120121      <ulink url="https://mariadb.com/kb/en/myrocks/">MyRocks</ulink>,
    121       <ulink url="https://github.com/google/snappy">Snappy</ulink>,
    122       <ulink url="https://sphinxsearch.com/downloads/">Sphinx</ulink>, and
     122      <ulink url="https://github.com/google/snappy">Snappy</ulink>, and
    123123      <!--<ulink url="https://mariadb.com/kb/en/mariadb/tokudb/">TokuDB</ulink>, and-->
    124124      <ulink url="https://zeromq.org/">ZeroMQ</ulink>
  • server/major/bind.xml

    r6550bf6 r765fd83  
    9898      <xref linkend="lmdb"/>,
    9999      <xref linkend="mitkrb"/>,
     100      <xref linkend="pytest"/>,
     101      <xref linkend="sphinx"/> (required to build documentation),
    100102      <ulink url="https://cmocka.org/">cmocka</ulink>,
    101103      <ulink url="https://github.com/cjheath/geoip">geoip</ulink>,
    102       <ulink url="https://docs.pytest.org/en/stable/">pytest</ulink>,
    103       <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink> (required to build documentation), and
    104104      <ulink url="&w3m-url;">w3m</ulink>
    105105    </para>
     
    178178      The test suite may indicate some skipped tests depending on
    179179      what configuration options are used. Some tests are marked
    180       <quote>UNTESTED</quote> or does even fail if <xref linkend="perl-net-dns"/>
     180      <quote>UNTESTED</quote> or do even fail if <xref linkend="perl-net-dns"/>
    181181      is not installed. <!--One test, <quote>CPU</quote>, is known to fail.-->
    182182      To run the tests, as an unprivileged user, execute:
     
    575575      is included in the source package. The documentation is in .rst
    576576      format which means, it can be converted in human readable formats
    577       if <ulink url="https://www.sphinx-doc.org/">Sphinx</ulink> is
    578       installed. As time of writing, sphinx is not included in
    579       the BLFS book and therefore, the instructions above do not
    580       install the docs.
     577      if <xref linkend="sphinx"/> is installed.
    581578    </para>
    582579
     
    586583      recommended to consult the ARM documentation. ISC provides an
    587584      updated set of excellent documentation along with every release
    588       so it can be easily be viewed and/or downloaded - so there is
     585      so it can be easily viewed and/or downloaded &ndash; so there is
    589586      no excuse to not read the docs. The formats ISC provides are PDF,
    590587      epub and html at <ulink url="https://downloads.isc.org/isc/bind9/&bind-version;/doc/arm/"/>.
  • server/other/unbound.xml

    r6550bf6 r765fd83  
    8585      <xref linkend="nettle"/>,
    8686      <xref linkend="python2"/>,
     87      <xref linkend="sphinx"/> (for Python bindings documentation),
    8788      <xref linkend="swig"/> (for Python bindings),
    88       <xref linkend="doxygen"/> (for html documentation),
    89       <ulink url="https://dnstap.info/">dnstap</ulink>, and
    90       <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink> (for
    91       Python bindings documentation)
     89      <xref linkend="doxygen"/> (for html documentation), and
     90      <ulink url="https://dnstap.info/">dnstap</ulink>
    9291    </para>
    9392
  • x/installing/libinput.xml

    r6550bf6 r765fd83  
    8989        <xref linkend="libunwind"/> (required for tests),
    9090        <xref linkend="libwacom"/>, and
    91         <ulink url="https://www.sphinx-doc.org/">Sphinx</ulink> (required to build documentation),
    92         <ulink url="https://pypi.org/project/pyparsing/">PyParsing</ulink> (for one non-root test)
     91        <xref linkend="sphinx"/> (required to build documentation),
     92        <xref linkend="pyparsing"/> (for one non-root test)
    9393      </para>
    9494
     
    209209        the main tests.  Even with the tests defined as false, you can still run
    210210        the first four minor tests, as a regular user, but one will be skipped if
    211         <ulink url="https://pypi.org/project/pyparsing">PyParsing</ulink> is not
    212         installed.
     211        <xref linkend="pyparsing"/> is not installed.
    213212      </para>
    214213
  • x/lib/gdk-pixbuf.xml

    r6550bf6 r765fd83  
    9898    <bridgehead renderas="sect4">Optional</bridgehead>
    9999    <para role="optional">
    100        <!--<xref linkend="jasper"/> and-->
    101   <!--<xref linkend="gtk-doc"/> and-->
    102       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     100      <xref linkend="gi-docgen"/>
    103101      (to generate documentation)
    104102    </para>
  • x/lib/gtk4.xml

    r6550bf6 r765fd83  
    103103      <xref linkend="ffmpeg"/> (built with
    104104      <xref role='nodep' linkend='libvpx'/>),
     105      <xref linkend="gi-docgen"/>,
    105106      <xref linkend="gtk-doc"/>,
    106107      <xref role="runtime" linkend="highlight"/>
     
    109110      <xref linkend="libcloudproviders"/>,
    110111      <xref linkend="sassc"/>,
    111       <xref linkend="tracker3"/>,
    112       <ulink url="&gi-docgen-url;">gi-docgen</ulink>, and
    113       <!--<ulink url="https://gitlab.gnome.org/World/libcloudproviders">libcloudproviders</ulink>, and-->
     112      <xref linkend="tracker3"/>, and
    114113      <ulink url="https://vulkan.lunarg.com/sdk/home">vulkan</ulink>
    115114    </para>
     
    194193    <para>
    195194      <option>-Dgtk_doc=true</option>: Use this switch if you have
    196       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     195      <xref linkend="gi-docgen"/>
    197196      installed and wish to generate the API reference documentation.
    198197    </para>
  • x/lib/pango.xml

    r6550bf6 r765fd83  
    9393  <!--<xref linkend="gtk-doc"/>,-->
    9494      <xref linkend="sysprof"/>,
    95       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
    96       (to generate documentation),
     95      <xref linkend="gi-docgen"/> (to generate documentation),
    9796      <ulink url="https://ftpmirror.gnu.org/gnu/help2man">help2man</ulink>, and
    9897      <ulink url="https://linux.thai.net/projects/libthai">libthai</ulink>
     
    150149      href="../../xincludes/meson-buildtype-release.xml"/>
    151150
    152     <!-- gtk-doc replaced by gi-docgen
    153     <para>
    154       <option>-Dgtk_doc</option>: Use this switch if gtk-doc is
    155       installed and you wish to rebuild and install the API documentation.
    156     </para>-->
     151    <para>
     152      <option>-Dgtk_doc=true</option>: Although the default value of this
     153      option is <option>false</option>, the API documentation will be rebuilt
     154      and installed if <xref linkend="gi-docgen"/> is available, either
     155      as a meson submodule (see below the <option>--wrap-mod</option> option)
     156      or on the system. The only difference when setting this option to
     157      <option>true</option> is that meson exits with in error if gi-docgen
     158      is not available.
     159    </para>
    157160
    158161    <para>
  • x/lib/webkitgtk.xml

    r6550bf6 r765fd83  
    116116    <para role="optional">
    117117      <xref linkend="bubblewrap"/>,
     118      <xref linkend="gi-docgen"/>,
    118119      <xref linkend="gtk4"/>,
    119120      <xref linkend="harfbuzz"/>,
     
    121122      <xref linkend="woff2"/>,
    122123      <ulink url="https://ccache.dev/">ccache</ulink>,
    123       <ulink url="&gi-docgen-url;">gi-docgen</ulink>,
    124124      <ulink url="https://sourceforge.net/projects/hunspell/files/Hyphen/">Hyphen</ulink>,
    125125      <ulink url="https://github.com/AOMediaCodec/libavif">libavif</ulink>,
     
    241241      <parameter>-DENABLE_DOCUMENTATION=OFF</parameter>: This switch disables
    242242      regenerating the documentation. Remove this switch if you have
    243       <ulink url="&gi-docgen-url;">gi-docgen</ulink>
     243      <xref linkend="gi-docgen"/>
    244244      installed and wish to regenerate the documentation.
    245245    </para>
  • xsoft/other/fontforge.xml

    r6550bf6 r765fd83  
    112112      <xref linkend="libjpeg"/>,
    113113      <xref linkend="libtiff"/>,
     114      <xref linkend="sphinx"/> (to build html documentation),
    114115      <xref linkend="woff2"/>, and
    115       <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink>
    116       (to build html documentation)
    117116    </para>
    118117
Note: See TracChangeset for help on using the changeset viewer.