[50836740] | 1 | <!-- Editing up to the line of ==== should be enough
|
---|
| 2 | to generate a book for development, release, or rc-->
|
---|
| 3 | <!ENTITY % development "INCLUDE"><!-- set to INCLUDE for development,
|
---|
| 4 | set to IGNORE for release or rc -->
|
---|
| 5 | <!ENTITY % release "IGNORE"> <!-- set to INCLUDE for release,
|
---|
| 6 | set to IGNORE for development or rc -->
|
---|
| 7 | <!ENTITY % relyear "2022">
|
---|
| 8 | <!ENTITY % relnum "11.1">
|
---|
| 9 | <!ENTITY % reldate "March 1st, 2022">
|
---|
| 10 | <!ENTITY % relpubdate "2022-03-01">
|
---|
| 11 | <!-- ================================================================== -->
|
---|
| 12 | <!-- Do not change anything below unless the www or book layouts change -->
|
---|
| 13 |
|
---|
| 14 | <!-- Automatically generated by git-version.sh. Used for release or dev -->
|
---|
| 15 | <!ENTITY % conditional-entities SYSTEM "conditional.ent">
|
---|
| 16 | %conditional-entities;
|
---|
| 17 |
|
---|
| 18 | <![ %development; [
|
---|
| 19 | <!-- version info automatically generated by git -->
|
---|
[17c9da8] | 20 | <!ENTITY % version-entities SYSTEM "version.ent">
|
---|
| 21 | %version-entities;
|
---|
[50836740] | 22 | <![ %sysv; [
|
---|
[4c0df5c4] | 23 | <!ENTITY lfs-version "development">
|
---|
| 24 | <!ENTITY blfs-version "svn">
|
---|
| 25 | <!ENTITY patch-version "svn">
|
---|
[50836740] | 26 | ]]>
|
---|
| 27 | <![ %systemd; [
|
---|
[4c0df5c4] | 28 | <!ENTITY lfs-version "systemd">
|
---|
| 29 | <!ENTITY blfs-version "systemd">
|
---|
| 30 | <!ENTITY patch-version "svn">
|
---|
[50836740] | 31 | ]]>
|
---|
| 32 | ]]><!-- End %development -->
|
---|
| 33 |
|
---|
| 34 | <![ %release; [
|
---|
| 35 | <![ %sysv; [
|
---|
[4c0df5c4] | 36 | <!ENTITY lfs-version "%relnum;">
|
---|
| 37 | <!ENTITY blfs-version "%relnum;">
|
---|
| 38 | <!ENTITY patch-version "%relnum;">
|
---|
[50836740] | 39 | ]]>
|
---|
| 40 | <![ %systemd; [
|
---|
[4c0df5c4] | 41 | <!ENTITY lfs-version "%relnum;-systemd">
|
---|
| 42 | <!ENTITY blfs-version "%relnum;-systemd">
|
---|
| 43 | <!ENTITY patch-version "%relnum;">
|
---|
[50836740] | 44 | ]]>
|
---|
| 45 |
|
---|
| 46 | <!ENTITY year "%relyear;">
|
---|
[4dfe93eb] | 47 | <!ENTITY version "%relnum;">
|
---|
[50836740] | 48 | <!ENTITY releasedate "%reldate;">
|
---|
| 49 | <!ENTITY pubdate "%relpubdate;">
|
---|
| 50 | ]]><!-- End %release -->
|
---|
[17c9da8] | 51 |
|
---|
[50836740] | 52 | <!ENTITY copyrightdate "1999-&year;">
|
---|
| 53 | <!ENTITY copyholder "The BLFS Development Team">
|
---|
| 54 | <!ENTITY lfs-domainname "linuxfromscratch.org">
|
---|
[29a430f] | 55 |
|
---|
[f6ba18fd] | 56 | <!ENTITY maintainer-fullname "The BLFS Team">
|
---|
| 57 | <!ENTITY maintainer-firstname "BLFS">
|
---|
[41666068] | 58 | <!ENTITY maintainer-address "blfs-maintainer@&lfs-domainname;">
|
---|
[4e88613] | 59 |
|
---|
[428191d] | 60 |
|
---|
[4a570af1] | 61 | <!ENTITY lfs-website "https://www.&lfs-domainname;">
|
---|
[4be2261] | 62 | <!-- downloads_root must have an entity because it is needed for scripts
|
---|
| 63 | Note: s/_/-/ in comment to avoid grep error
|
---|
| 64 | It is also needed for systemd units
|
---|
| 65 | -->
|
---|
[4c0df5c4] | 66 | <!ENTITY downloads-root "&lfs-website;/blfs/downloads/&blfs-version;">
|
---|
| 67 | <!--<!ENTITY downloads-root-systemd "https://www.linuxfromscratch.org/blfs/downloads/systemd">
|
---|
| 68 | <!ENTITY downloads-project "https://downloads.&lfs-domainname;">-->
|
---|
[a29486e4] | 69 |
|
---|
[18bd6a3] | 70 | <!ENTITY sources-anduin-http "https://anduin.linuxfromscratch.org/BLFS">
|
---|
[a29486e4] | 71 | <!ENTITY sources-anduin-ftp "ftp://anduin.linuxfromscratch.org/BLFS">
|
---|
| 72 |
|
---|
[4a570af1] | 73 | <!ENTITY hints-root "https://www.&lfs-domainname;/hints">
|
---|
[c9aa980] | 74 | <!ENTITY patch-downloads "https://www.linuxfromscratch.org/patches/downloads">
|
---|
[4c0df5c4] | 75 | <!ENTITY patch-root "https://www.&lfs-domainname;/patches/blfs/&patch-version;">
|
---|
[4a570af1] | 76 | <!ENTITY errata "https://www.&lfs-domainname;/blfs/errata/&blfs-version;/">
|
---|
| 77 | <!ENTITY blfs-ticket-root "https://wiki.&lfs-domainname;/blfs/ticket/">
|
---|
[a29486e4] | 78 |
|
---|
[4e88613] | 79 | <!ENTITY lfs-root "../../../../lfs/view/&lfs-version;">
|
---|
[4dcc31a] | 80 | <!ENTITY lfs-dev "../../../../lfs/view/development">
|
---|
[8dfc5c3] | 81 | <!ENTITY gnu-http "https://ftp.gnu.org/gnu">
|
---|
| 82 | <!ENTITY gnu-ftp "ftp://ftp.gnu.org/gnu">
|
---|
| 83 | <!ENTITY gnupg-http "https://www.gnupg.org/ftp/gcrypt">
|
---|
[14d673a2] | 84 | <!ENTITY gnupg-ftp "ftp://ftp.gnupg.org/gcrypt">
|
---|
[122ded1] | 85 | <!ENTITY gstreamer-dl "https://gstreamer.freedesktop.org/src">
|
---|
[8dfc5c3] | 86 | <!ENTITY kernel-dl "https://www.kernel.org/pub">
|
---|
| 87 | <!ENTITY mozilla-http "https://archive.mozilla.org/pub">
|
---|
[8d0bc761] | 88 | <!ENTITY mozilla-hg "https://hg.mozilla.org/releases/mozilla-release/archive/">
|
---|
[a206343] | 89 | <!ENTITY perl_authors "https://www.cpan.org/authors">
|
---|
| 90 | <!ENTITY metacpan_authors "https://cpan.metacpan.org/authors/id">
|
---|
[8dfc5c3] | 91 | <!ENTITY pymodules-dl "https://files.pythonhosted.org/packages/source">
|
---|
| 92 | <!ENTITY sourceforge-dl "https://downloads.sourceforge.net">
|
---|
| 93 |
|
---|
[340486e] | 94 | <!ENTITY gentoo-ftp-repo "ftp://ftp.mirrorservice.org/sites/distfiles.gentoo.org/distfiles">
|
---|
[98e2adf] | 95 | <!ENTITY fedora-http-repo "http://pkgs.fedoraproject.org/repo/pkgs">
|
---|
[faf325d] | 96 | <!ENTITY jaist-ftp-repo "ftp://ftp.jaist.ac.jp/pub//sourceforge">
|
---|
[458e839c] | 97 | <!ENTITY lxqt-http-repo "http://downloads.lxqt.org/lxqt">
|
---|
[4e88613] | 98 | <!ENTITY publisher "Unknown">
|
---|
[e622c0b] | 99 | <!ENTITY xorg-download-http "https://www.x.org/pub/individual">
|
---|
[2f4014b] | 100 | <!ENTITY xorg-download-ftp "ftp://ftp.x.org/pub/individual">
|
---|
[e5f33088] | 101 | <!ENTITY pypi "https://pypi.python.org/pypi">
|
---|
[827ba01c] | 102 | <!ENTITY appstream-glib-url "http://people.freedesktop.org/~hughsient/appstream-glib/releases">
|
---|
[7d5122e6] | 103 | <!ENTITY elinks-url "http://elinks.or.cz">
|
---|
[1eac9eb] | 104 | <!ENTITY w3m-url "http://w3m.sourceforge.net/">
|
---|
[4122007] | 105 |
|
---|
[62dc76c] | 106 | <!-- Convenience entities -->
|
---|
| 107 | <!ENTITY root "<systemitem class='username'>root</systemitem>">
|
---|
| 108 |
|
---|
| 109 |
|
---|
[55fb7f56] | 110 | <!-- These entities are used to identify versions of LFS
|
---|
[db808f2] | 111 | packages referenced throughout the BLFS book. -->
|
---|
[efc60908] | 112 |
|
---|
[46dfbe3] | 113 | <!-- FIXME - please check the included version of
|
---|
| 114 | List/Utils when upgrading the perl version.
|
---|
| 115 | Scalar-List-Utils is in perl-deps because List-AllUtils
|
---|
| 116 | needs a newer version at runtime than is in 5.34.0 -->
|
---|
[aea82bb2] | 117 | <!ENTITY lfs-perl-version "5.34"> <!-- used in git -->
|
---|
[efc60908] | 118 |
|
---|
[55fb7f56] | 119 | <!-- End LFS versions -->
|
---|
[4122007] | 120 |
|
---|
[14736e0d] | 121 | <!ENTITY blfs-bootscripts-version "20220506">
|
---|
[c24a112a] | 122 | <!ENTITY systemd-units-version "20220506">
|
---|
[f852e706] | 123 |
|
---|
[4a570af1] | 124 | <!ENTITY blfs-wiki "https://wiki.&lfs-domainname;/blfs/wiki">
|
---|
[d53eb0e] | 125 |
|
---|
[b5a2067] | 126 | <!-- These entities are used to annotate the current status of a package as it
|
---|
| 127 | relates to the version of LFS it will build/work against -->
|
---|
[2db87f5] | 128 |
|
---|
[5354fe2] | 129 | <!--<!ENTITY lfs111_checked "<para>This package is known to build and work
|
---|
| 130 | properly using an LFS-11.1 platform.</para>">-->
|
---|
| 131 | <!ENTITY lfs111_checked "<note><para>Development versions of BLFS may not build or run
|
---|
| 132 | some packages properly if dependencies have been updated
|
---|
| 133 | since the most recent stable versions of the book.</para></note>">
|
---|
[f44ab56] | 134 | <!--
|
---|
[96428de] | 135 | <!ENTITY lfs110a_built "<para>This package is known to build using an LFS
|
---|
[b2f38b60] | 136 | 11.0 platform but has not been tested.</para>">
|
---|
[f44ab56] | 137 | -->
|
---|
[b5a2067] | 138 | <!-- End special entities about LFS compatibility -->
|
---|
| 139 |
|
---|
[ba58642] | 140 | <!ENTITY as_root "<note><para>When installing multiple packages in a script,
|
---|
| 141 | the installation needs to be done as the root user. There are three general
|
---|
| 142 | options that can be used to do this:</para>
|
---|
| 143 |
|
---|
| 144 | <orderedlist>
|
---|
| 145 |
|
---|
| 146 | <listitem><para>Run the entire script as the root user (not
|
---|
| 147 | recommended).</para></listitem>
|
---|
| 148 |
|
---|
| 149 | <listitem><para>Use the <command>sudo</command> command from the <xref
|
---|
| 150 | linkend='sudo'/> package.</para></listitem>
|
---|
| 151 |
|
---|
| 152 | <listitem><para>Use <command>su -c "command arguments"</command>
|
---|
| 153 | (quotes required) which will ask for the root password for every iteration
|
---|
[0d7900a] | 154 | of the loop.</para></listitem>
|
---|
| 155 |
|
---|
[ba58642] | 156 | </orderedlist>
|
---|
| 157 |
|
---|
| 158 | <para>One way to handle this situation is to create a short
|
---|
| 159 | <command>bash</command> function that automatically selects the appropriate
|
---|
| 160 | method. Once the command is set in the environment, it does not need to be
|
---|
| 161 | set again.</para>
|
---|
[0d7900a] | 162 |
|
---|
[ba58642] | 163 | <screen><userinput>as_root()
|
---|
| 164 | {
|
---|
| 165 | if [ $EUID = 0 ]; then $*
|
---|
| 166 | elif [ -x /usr/bin/sudo ]; then sudo $*
|
---|
| 167 | else su -c \\"$*\\"
|
---|
[0d7900a] | 168 | fi
|
---|
[ba58642] | 169 | }
|
---|
| 170 |
|
---|
| 171 | export -f as_root</userinput></screen>
|
---|
| 172 | </note>">
|
---|
[33cbd93a] | 173 |
|
---|
[e03aea8] | 174 | <!ENTITY not-katamari "<para>This package is not a part of the Xorg
|
---|
| 175 | katamari and is provided only as a dependency to
|
---|
| 176 | other packages or for testing the completed Xorg
|
---|
| 177 | installation.</para>">
|
---|
[058a3280] | 178 |
|
---|
[13652301] | 179 | <!ENTITY % package-entities SYSTEM "packages.ent">
|
---|
| 180 | %package-entities;
|
---|
[ea20da9] | 181 |
|
---|
[428191d] | 182 | <!ENTITY parallel_issues "<note><para>This package may occasionally fail when
|
---|
| 183 | building with multiple processors. See <xref
|
---|
[ea20da9] | 184 | linkend='parallel-builds'/> for more information.</para></note>">
|
---|
| 185 |
|
---|
[729e458] | 186 | <!ENTITY shell-env "<note><para>If installing in the chroot environment, be
|
---|
| 187 | sure to export the <envar>SHELL</envar> environment
|
---|
| 188 | variable or configuration of the package will
|
---|
| 189 | fail.</para></note>">
|
---|
| 190 |
|
---|