glfs/general.ent
Xi Ruoyao 50836740d2
merge conditional XML from LFS
There was some consistency issues in URLs to LFS.  For example, in
systemd revision the URL to LFS "General Network Configuration" points
to the sysv book, this can be really troubling to new readers.

Instead of fixing them one by one, merge conditional XML developed by
Pierre from LFS.
2021-10-17 04:17:34 +08:00

191 lines
8.2 KiB
Plaintext

<!-- Editing up to the line of ==== should be enough
to generate a book for development, release, or rc-->
<!ENTITY % development "INCLUDE"><!-- set to INCLUDE for development,
set to IGNORE for release or rc -->
<!ENTITY % release "IGNORE"> <!-- set to INCLUDE for release,
set to IGNORE for development or rc -->
<!ENTITY % relyear "2022">
<!ENTITY % relnum "11.1">
<!ENTITY % reldate "March 1st, 2022">
<!ENTITY % relpubdate "2022-03-01">
<!-- ================================================================== -->
<!-- Do not change anything below unless the www or book layouts change -->
<!-- Automatically generated by git-version.sh. Used for release or dev -->
<!ENTITY % conditional-entities SYSTEM "conditional.ent">
%conditional-entities;
<![ %development; [
<!-- version info automatically generated by git -->
<!ENTITY % version-entities SYSTEM "version.ent">
%version-entities;
<![ %sysv; [
<!ENTITY lfs-version "development">
<!ENTITY blfs-version "svn">
]]>
<![ %systemd; [
<!ENTITY lfs-version "systemd">
<!ENTITY blfs-version "systemd">
]]>
]]><!-- End %development -->
<![ %release; [
<![ %sysv; [
<!ENTITY lfs-version "%relnum;">
<!ENTITY blfs-version "%relnum;">
]]>
<![ %systemd; [
<!ENTITY lfs-version "%relnum;-systemd">
<!ENTITY blfs-version "%relnum;-systemd">
]]>
<!ENTITY year "%relyear;">
<!ENTITY version "%relnum">
<!ENTITY releasedate "%reldate;">
<!ENTITY pubdate "%relpubdate;">
]]><!-- End %release -->
<!ENTITY copyrightdate "1999-&year;">
<!ENTITY copyholder "The BLFS Development Team">
<!ENTITY lfs-domainname "linuxfromscratch.org">
<!ENTITY maintainer-fullname "The BLFS Team">
<!ENTITY maintainer-firstname "BLFS">
<!ENTITY maintainer-address "blfs-maintainer@&lfs-domainname;">
<!ENTITY lfs-website "https://www.&lfs-domainname;">
<!-- downloads_root must have an entity because it is needed for scripts
change svn to x.y for release. Note: s/_/-/ in comment to avoid grep error
Update 'downloads-root-systemd' to x.y-systemd
-->
<!ENTITY downloads-root "https://www.linuxfromscratch.org/blfs/downloads/svn">
<!ENTITY downloads-root-systemd "https://www.linuxfromscratch.org/blfs/downloads/systemd">
<!ENTITY downloads-project "https://downloads.&lfs-domainname;">
<!ENTITY sources-anduin-http "https://anduin.linuxfromscratch.org/BLFS">
<!ENTITY sources-anduin-ftp "ftp://anduin.linuxfromscratch.org/BLFS">
<!ENTITY hints-root "https://www.&lfs-domainname;/hints">
<!ENTITY patch-downloads "https://www.linuxfromscratch.org/patches/downloads">
<!ENTITY patch-root "https://www.&lfs-domainname;/patches/blfs/svn">
<!ENTITY errata "https://www.&lfs-domainname;/blfs/errata/&blfs-version;/">
<!ENTITY blfs-ticket-root "https://wiki.&lfs-domainname;/blfs/ticket/">
<!ENTITY lfs-root "../../../../lfs/view/&lfs-version;">
<!ENTITY lfs-dev "../../../../lfs/view/development">
<!ENTITY gnu-http "https://ftp.gnu.org/gnu">
<!ENTITY gnu-ftp "ftp://ftp.gnu.org/gnu">
<!ENTITY gnupg-http "https://www.gnupg.org/ftp/gcrypt">
<!ENTITY gnupg-ftp "ftp://ftp.gnupg.org/gcrypt">
<!ENTITY gstreamer-dl "https://gstreamer.freedesktop.org/src">
<!ENTITY kernel-dl "https://www.kernel.org/pub">
<!ENTITY mozilla-http "https://archive.mozilla.org/pub">
<!ENTITY mozilla-hg "https://hg.mozilla.org/releases/mozilla-release/archive/">
<!ENTITY perl_authors "https://www.cpan.org/authors">
<!ENTITY metacpan_authors "https://cpan.metacpan.org/authors/id">
<!ENTITY pymodules-dl "https://files.pythonhosted.org/packages/source">
<!ENTITY sourceforge-dl "https://downloads.sourceforge.net">
<!ENTITY gentoo-ftp-repo "ftp://ftp.mirrorservice.org/sites/distfiles.gentoo.org/distfiles">
<!ENTITY fedora-http-repo "http://pkgs.fedoraproject.org/repo/pkgs">
<!ENTITY jaist-ftp-repo "ftp://ftp.jaist.ac.jp/pub//sourceforge">
<!ENTITY lxqt-http-repo "http://downloads.lxqt.org/lxqt">
<!ENTITY publisher "Unknown">
<!ENTITY xorg-download-http "https://www.x.org/pub/individual">
<!ENTITY xorg-download-ftp "ftp://ftp.x.org/pub/individual">
<!ENTITY pypi "https://pypi.python.org/pypi">
<!ENTITY appstream-glib-url "http://people.freedesktop.org/~hughsient/appstream-glib/releases">
<!ENTITY elinks-url "http://elinks.or.cz">
<!ENTITY w3m-url "http://w3m.sourceforge.net/">
<!-- These entities are used to identify versions of LFS
packages referenced throughout the BLFS book. -->
<!ENTITY lfs-autoconf-version "2.69">
<!ENTITY lfs-coreutils-version "8.23">
<!ENTITY lfs-e2fsprogs-version "1.42.11">
<!ENTITY lfs-flex-version "2.5.39">
<!ENTITY lfs-gcc-version "4.9.1">
<!ENTITY lfs-gdbm-version "1.11">
<!ENTITY lfs-m4-version "1.4.17">
<!-- FIXME - please check the included version of
List/Utils when upgrading the perl version.
Scalar-List-Utils is in perl-deps because List-AllUtils
needs a newer version at runtime than is in 5.34.0 -->
<!ENTITY lfs-perl-version "5.34"> <!-- used in git -->
<!-- this was originally the perl version used by the corresponding
version of lfs, in those days always for i686, but now BLFS is a rolling
release. \-\->
<!ENTITY lfs-perl-version "&lt;5.x.y&gt;/&lt;arch-linux&gt;">-->
<!ENTITY lfs-shadow-version "4.2.1">
<!ENTITY lfs-vim-version "7.4">
<!-- End LFS versions -->
<!ENTITY blfs-bootscripts-version "20210826">
<!ENTITY systemd-units-version "20210819">
<!ENTITY blfs-wiki "https://wiki.&lfs-domainname;/blfs/wiki">
<!-- These entities are used to annotate the current status of a package as it
relates to the version of LFS it will build/work against -->
<!ENTITY lfs110a_checked "<para>This package is known to build and work
properly using an LFS-11.0 platform.</para>">
<!--
<!ENTITY lfs110a_built "<para>This package is known to build using an LFS
11.0 platform but has not been tested.</para>">
-->
<!-- End special entities about LFS compatibility -->
<!ENTITY as_root "<note><para>When installing multiple packages in a script,
the installation needs to be done as the root user. There are three general
options that can be used to do this:</para>
<orderedlist>
<listitem><para>Run the entire script as the root user (not
recommended).</para></listitem>
<listitem><para>Use the <command>sudo</command> command from the <xref
linkend='sudo'/> package.</para></listitem>
<listitem><para>Use <command>su -c &quot;command arguments&quot;</command>
(quotes required) which will ask for the root password for every iteration
of the loop.</para></listitem>
</orderedlist>
<para>One way to handle this situation is to create a short
<command>bash</command> function that automatically selects the appropriate
method. Once the command is set in the environment, it does not need to be
set again.</para>
<screen><userinput>as_root()
{
if [ $EUID = 0 ]; then $*
elif [ -x /usr/bin/sudo ]; then sudo $*
else su -c \\&quot;$*\\&quot;
fi
}
export -f as_root</userinput></screen>
</note>">
<!ENTITY not-katamari "<para>This package is not a part of the Xorg
katamari and is provided only as a dependency to
other packages or for testing the completed Xorg
installation.</para>">
<!ENTITY % package-entities SYSTEM "packages.ent">
%package-entities;
<!ENTITY parallel_issues "<note><para>This package may occasionally fail when
building with multiple processors. See <xref
linkend='parallel-builds'/> for more information.</para></note>">
<!ENTITY shell-env "<note><para>If installing in the chroot environment, be
sure to export the <envar>SHELL</envar> environment
variable or configuration of the package will
fail.</para></note>">