-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathgeneral.ent
274 lines (232 loc) · 11.2 KB
/
general.ent
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
<!-- Editing up to the line of ==== should be enough
to generate a book for development, release, or rc.
Change these for the stable release.-->
<!ENTITY % relyear "2025">
<!ENTITY % reldate "January 17th, 2025">
<!ENTITY % relpubdate "2025-01-17">
<!-- ================================================================== -->
<!-- Do not change anything below except xlfs-version unless the www or
book layouts change -->
<!-- Automatically generated by git-version.sh. -->
<!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">
<!ENTITY patch-version "svn">
]]>
<![ %systemd; [
<!ENTITY lfs-version "systemd">
<!ENTITY blfs-version "systemd">
<!ENTITY patch-version "svn">
]]>
]]><!-- End %development -->
<!ENTITY mlfs-stable "ed42deb91fd03befb9988ed346a9b580d057e8cc">
<![ %release; [
<!ENTITY xlfs-version "12.2">
<![ %sysv; [
<!ENTITY lfs-version "&xlfs-version;">
<!ENTITY blfs-version "&xlfs-version;">
<!ENTITY patch-version "&xlfs-version;">
]]>
<![ %systemd; [
<!ENTITY lfs-version "&xlfs-version;-systemd">
<!ENTITY blfs-version "&xlfs-version;-systemd">
<!ENTITY patch-version "&xlfs-version;">
]]>
<!ENTITY year "%relyear;">
<!ENTITY releasedate "%reldate;">
<!ENTITY pubdate "%relpubdate;">
]]><!-- End %release -->
<!ENTITY copyrightdate "2024-&year;">
<!ENTITY copyholder "The GLFS Development Team">
<!ENTITY lfs-domainname "linuxfromscratch.org">
<!ENTITY glfs-domainname "glfs-book.github.io">
<!ENTITY maintainer-fullname "The GLFS Team">
<!ENTITY maintainer-firstname "GLFS">
<!ENTITY maintainer-address "[email protected];">
<!ENTITY lfs-website "https://www.&lfs-domainname;">
<!ENTITY glfs-website "https://&glfs-domainname;/glfs">
<!-- downloads_root must have an entity because it is needed for scripts
Note: s/_/-/ in comment to avoid grep error
It is also needed for systemd units
-->
<!ENTITY downloads-root "&lfs-website;/blfs/downloads/&blfs-version;">
<!--<!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 "&glfs-website;/patches">
<!ENTITY errata "https://www.&lfs-domainname;/blfs/errata/&blfs-version;/">
<!ENTITY blfs-ticket-root "https://wiki.&lfs-domainname;/blfs/ticket/">
<!ENTITY lfs-root "&lfs-website;/lfs/view/&lfs-version;">
<!ENTITY lfs-ml-root "&lfs-website;/~thomas/multilib-m32">
<!ENTITY lfs-dev "../../../../lfs/view/development">
<!ENTITY lfs-ticket-root "https://wiki.&lfs-domainname;/lfs/ticket/">
<!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 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/">
<!ENTITY sysprof-url "https://wiki.gnome.org/Apps/Sysprof">
<!ENTITY man "https://man.archlinux.org/man/">
<!ENTITY glfs-repo "https://github.com/glfs-book/glfs">
<!ENTITY glfs-issues "&glfs-repo;/issues">
<!ENTITY glfs-pull "&glfs-repo;/pull">
<!-- Convenience entities -->
<!ENTITY root "<systemitem class='username'>root</systemitem>">
<!ENTITY gi-docgen-url "https://gnome.pages.gitlab.gnome.org/gi-docgen/">
<!-- These entities are used to identify versions of LFS
packages referenced throughout the BLFS book. -->
<!ENTITY lfs-perl-version "5.40"> <!-- used in git -->
<!-- End LFS versions -->
<!ENTITY blfs-bootscripts-version "20240209">
<!ENTITY systemd-units-version "20240205">
<!ENTITY blfs-wiki "https://wiki.&lfs-domainname;/blfs/wiki">
<!ENTITY blfs-svn "https://&lfs-domainname;/blfs/view/&blfs-version;">
<![ %development; [
<!ENTITY important-stability "<para>
This book is in a constant flux of updates, including packages and can
be akin to the BLFS Git version. Right now, there is no stable
version of GLFS rendered online, but you can render it yourself by following
<ulink url='&glfs-repo;'/>. This may cause problems when you wish to continue
onto BLFS. Sometimes, packages in this book will have newer versions than
even BLFS development pages. It is recommended to remember what versions of
packages you have on your system because of this. Expect build failures
at some point, although we try to limit that possibility.
</para>">
]]>
<![ %release; [
<!ENTITY important-stability "<para>
This is the stable release of this book and is known to have working
instructions. External links will point to stable sources. However, links
that point to MLFS is problematic as MLFS is rolling release, not stable,
so information there may be ahead of the results that appear from this
book, and instructions in the newer version of the book may lead to broken
instructions in this one. However, in <xref linkend='achievingml'/>, it will
show you how to render a stable release of MLFS.
</para>">
]]>
<![ %development; [
<!ENTITY multilib-rendering1 " ">
<![ %sysv; [
<!ENTITY multilib-rendering2 "<para>
You can render the book yourself if you wish:
</para>
<screen><userinput>git clone https://git.linuxfromscratch.org/lfs.git mlfs &&
git checkout multilib &&
make -j1 ARCH=ml_32</userinput></screen>
<para>
The rendered files will be in
<filename class='directory'>~/public_html/lfs-book</filename>.
</para>">
]]>
<![ %systemd; [
<!ENTITY multilib-rendering2 " ">
]]>
]]>
<![ %release; [
<![ %sysv; [
<!ENTITY multilib-rendering1 "<para>
The links above, however, are rolling release and are rendered frequently.
The known version of MLFS to work with this version of GLFS is
&mlfs-stable;. You can render it by following the instructions below:
</para>">
<!ENTITY multilib-rendering2 "<screen><userinput>git clone https://git.linuxfromscratch.org/lfs.git mlfs-stable &&
git checkout multilib &&
git checkout &mlfs-stable; &&
make -j1 ARCH=ml_32</userinput></screen>
<para>
The rendered files will be in
<filename class='directory'>~/public_html/lfs-book</filename>.
</para>">
]]>
<![ %systemd; [
<!ENTITY multilib-rendering1 " ">
<!ENTITY multilib-rendering2 "<para>
Now switch to the stable git hash:
</para>
<screen><userinput>git checkout &mlfs-stable;</userinput></screen>">
]]>
]]>
<!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
sudo package.</para></listitem>
<listitem><para>Use <command>su -c "command arguments"</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 \\"$*\\"
fi
}
export -f as_root</userinput></screen>
</note>">
<!ENTITY not-katamari "<para>This package is provided 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>">
<!ENTITY gi-doc-disable
"Allow building this package without <xref linkend='gi-docgen'/>
installed. If you have <xref linkend='gi-docgen'/> installed and
you wish to rebuild and install the API documentation, a
<command>meson configure</command> command will reset this
option.">
<!ENTITY build-use-internet
"<note><para>An Internet connection is needed for building this
package.</para></note>">
<!ENTITY test-use-internet
"<note><para>An Internet connection is needed for some tests of
this package.</para></note>">
<!ENTITY logind
"<phrase revision='sysv'><xref linkend='elogind'/></phrase>
<phrase revision='systemd'><xref linkend='systemd'/></phrase>">
<!ENTITY qt5-deps
"(<xref linkend='qt5'/> or <xref role='nodep' linkend='qt5-alternate'/>)">
<!ENTITY build-wheel-cmd "pip3 wheel -w dist --no-build-isolation --no-deps --no-cache-dir">
<!ENTITY build-wheel "<screen><userinput>&build-wheel-cmd; $PWD</userinput></screen>">
<!ENTITY install-wheel "pip3 install --no-index --find-links=dist --no-cache-dir --no-user">
<!ENTITY berkeley-db "<ulink url='https://anduin.linuxfromscratch.org/BLFS/bdb/db-5.3.28.tar.gz'>Berkeley DB</ulink> (deprecated)">
<!ENTITY gobject-introspection "<xref linkend='glib2'/> (with GObject Introspection)">