At 2023-03-15T13:04:29+0100, Alejandro Colomar wrote:
> > off-topic for Alex:
> > As we're talking about libc here, what about the libc.7 patch?
> > Is there any progress regarding it?
>
> I guess you refer to the patch set by Branden that touched
> ldconfig(8), libc(7), and a some more? I guess Branden is busy
> with his own stuff (releasing groff-1.23.0). Probably after the
> release we'll see some updated patches.
That's about the size of it.
This is what I have queued up to submit after I review Alex's feedback.
(Some of these I haven't submitted at all yet, I think.) Also I haven't
rebased lately, so my view of origin/master may be stale.
commit 06a104b5be1ac103f9858a7a898284fea2137a7b (HEAD -> master)
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Fri Jan 6 01:48:55 2023 -0600
intro.3: srcfix (hyphenation control)
Protect man page cross reference from hyphenation. (This will not be
necessary upon migration to groff 1.23's `MR` macro.)
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit a997ee7d2936e1c5e3f61a9218b02118dbae9a52
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Wed Jan 4 01:16:17 2023 -0600
intro.3: Revise discussion
* Recast introduction to discuss the purpose of section 3 as a whole
instead of focussing solely on the standard C library.
* Provide historical context for usage of subsections in section 3.
Resurrect information from comments, in rewritten form, of section 3
subsections, so as to contrast them with the current approach
developed by Alex. Be even more emphatic that those documenting other
C libraries should not mess with subsections.
* Explain basic principles of usage of any C library to the novice.
(This page _is_ called "intro".)
* Drop material about organization of glibc, now moved to libc(7).
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit 8a5bc95aba96c409b74f7128f9a9b30b34dc976e
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Thu Jan 5 16:37:20 2023 -0600
intro.3: wfix
* Tighten cross reference. It wastes words to tell people to look
elsewhere "for further information". Why else would they look there?
* Use passive voice less.
* Relocate sentence for more coherent discussion.
* Say "application _programming_ interface".
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit 5619f1fff3457a5f0d67c983b76fb329eaae7b92
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Tue Jan 3 01:06:55 2023 -0600
libc.7: Revise content
* Define the term "standard C library".
* Say who's responsible for standardizing it.
* Practically all C _libraries_ use libc, too.
* Move material describing structure glibc from intro(3) to here and
recast in more detail.
* Update example filespec for libc.so.6.
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit f9c89fd1697f3354f570a93814665d2b665ffdad
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Thu Jan 5 16:34:39 2023 -0600
libc.7: wfix
* Say "GNU/Linux distributions" instead of "Linux distributions".
* Clarify claim about popularity of glibc.
* Tighten wording.
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit 12a26baf73d984d1c2c3075246aa64b7a5162348
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Fri Jan 6 01:44:20 2023 -0600
ldconfig.8: Revise and update for glibc 2.32
* Recast summary description to identify relevance of libraries.
* Drop `-V` option from synopsis; it doesn't make any sense combined
with the operation mode shown, and no other "get out quick" option,
including its synonym `--version`, is documented in the synopsis.
* Clarify that the "links" manipulated by the program are symbolic.
* Discuss caching feature separately from symbolic link management.
* Clarify how ldconfig can be run by unprivileged users (probably for
troubleshooting).
* Recast example of shared library linkage chain and motivate the
existence for each link or file. Define term "soname" and present it
in lowercase like other Linux man-pages, instead of full caps.
* Document auxiliary cache file, which apparently has been described
nowhere but a source comment in the original commit 15 years ago.
* Document that `-C` implies `-i`. See elf/ldconfig.c:162.
* Clarify how `-l` option works (a little).
* Drop mention of "quiet mode", which does not seem to exist.
* Be explicit that `-p`/`--print-cache` option exits early; i.e., it
doesn't undertake ldconfig's primary function.
* Document `--usage` and `-?`/`--help` options.
* Clarify what `-v`/`--verbose` does.
* Clarify that `-V`/`--version` exits early.
* Expand description of "ld.so.conf" file to discuss "include" and
"hwcap" features. Describe these as "directives" (though the latter
died upstream in glibc 2.32 before we got around to documenting it).
Document ld.so.conf's comment syntax.
* Document handling of leading spaces and empty lines in ld.so.conf.
* Document location of auxiliary cache file.
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit afc8fa5eebd36de2d8a372873a781abebaddf996
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Sun Jan 8 16:20:29 2023 -0600
adjtimex.2: Drop dead hyperlink.
"UNIX and Scientific Computing Services Pages
The information that was previously in this area is out of date.
Please refer to the SCS Confluence Page or contact unix-admin."
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit 0b8b5b30064ecd9d2398f6389cac27683051fb19
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Sun Jan 8 15:49:21 2023 -0600
localedef.1: ffix
* Protect literals from hyphenation.
* Specify break points in lengthy file names.
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit 3e3272e211c2ac1a628dce272b14c1b61e7c03c4
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Sun Jan 8 15:37:24 2023 -0600
localedef.1: ffix
Spell metasyntactic variables as hyphenated noun phrases.
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit 9da1c0128b4f0d3ce18434fb3fae633e208cd0c9
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Sun Jan 8 15:36:02 2023 -0600
localedef.1: ffix
Spell ellipsis such that it will render better on typesetters.
Use unadjustable space \~ instead of quoted space at the boundary of a
macro argument, for readability.
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit d8e77e33049230f27a45f1040fcfec847bfae64b
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Sun Jan 8 15:34:19 2023 -0600
localedef.1: ffix
Use typographer's quotation marks.
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit 64e88fdd36ab6fb9cae6d0671962cbfe54a92c1c
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Sat Jan 7 03:36:35 2023 -0600
signal.2, utf-8.7: srcfix
Use `IP` macro instead of `TP` for paragraph tags with no semantic
value.
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit c423b1bd51992a2316d4812624c0392638665d49
Author: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Date: Wed Feb 15 09:08:02 2023 -0600
memcmp.3: Recast security caveat
Use terminology more carefully.
* Refer to the info sec property of confidentiality instead of saying,
vaguely, "security-critical".
https://informationsecurity.wustl.edu/items/\
confidentiality-integrity-and-availability-the-cia-triad/
* Try not to confuse anyone who's studied the analysis of algorithms:
don't say "constant time" when "deterministic time" is meant. The
time to perform the memory comparison remains linear (O(n)), not
constant (O(1)).
* Tighten wording.
Signed-off-by: G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
commit 88163675125a0facf3709eea30239734119d2459 (origin/master, origin/HEAD)
[snip]
Regards,
Branden
Attachment:
signature.asc
Description: PGP signature
