Commit Graph

710 Commits

Author SHA1 Message Date
David Bryant
75d64be391 Improve English idiom. Use the indicative mood. 2022-12-09 14:27:24 -06:00
Xi Ruoyao
02912947e8
perl: use "MAJOR.MINOR" instead of "Major.Minor", and explain "patch level"
We are already using "MAJOR" and "MINOR" in OpenSSL, do the same here.

The semantic versioning documentation (https://semver.org/) always use
"patch level", not "Patch level".  But let's explain it a little to
prevent puzzling people.
2022-12-09 16:05:26 +08:00
Xi Ruoyao
4640b37d96
ninja: style "ninja" (for the program) with <command>
Or the mix up of "ninja" and "Ninja" will seem puzzling...
2022-12-09 15:40:14 +08:00
Xi Ruoyao
30f5283fab
python: style "libffi.so" correctly 2022-12-09 15:38:15 +08:00
Xi Ruoyao
3c07bb9488
libtool: libldtl is for dynamic loading, not dynamic linking
On wikipedia, "dlopen" redirects to "dynamic loading" and there is a
specific warning:

"Dynamically loaded library" redirects here. Not to be confused with
dynamically linked library.
2022-12-09 15:35:05 +08:00
David Bryant
a3ebe8aa2b Corrected capitalization of the package name. This was hard to do
because some references appear to refer to the program itself, and
not to the package. Corrected English idiom here and there.
2022-12-08 17:23:07 -06:00
David Bryant
d9883060de Capitalized references to the package. Clarified the descriptions of
pip3 -- the pip program processes both commands (e.g., install) and
options (e.g., --no-index). Expressed option / command descriptions
in the iindicative mood. The imperative mood should only be used to
tell the reader what to do, not in explanatory verbiage. Inserted
the definite article here and there. Corrected a misspelled instance
of the indefinite article: we don't say "an utility" because the
initial phoneme in "utility" is pronounced as YOO.
2022-12-08 15:13:28 -06:00
David Bryant
8e751f7319 Added an explanation. Python is a language. python3 is a program.
Inserted the definite article where idiom requires it. Added more
detail to an option description. Broke an extremely long paragraph
into three pieces; cleaned up English idiom and punctuation all the
way through this section. In "Short  Descriptions", inserted periods
where appropriate, and clarified the description of python3, which
is a program, not a language.
2022-12-07 12:54:04 -06:00
David Bryant
e9c46b31c7 Add more details to the descriptiion of what this package does.
Correct capitalizatiom throughout, and tweak English idiom.
2022-12-07 11:10:58 -06:00
David Bryant
8f10e6fa49 Patch up English idiom here and there. 2022-12-06 14:56:58 -06:00
David Bryant
5042efcc2f Fix a grammatical error (subject / verb number). Improve English idiom. 2022-12-06 14:45:38 -06:00
David Bryant
67dfc3b371 Revert a previous change; -des is actually three options, -d, -e, & -s.
Thanks to Pierre for pointing this out.
2022-12-06 14:07:23 -06:00
David Bryant
8199f8e631 Removed some circomlocutions. Made "option" singular; "des" only
appears once. Improved idiom ("as shown below"). "command line" is
two words; "front end" is two words. "Swiss Army" is a trademark;
it should be caputalized.
2022-12-06 12:55:34 -06:00
David Bryant
ee65db4626 Fix a grammatical error (subject and verb must agree in number) and
improve English idiom.
2022-12-06 11:59:03 -06:00
David Bryant
7c263b6db0 Clean up capitalization. Improve English idiom. Use the present
perfect tense when appropriate. Replace "dlopening" with "opening
dynamically linked libraries" ... "dlopen" may be a Linux command,
but that doesn't make it a verb in English.
2022-12-06 11:33:02 -06:00
David Bryant
79ac947fda Correct capitalization. Correct spellig: "test suite" is two words.
Use the personal relative pronoun "who" when referring to a person.
2022-12-06 11:04:37 -06:00
David Bryant
9aff8c4523 Corrected capitalization and modified some descriptions of libraries,
for consistency of style.
2022-12-06 10:27:41 -06:00
Bruce Dubbs
38311c3ea3 Merge branch 'trunk' of git.linuxfromscratch.org:lfs into trunk 2022-12-01 17:41:14 -06:00
Bruce Dubbs
82e98d0b0e Package updates.
Update to iana-etc-20221122.
Update to xz-5.2.9.
Update to tzdata-2022g.
Update to texinfo-7.0.1.
Update to tcl-8.6.13.
Update to meson-0.64.1.
Update to linux-6.0.10.
Update to gawk-5.2.1.
2022-12-01 17:40:16 -06:00
Pierre Labastie
aea16f699e Sync shadow "rounds" parameter to blfs
Otherwise, As Xi has noticed, the password set for root at the end
of lfs may use the value 5000 for rounds, and not be changed, even
if later the number of rounds is increased.
2022-11-25 09:30:45 +01:00
Xi Ruoyao
9a23a75c5d
Revert "shadow: add spaces around &mdash;"
This reverts commit 0298c764d8.

We don't use spaces around &mdash anywhere else in the book.
2022-11-23 11:18:29 +08:00
David Bryant
30f3041a7d Rewrote a cumbersome sentence to make it clearer. Capitalized the
names of packages. Clarified verbiage in re PIE & ASLR. Improved the
description of SSP, and tightened it up. Clarified the instructions
for running tests concurrently. Modified descriptions of tests that
fail. Patched up punctuation. Spelled "set up" correctly: "setup" is
a noun. The phrasal verb used here is spelled as two words. Use the
word "directives" to describe "#include" and similar preprocessor
instructions. Add periods to some otherwise complete sentences.
2022-11-22 16:19:04 -06:00
Bruce Dubbs
66d32d7e29 word choice 2022-11-22 15:19:47 -06:00
Xi Ruoyao
a66cd7f020
shadow: update desc of libsubid
I was using the transitive verb "process" here, not the noun.  Use
another word to avoid the ambiguity.  Also add "and groups" because
there is also subgid alongside subuid.
2022-11-23 01:21:39 +08:00
Xi Ruoyao
0298c764d8
shadow: add spaces around &mdash;
IMO it makes the rendering prettier.
2022-11-23 01:04:04 +08:00
Xi Ruoyao
9af3d7f77d
shadow: fix (clarify?) the consequence of missing "users" group
To me "has been created" is not correct.  Or maybe it's some advanced
usage of English I don't understand...
2022-11-23 00:59:43 +08:00
Xi Ruoyao
26e3001b7f
coreutils: update test failure
sort-NaN-infloop no longer fails now, it seems covered up by PIE or SSP.

test-getlogin keeps failing in Bruce's build.  Not sure how to reproduce
the failure deterministically.
2022-11-22 23:31:52 +08:00
Xi Ruoyao
e3187f4895
wheel: build the wheel archive of wheel itself
This avoids running "python3 setup.py install" (indirectly), which may
not work correctly in the future with Python 3.12.
2022-11-22 18:24:26 +08:00
David Bryant
54948b710c Straighten out capitalization, correct a few grammatical errors,
improve English idiom, clarify a few things, remove superfluous
verbiage, etc.
2022-11-21 16:13:06 -06:00
David Bryant
651f491b51 Merrriam-Webster says "alongside" is one word. Clarified some muddled
verbiage. Used the subjunctive mood once. "Test suite" is two words, not
one. Patched some unidiomatic English. Used the plural "headers" when
discussing ELF objects. Used singular verbs to describe "gprofng", for
consistency with other items.
2022-11-18 15:43:45 -06:00
David Bryant
d6346a7e9b Rectify a redundancy/explain how to say tcl. Use correct spelling for
the Binutils package. Patch up an ungrammatical sentence (the plural
subject "instructions" requires pural verbs).
2022-11-18 14:44:18 -06:00
David Bryant
ea90fca7bf Clarify the description of the -G option. 2022-11-18 13:14:57 -06:00
David Bryant
cc197d00ce Corrected a grammatical error: the subordinate clause "that offers ..."
modifies the plural noun "libraries"; it must use a plural verb.
Clarified how many "configure" options Readline uses. Tightened the
prose, and used the definite article in lieu of the indefinite article,
because only one readline.pc file can possibly be the "correct" one.
2022-11-18 12:35:53 -06:00
Xi Ruoyao
7115c88406
chapter08: fix minor grammar issues 2022-11-18 14:29:26 +08:00
Xi Ruoyao
f8b1860631
pkgmgt: reword the description of cfg files handling
Let's not miss the point...
2022-11-18 14:13:12 +08:00
Xi Ruoyao
b1c8283fe7
chapter08: reword description of compiler optimizations
We don't recommend customizing optimizations, but we use optimizations
provided by package default or release build mode.

Reword the paragraph so the people won't be puzzled once they see
"--enable-optimizations" in Python, or "--buildtype=release" (to prevent
unoptimized build) in BLFS meson commands.
2022-11-18 13:57:47 +08:00
Xi Ruoyao
1cc301fbb3
glibc: Decapitalize nsswitch.conf
In UNIX file names are case-sensitive.  You cannot capitialize it even if
it appears in a title.
2022-11-18 13:25:38 +08:00
Xi Ruoyao
7054cc64ea
glibc: it should be --disable-werror, not --disable-Werror
Please try not to use the "replace" feature of the text editor blindly.

Appendix C of the GNU C Library Reference Manual clearly says:

'--disable-werror'
     By default, the GNU C Library is built with '-Werror'.  If you wish
     to build without this option (for example, if building with a newer
     version of GCC than this version of the GNU C Library was tested
     with, so new warnings cause the build with '-Werror' to fail), you
     can configure with '--disable-werror'.
2022-11-18 12:11:04 +08:00
David Bryant
27601131e4 Correctd the spelling of "Werror" -- it's "-Werror" in GCC, but
it's "--disable-error" in Glibc. Thanks to Thomas Trepl for spotting
my mistake.
2022-11-17 16:14:42 -06:00
David Bryant
091d624df5 Correct capitalization, spelling, grammar, and idiom. Tighten the
prose by removing some circumlocutions.
2022-11-17 12:08:13 -06:00
Pierre Labastie
f2dff2db69 Shadow: /usr/include/shadow is an installed dir 2022-11-16 17:46:26 +01:00
Thomas Trepl (Moody)
b9721fd7f0 Fix type (replace a / by a \ as line continue maker) 2022-11-16 08:46:22 +01:00
Bruce Dubbs
89c3f71df2 Tidy up some spacing issues 2022-11-15 00:31:18 -06:00
Bruce Dubbs
9292384bac Package updates and a fix.
Fix make-4.4 bug.
Update to wheel-0.38.4 (Python Module).
Update to texinfo-7.0.
Update to sysvinit-3.05.
Update to shadow-4.13.
Update to sed-4.9.
Update to meson-0.64.0.
Update to linux-6.0.7.
Update to elfutils-0.188.
Update to bc-6.1.1.
2022-11-11 09:44:13 -06:00
Xi Ruoyao
5156c40031
systemd: fix and simply the command to disable systemd-sysupdate
"systemd disable" seems a typo...

And we don't need the ".timer" suffix because these .service units are
tied to the .timer units.
2022-11-04 10:42:03 +08:00
Douglas R. Reno
172185a9f7 Update to systemd-252. 2022-11-03 14:33:43 -05:00
Xi Ruoyao
2c8cb1743e
grub: copy the "no tuning" warning from BLFS
It's reported that a GRUB build with CFLAGS=-O2 is broken.
2022-11-03 10:02:44 +08:00
Xi Ruoyao
d45f50d26d
glibc: fix parallel build issue with make-4.4
We only need a one-line change in upstream fix (because we don't use
"make --shuffle").  Add it as a sed for both Chapter 5 and Chapter 8.

Note that the "minimal" sed would be '/MAEKFLAGS :=/s/r/ -r/'.  I
included an additional ')' so it won't modify "-r" again to "- -r".

Tested "make" and "make check" on a x86_64 with -j8 and an arm64 with
-j24.

Link: https://sourceware.org/git/?p=glibc.git;a=commit;h=2d7ed98add14
2022-11-01 11:05:05 +08:00
Bruce Dubbs
3f4304998a Package updates.
Update to iana-etc-20221025.
Update to tzdata-2022f.
Update to Python3-3.11.0.
Update to procps-ng-4.0.1.
Update to man-pages-6.01.
Update to man-db-2.11.0.
Update to make-4.4.
Update to linux-6.0.6.
Update to libffi-3.4.4.
Update to inetutils-2.4.
Update to expat-2.5.0.

Note: I had to run glibc in Chapter 8 at -j1 to avoid an apparant race
condition.  With a little more investigation I may be able to find a
better solution.
2022-10-31 18:42:52 -05:00
Xi Ruoyao
347bbda9c1
man-pages: update the number of provided pages for 6.00
$ find -name '*.[0-9]' | wc -l
2438
2022-10-18 17:15:51 +08:00