Re: [PATCH] string_copying.7: tfix

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



diff --git a/man7/string_copying.7 b/man7/string_copying.7
index da1fc6752..04426ef77 100644
--- a/man7/string_copying.7
+++ b/man7/string_copying.7
@@ -280,9 +280,9 @@ instead of
 In programs that make considerable use of strings or character sequences,
 and need the best performance,
 using overlapping character sequences can make a big difference.
-It allows holding subsequences of a larger character sequence.
+It allows holding sub-sequences of a larger character sequence,

In this case, man-pages(7) advises to not hyphenate:

I see. I stumbled a little, “subsequences” being similar to “subsequent.” I don’t have a strong opinion.

 while not duplicating memory
-nor using time to do a copy.
+or using time to do a copy.

Is nor incorrect here?

It’s not exactly incorrect here. Such a usage is common; who am I to say that it’s wrong? It’s not useful to use it here, either. The most common use of nor is a neither-nor construction: The weather is neither good nor bad. Not good and not bad. Not either good or bad. Admire the construction’s elegance: two little conjunctions, forming a pair (though a pair it need not be) to give you the anticipated meaning, clear in every word along the way. Though that construction isn’t what’s used here.

Here, compare

	while (not ((duplicating memory) or (using time to do a copy)))

to

	while not duplicating memory nor using time to do a copy

which you might imagine as expanding to

	while not duplicating memory and not using time to do a copy

with imagined precedence as

	while ((not (duplicating memory)) and (not (using time to do a copy)))

where, thus, the word “nor” seems to be split in half. It works. It’s correct. And yet it instills in me a strange feeling of unorderedness.

Your mileage may vary.

I'm not a native English speaker

Neither am I.

and would like to understand why it is incorrect.

@@ -444,8 +444,8 @@ is a more useful alternative to this function.
 .\" ----- DESCRIPTION :: Functions :: zustr2ustp(3) --------------------/
 .TP
 .BR zustr2ustp (3)
-This function copies the input character sequence
-contained in a null-padded wixed-width buffer,
+This function copies the input character sequence,

I believe the below is like a parenthetical, which is why I put it
between commas; isn't it?  Although your version also looks good.

+contained in a null-padded fixed-width buffer,

Ok

 into a destination character sequence.

The “contained in a null-padded fixed-width buffer” indeed looks like a parenthetical (or rather, a non-restrictive participial clause—the “contained” is the participle), which is why it should be between commas. You didn’t do quite that: You put a comma after it, but not before.

This case is what I tried to explain: You set off the “into a destination character sequence” prepositional phrase (the “into” being the preposition) by a comma. You did not surround the participial clause by commas. That’s what I did.



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux