Date: Sun, 28 Aug 2005 20:40:18 GMT From: "Julien Gabel" <jpeg@thilelli.net> To: freebsd-doc@FreeBSD.org Subject: Re: docs/85353: Very little cosmetic/ponctuation changes for the GEOM (geom-striping) chapter of the Handbook. Message-ID: <200508282040.j7SKeI5V012665@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/85353; it has been noted by GNATS.
From: "Julien Gabel" <jpeg@thilelli.net>
To: "Gary W. Swearingen" <garys@opusnet.com>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/85353: Very little cosmetic/ponctuation changes for the
GEOM (geom-striping) chapter of the Handbook.
Date: Sun, 28 Aug 2005 22:30:17 +0200 (CEST)
------=_20050828223017_58689
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: 8bit
>>> <para>The following command can be used to manually mount a newly
>>> - created disk stripe.</para>
>>> + created disk stripe:</para>
>> It's probably not worth changing, but I find "the following" to be
>> redundant in sentences that ends with ":".
> Agreed.
>> In decreasing order of verbosity:
>>
>> The following command can be used to manually mount a newly created
>> disk stripe.
>>
>> This command can be used to manually mount a newly created disk stripe:
>>
>> To manually mount a newly created disk stripe:
> This one may be better i think, since it is more concise.
>> And while opinions differ, IMO, it should be "newly-created".
> Don't have a preference about this one.
Ok. I reworked a little bit this one, trying to adapt it to what
was said. In the same time, try to avoid the repeated words like
"following" and "created".
Please find a new patch attached.
--
-jpeg.
------=_20050828223017_58689
Content-Type: application/octet-stream; name="chapter.sgml.diff"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="chapter.sgml.diff"
LS0tIC91c3IvZG9jL2VuX1VTLklTTzg4NTktMS9ib29rcy9oYW5kYm9vay9nZW9tL2NoYXB0ZXIu
c2dtbAlTdW4gQXVnIDI4IDIxOjQ4OjU1IDIwMDUKKysrIC91L2pnYWJlbC90bXAvZ2VvbS9jaGFw
dGVyLnNnbWwJU3VuIEF1ZyAyOCAyMjowOToyNCAyMDA1CkBAIC0xNDgsMjMgKzE0OCwyMiBAQAog
ICAgICAgPHN0ZXA+PHBhcmE+TG9hZCB0aGUgPGZpbGVuYW1lPmdlb21fc3RyaXBlPC9maWxlbmFt
ZT4KICAgICAgICAgbW9kdWxlOjwvcGFyYT4KIAotICAgIDxzY3JlZW4+JnByb21wdC5yb290OyA8
dXNlcmlucHV0PmtsZGxvYWQgZ2VvbV9zdHJpcGUua288L3VzZXJpbnB1dD48L3NjcmVlbj4KKyAg
ICA8c2NyZWVuPiZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5rbGRsb2FkIGdlb21fc3RyaXBlPC91
c2VyaW5wdXQ+PC9zY3JlZW4+CiAJPC9zdGVwPgogCiAgICAgICA8c3RlcD48cGFyYT5FbnN1cmUg
dGhhdCBhIHN1aXRhYmxlIG1vdW50IHBvaW50IGV4aXN0cy4gIElmIHRoaXMKICAgICAgICAgdm9s
dW1lIHdpbGwgYmVjb21lIGEgcm9vdCBwYXJ0aXRpb24sIHRoZW4gdGVtcG9yYXJpbHkgdXNlCiAg
ICAgICAgIGFub3RoZXIgbW91bnQgcG9pbnQgc3VjaCBhcyA8ZmlsZW5hbWUKLSAgICAgICAgcm9s
ZT0iZGlyZWN0b3J5Ij4vbW50PC9maWxlbmFtZT4uPC9wYXJhPgorICAgICAgICByb2xlPSJkaXJl
Y3RvcnkiPi9tbnQ8L2ZpbGVuYW1lPjo8L3BhcmE+CiAKICAgICAgICAgPHNjcmVlbj4mcHJvbXB0
LnJvb3Q7IDx1c2VyaW5wdXQ+bWtkaXIgL21udDwvdXNlcmlucHV0Pjwvc2NyZWVuPgogICAgICAg
PC9zdGVwPgogCiAgICAgICA8c3RlcD48cGFyYT5EZXRlcm1pbmUgdGhlIGRldmljZSBuYW1lcyBm
b3IgdGhlIGRpc2tzIHdoaWNoIHdpbGwKICAgICAgICAgYmUgc3RyaXBlZCwgYW5kIGNyZWF0ZSB0
aGUgbmV3IHN0cmlwZSBkZXZpY2UuICBGb3IgZXhhbXBsZSwKLSAgICAgICAgdGhlIGZvbGxvd2lu
ZyBjb21tYW5kIGNvdWxkIGJlIHVzZWQgdG8gc3RyaXBlIHR3byB1bnVzZWQsCi0gICAgICAgIHVu
cGFydGl0aW9uZWQgPGFjcm9ueW0+QVRBPC9hY3JvbnltPiBkaXNrczoKLSAgICAgICAgPGZpbGVu
YW1lPi9kZXYvYWQyPC9maWxlbmFtZT4gYW5kCi0gICAgICAgIDxmaWxlbmFtZT4vZGV2L2FkMzwv
ZmlsZW5hbWU+LjwvcGFyYT4KKyAgICAgICAgdG8gc3RyaXBlIHR3byB1bnVzZWQgYW5kIHVucGFy
dGl0aW9uZWQgPGFjcm9ueW0+QVRBPC9hY3JvbnltPiBkaXNrcywKKyAgICAgICAgZm9yIGV4YW1w
bGUgPGZpbGVuYW1lPi9kZXYvYWQyPC9maWxlbmFtZT4gYW5kCisgICAgICAgIDxmaWxlbmFtZT4v
ZGV2L2FkMzwvZmlsZW5hbWU+OjwvcGFyYT4KIAogICAgICAgICA8c2NyZWVuPiZwcm9tcHQucm9v
dDsgPHVzZXJpbnB1dD5nc3RyaXBlIGxhYmVsIC12IHN0MCAvZGV2L2FkMiAvZGV2L2FkMzwvdXNl
cmlucHV0Pjwvc2NyZWVuPgogCkBAIC0xNzYsMTQgKzE3NSwxNSBAQAogICAgICAgPC9zdGVwPgog
CiAgICAgICA8c3RlcD48cGFyYT5JZiB0aGlzIHZvbHVtZSB3aWxsIGJlIHVzZWQgYXMgYSByb290
IGRldmljZSBmb3IKLSAgICAgICAgYm9vdGluZyB0aGUgc3lzdGVtLCB0aGVuIHRoZSBmb2xsb3dp
bmcgY29tbWFuZCBtdXN0IGJlIGlzc3VlZAotICAgICAgICBiZWZvcmUgdGhlIGZpbGUgc3lzdGVt
IGlzIGNyZWF0ZWQ6PC9wYXJhPgorICAgICAgICBib290aW5nIHRoZSBzeXN0ZW0sIGRvbid0IGZv
cmdldCB0byBpbml0aWFsaXplIGl0IGVudGlyZWx5CisgICAgICAgIGJlZm9yZSBjcmVhdGluZyB0
aGUgZmlsZSBzeXN0ZW06PC9wYXJhPgogCiAgICAgICAgIDxzY3JlZW4+JnByb21wdC5yb290OyA8
dXNlcmlucHV0PmZkaXNrIC12QkkgL2Rldi9zdHJpcGUvc3QwPC91c2VyaW5wdXQ+PC9zY3JlZW4+
CiAgICAgICA8L3N0ZXA+CiAKLSAgICAgIDxzdGVwPjxwYXJhPkEgcGFydGl0aW9uIHRhYmxlIG11
c3QgYmUgY3JlYXRlZCBvbiB0aGUgbmV3IHZvbHVtZQotICAgICAgICB3aXRoIHRoZSBmb2xsb3dp
bmcgY29tbWFuZDo8L3BhcmE+CisgICAgICA8c3RlcD48cGFyYT5Xcml0ZSBhIHN0YW5kYXJkIGxh
YmVsIChhbHNvIGtub3duIGFzIGEgcGFydGl0aW9uCisgICAgICAgIHRhYmxlKSBvbiB0aGUgbmV3
IHZvbHVtZSwgYXMgd2VsbCBhcyBpbnN0YWxsaW5nIHRoZSBkZWZhdWx0CisgICAgICAgIGJvb3Rz
dHJhcCBjb2RlOjwvcGFyYT4KIAogICAgICAgICA8c2NyZWVuPiZwcm9tcHQucm9vdDsgPHVzZXJp
bnB1dD5ic2RsYWJlbCAtd0IgL2Rldi9zdHJpcGUvc3QwPC91c2VyaW5wdXQ+PC9zY3JlZW4+CiAK
QEAgLTE5MywyMCArMTkzLDE5IEBACiAgICAgICAgIGluIHRoZSA8ZmlsZW5hbWUgcm9sZT0iZGly
ZWN0b3J5Ij4vZGV2L3N0cmlwZTwvZmlsZW5hbWU+CiAgICAgICAgIGRpcmVjdG9yeSBpbiBhZGRp
dGlvbiB0byB0aGUgPGZpbGVuYW1lPnN0MDwvZmlsZW5hbWU+IGRldmljZS4KICAgICAgICAgVGhv
c2UgaW5jbHVkZSA8ZmlsZW5hbWU+c3QwYTwvZmlsZW5hbWU+IGFuZAotICAgICAgICA8ZmlsZW5h
bWU+c3QwYzwvZmlsZW5hbWU+LiAgQSBmaWxlIHN5c3RlbSBtdXN0IG5vdyBiZSBjcmVhdGVkCi0g
ICAgICAgIG9uIHRoZSA8ZmlsZW5hbWU+c3QwYTwvZmlsZW5hbWU+IGRldmljZSB1c2luZyB0aGUg
Zm9sbG93aW5nCi0gICAgICAgIDxjb21tYW5kPm5ld2ZzPC9jb21tYW5kPiBjb21tYW5kOjwvcGFy
YT4KKyAgICAgICAgPGZpbGVuYW1lPnN0MGM8L2ZpbGVuYW1lPi4gIEEgZmlsZSBzeXN0ZW0gY2Fu
IG5vdyBiZSBjcmVhdGVkCisgICAgICAgIG9uIHRoZSA8ZmlsZW5hbWU+c3QwYTwvZmlsZW5hbWU+
IGRldmljZSB1c2luZyB0aGUKKyAgICAgICAgPGNvbW1hbmQ+bmV3ZnM8L2NvbW1hbmQ+IHV0aWxp
dHk6PC9wYXJhPgogCiAgICAgICA8c2NyZWVuPiZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5uZXdm
cyAtVSAvZGV2L3N0cmlwZS9zdDBhPC91c2VyaW5wdXQ+PC9zY3JlZW4+CiAKICAgICAgIDxwYXJh
Pk1hbnkgbnVtYmVycyB3aWxsIGdsaWRlIGFjcm9zcyB0aGUgc2NyZWVuLCBhbmQgYWZ0ZXIgYSBm
ZXcKICAgICAgICAgc2Vjb25kcywgdGhlIHByb2Nlc3Mgd2lsbCBiZSBjb21wbGV0ZS4gIFRoZSB2
b2x1bWUgaGFzIGJlZW4KLSAgICAgICAgY3JlYXRlZCBhbmQgaXMgcmVhZHkgdG8gYmUgbW91bnRl
ZDo8L3BhcmE+CisgICAgICAgIGNyZWF0ZWQgYW5kIGlzIHJlYWR5IHRvIGJlIG1vdW50ZWQuPC9w
YXJhPgogICAgIDwvc3RlcD4KICAgPC9wcm9jZWR1cmU+CiAKLSAgPHBhcmE+VGhlIGZvbGxvd2lu
ZyBjb21tYW5kIGNhbiBiZSB1c2VkIHRvIG1hbnVhbGx5IG1vdW50IGEgbmV3bHkKLSAgICBjcmVh
dGVkIGRpc2sgc3RyaXBlLjwvcGFyYT4KKyAgPHBhcmE+VG8gbWFudWFsbHkgbW91bnQgYSBuZXds
eS1jcmVhdGVkIGRpc2sgc3RyaXBlOjwvcGFyYT4KIAogICA8c2NyZWVuPiZwcm9tcHQucm9vdDsg
PHVzZXJpbnB1dD5tb3VudCAvZGV2L3N0cmlwZS9zdDBhIC9tbnQ8L3VzZXJpbnB1dD48L3NjcmVl
bj4KIApAQCAtMjE5LDcgKzIxOCw3IEBACiAKICAgPHBhcmE+VGhlIGdlb20gbW9kdWxlIG11c3Qg
YWxzbyBiZSBhdXRvbWF0aWNhbGx5IGxvYWRlZCBkdXJpbmcKICAgICBzeXN0ZW0gaW5pdGlhbGl6
YXRpb24sIGJ5IGFkZGluZyBhIGxpbmUgdG8KLSAgICA8ZmlsZW5hbWU+L2Jvb3QvbG9hZGVyLmNv
bmY8L2ZpbGVuYW1lPi48L3BhcmE+CisgICAgPGZpbGVuYW1lPi9ib290L2xvYWRlci5jb25mPC9m
aWxlbmFtZT46PC9wYXJhPgogCiAgIDxzY3JlZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0PmVj
aG8gJ2dlb21fc3RyaXBlX2xvYWQ9IllFUyInICZndDsmZ3Q7IC9ib290L2xvYWRlci5jb25mPC91
c2VyaW5wdXQ+PC9zY3JlZW4+CiAKQEAgLTI4Myw3ICsyODIsNyBAQAogICAgIDxzY3JlZW4+JnBy
b21wdC5yb290OyA8dXNlcmlucHV0Pmdlb20gbG9hZDwvdXNlcmlucHV0Pjwvc2NyZWVuPgogCiAg
ICAgPHBhcmE+SW5zdGFsbCBnZW5lcmljIDxjb21tYW5kPmZkaXNrPC9jb21tYW5kPiBsYWJlbCBh
bmQgYm9vdCBjb2RlCi0gICAgICB0byBuZXdseSBjcmVhdGVkIDxmaWxlbmFtZT5nbTA8L2ZpbGVu
YW1lPiBkZXZpY2U6PC9wYXJhPgorICAgICAgdG8gdGhlIG5ldyA8ZmlsZW5hbWU+Z20wPC9maWxl
bmFtZT4gZGV2aWNlOjwvcGFyYT4KIAogICAgIDxzY3JlZW4+JnByb21wdC5yb290OyA8dXNlcmlu
cHV0PmZkaXNrIC12QkkgL2Rldi9taXJyb3IvZ20wPC91c2VyaW5wdXQ+PC9zY3JlZW4+CiAKQEAg
LTI5OCw4ICsyOTcsOCBAQAogCXRoZSBzbGljZSBhbmQgcGFydGl0aW9uIHNpemUgb2YgdGhlIG90
aGVyIGRpc2suPC9wYXJhPgogICAgIDwvbm90ZT4KIAotICAgIDxwYXJhPlVzZSB0aGUgJm1hbi5u
ZXdmcy44OyB1dGlsaXR5IHRvIGNyZWF0ZSBhIGRlZmF1bHQgZmlsZQotICAgICAgc3lzdGVtIG9u
IHRoZSA8ZmlsZW5hbWU+Z20wczFhPC9maWxlbmFtZT4gZGV2aWNlIG5vZGU6PC9wYXJhPgorICAg
IDxwYXJhPlVzZSB0aGUgJm1hbi5uZXdmcy44OyB1dGlsaXR5IHRvIGNvbnN0cnVjdCBhIGRlZmF1
bHQgPGFjcm9ueW0+VUZTPC9hY3JvbnltPgorICAgICAgZmlsZSBzeXN0ZW0gb24gdGhlIDxmaWxl
bmFtZT5nbTBzMWE8L2ZpbGVuYW1lPiBkZXZpY2Ugbm9kZTo8L3BhcmE+CiAKICAgICA8c2NyZWVu
PiZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5uZXdmcyAtVSAvZGV2L21pcnJvci9nbTBzMWE8L3Vz
ZXJpbnB1dD48L3NjcmVlbj4KIApAQCAtMzI0LDcgKzMyMyw3IEBACiAKICAgICA8cGFyYT5Ob3cg
ZWRpdCB0aGUgcmVwbGljYXRlZCA8ZmlsZW5hbWU+L21udC9ldGMvZnN0YWI8L2ZpbGVuYW1lPgog
ICAgICAgZmlsZSBhbmQgcmVtb3ZlIG9yIGNvbW1lbnQgb3V0IHRoZSBzd2FwIGZpbGUuICBDaGFu
Z2UgdGhlIG90aGVyCi0gICAgICBmaWxlIHN5c3RlbSBpbmZvcm1hdGlvbiB0byB1c2UgdGhlIG5l
dyBkaXNrLiAgU2VlIHRoZSBmb2xsb3dpbmcKKyAgICAgIGZpbGUgc3lzdGVtIGluZm9ybWF0aW9u
IHRvIHVzZSB0aGUgbmV3IGRpc2ssIGFzIHNob3duIGluIHRoaXMKICAgICAgIGV4YW1wbGU6PC9w
YXJhPgogCiAgICAgPHByb2dyYW1saXN0aW5nPiMgRGV2aWNlICAgICAgICAgICAgICAgIE1vdW50
cG9pbnQgICAgICBGU3R5cGUgIE9wdGlvbnMgICAgICAgICBEdW1wICAgIFBhc3MjCkBAIC0zNDYs
MTUgKzM0NSwxMyBAQAogCW5ldyByb290IHBhcnRpdGlvbiwgYSBmYWlsc2FmZSBpcyBhdmFpbGFi
bGUuPC9wYXJhPgogICAgIDwvbm90ZT4KIAotICAgIDxwYXJhPk5vdyBhZGQgdGhlIGZvbGxvd2lu
ZyBsaW5lIHRvCi0gICAgICA8ZmlsZW5hbWU+L2Jvb3QvbG9hZGVyLmNvbmY6PC9maWxlbmFtZT48
L3BhcmE+CisgICAgPHBhcmE+VGhlbiwgYWRhcHQgdGhlIGNvbnRlbnQgb2YgdGhlIGNvbmZpZ3Vy
dGlvbiBmaWxlCisgICAgICA8ZmlsZW5hbWU+L2Jvb3QvbG9hZGVyLmNvbmY8L2ZpbGVuYW1lPiB0
byBpbnN0cnVjdCAmbWFuLmxvYWRlci44OworICAgICAgdXRpbGl0eSB0byBsb2FkIHRoZSA8Zmls
ZW5hbWU+Z2VvbV9taXJyb3Iua288L2ZpbGVuYW1lPiBkdXJpbmcKKyAgICAgIHN5c3RlbSBpbml0
aWFsaXphdGlvbjo8L3BhcmE+CiAKICAgICA8c2NyZWVuPiZwcm9tcHQucm9vdDsgPHVzZXJpbnB1
dD5lY2hvICdnZW9tX21pcnJvcl9sb2FkPSJZRVMiJyAmZ3Q7Jmd0OyAvYm9vdC9sb2FkZXIuY29u
ZjwvdXNlcmlucHV0Pjwvc2NyZWVuPgogCi0gICAgPHBhcmE+VGhpcyB3aWxsIGluc3RydWN0ICZt
YW4ubG9hZGVyLjg7IHV0aWxpdHkgdG8gbG9hZCB0aGUKLSAgICAgIDxmaWxlbmFtZT5nZW9tX21p
cnJvci5rbzwvZmlsZW5hbWU+IGR1cmluZyBzeXN0ZW0KLSAgICAgIGluaXRpYWxpemF0aW9uLjwv
cGFyYT4KLQogICAgIDxwYXJhPlJlYm9vdCB0aGUgc3lzdGVtOjwvcGFyYT4KIAogICAgIDxzY3Jl
ZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0PnNodXRkb3duIC1yIG5vdzwvdXNlcmlucHV0Pjwv
c2NyZWVuPgpAQCAtMzkyLDcgKzM4OSw3IEBACiAJICBzeXN0ZW0gdG8gYSAmbWFuLmxvYWRlci44
OyBwcm9tcHQuICBMb2FkIHRoZSBrZXJuZWwgbW9kdWxlCiAJICBtYW51YWxseTo8L3BhcmE+CiAK
LQk8c2NyZWVuPk9LPyA8dXNlcmlucHV0PmxvYWQgZ2VvbV9taXJyb3Iua288L3VzZXJpbnB1dD4K
Kwk8c2NyZWVuPk9LPyA8dXNlcmlucHV0PmxvYWQgZ2VvbV9taXJyb3I8L3VzZXJpbnB1dD4KIE9L
PyA8dXNlcmlucHV0PmJvb3Q8L3VzZXJpbnB1dD48L3NjcmVlbj4KIAogCTxwYXJhPklmIHRoaXMg
d29ya3MgdGhlbiBmb3Igd2hhdGV2ZXIgcmVhc29uIHRoZSBtb2R1bGUgd2FzIG5vdAo=
------=_20050828223017_58689--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200508282040.j7SKeI5V012665>