systemd-stable/man/libsystemd-pkgconfig.xml

<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
          "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<refsect1>
  <title>Notes</title>

  <para id='pkgconfig-text'>These APIs are implemented as a shared
  library, which can be compiled and linked to with the
  <constant>libsystemd</constant> <citerefentry project='die-net'><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  file.</para>
</refsect1>
-												man: xinclude pkg-config note

											
										
										
											2014-02-20 22:39:26 -05:00
+								<?xml version="1.0"?>
 								<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
-												man: revert dynamic paths for split-usr setups

This did not really work out as we had hoped. Trying to do this upstream
introduced several problems that probably makes it better suited as a
downstream patch after all. At any rate, it is not releaseable in the
current state, so we at least need to revert this before the release.

 * by adjusting the path to binaries, but not do the same thing to the
   search path we end up with inconsistent man-pages. Adjusting the search
   path too would be quite messy, and it is not at all obvious that this is
   worth the effort, but at any rate it would have to be done before we
   could ship this.

 * this means that distributed man-pages does not make sense as they depend
   on config options, and for better or worse we are still distributing
   man pages, so that is something that definitely needs sorting out before
   we could ship with this patch.

 * we have long held that split-usr is only minimally supported in order
   to boot, and something we hope will eventually go away. So before we start
   adding even more magic/effort in order to make this work nicely, we should
   probably question if it makes sense at all.

											
										
										
											2015-06-18 19:47:44 +02:00
+								          "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
-												man: xinclude pkg-config note

											
										
										
											2014-02-20 22:39:26 -05:00
 								<refsect1>
 								  <title>Notes</title>
 								  <para id='pkgconfig-text'>These APIs are implemented as a shared
 								  library, which can be compiled and linked to with the
-												man: add a mapping for external manpages

It is annoying when we have dead links on fd.o.

Add project='man-pages|die-net|archlinux' to <citerefentry>-ies.

In generated html, add external links to
http://man7.org/linux/man-pages/man, http://linux.die.net/man/,
https://www.archlinux.org/.

By default, pages in sections 2 and 4 go to man7, since Michael
Kerrisk is the autorative source on kernel related stuff.

The rest of links goes to linux.die.net, because they have the
manpages.

Except for the pacman stuff, since it seems to be only available from
archlinux.org.

Poor gummiboot gets no link, because gummitboot(8) ain't to be found
on the net. According to common wisdom, that would mean that it does
not exist. But I have seen Kay using it, so I know it does, and
deserves to be found. Can somebody be nice and put it up somewhere?

											
										
										
											2014-07-07 18:25:54 -04:00
+								  <constant>libsystemd</constant> <citerefentry project='die-net'><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-												man: xinclude pkg-config note

											
										
										
											2014-02-20 22:39:26 -05:00
+								  file.</para>
 								</refsect1>