Re: envsys.4 && sysmon_envsys.9: grammar corrections

[Soren Jacobsen <snj%pobox.com@localhost>]

On Dec 18, 2009, at 6:42 PM, Constantine Aleksandrovich Murenin wrote:

> 2009/12/18 Soren Jacobsen <snj%pobox.com@localhost>:
>> 
>> I've committed them, aside from the "there's" change, which is not an error 
>> but simply an issue of style.  Contractions run wild throughout our tree, so 
>> I don't see any reason to change that particular one.
> 
> Perhaps all "there's" should be changed to "there is" then?

I don't think so.  I certainly wouldn't commit such changes.  Like I said, 
contractions (not just "there's") are all over the place in our documentation.  
Quite a lot of them are informal.  I don't think this is a real problem.  In 
some cases, I think it's even a good thing.  There's only one contraction I'd 
ever want to (but wouldn't actually) ban from the tree, and that is "it's," but 
that's just because people so often use it improperly.

> There's

  ^^^^^^^ ;)

> dale# find share/man -type f | xargs fgrep "there's" && uname -ms

It doesn't make much difference to me whether it's "only 7" or not, but for the 
record, there are more than 7:

./crypto/dist/heimdal/appl/login/login.access.5:If there's a user and a group 
with the same name, there is no way to
./crypto/dist/heimdal/lib/krb5/krb5_config.3:For the default functions, other 
than for the string case, there's no
./crypto/external/bsd/openssl/lib/libcrypto/man/BN_num_bytes.3:there's no real 
guarantee that will match the \*(L"key size\*(R", just a lot
./crypto/external/bsd/openssl/lib/libcrypto/man/openssl_ui.3:there's no 
technical difference between them.  Other methods may make a
./crypto/external/bsd/openssl/lib/libcrypto/man/openssl_x509.3:Finally, there's 
the supertype X509_INFO, which can contain a \s-1CRL\s0, a
./dist/dhcp/client/dhclient-script.8:If more than one interface is being used, 
there's no obvious way to
./dist/dhcp/common/dhcp-eval.5:currently being processed is known - that is, if 
there's a host
./dist/dhcp/server/dhcpd.conf.5:Notice that at the beginning of the file, 
there's a place
./dist/libpcap/pcap.3:capture loop to ``poll'' for user input periodically, as 
there's no
./external/bsd/file/dist/doc/magic.5:# sometimes, the value at 0x18 is less 
that 0x40 but there's still an
./external/bsd/flex/bin/flex.1:input unless there's another quote in the input.
./external/bsd/flex/bin/flex.1:The first few lines tell us that there's a 
scanner state in
./external/bsd/flex/bin/flex.1:The comment regarding State #8 indicates there's 
a problem
./external/bsd/flex/bin/flex.1:The final comment reminds us that there's no 
point going to
./external/bsd/flex/bin/flex.1:since there's no performance gain doing so with 
compressed scanners.
./external/bsd/flex/bin/flex.1:Now, if it's guaranteed that there's exactly one 
word per line,
./external/gpl2/lvm2/dist/man/dmsetup.8:If there's a filesystem on the device 
which supports the operation, 
./gnu/usr.bin/gcc4/cpp/cpp-contrib.1:Currently the command line option takes 
precedence if there's a conflict.
./gnu/usr.bin/gcc4/cpp/cpp.1:Currently the command line option takes precedence 
if there's a conflict.
./gnu/usr.bin/gcc4/gcc/gcc-contrib.1:That is, there's no way to use these 
symbols in portable ISO C or C++ and have all your identifiers in NFC.
./gnu/usr.bin/gcc4/gcc/gcc-contrib.1:Currently the command line option takes 
precedence if there's a conflict.
./gnu/usr.bin/gcc4/gcc/gcc-contrib.1:executable, so there's no real reason to 
use them if you can just run that directly.
./gnu/usr.bin/gcc4/gcc/gcc.1:That is, there's no way to use these symbols in 
portable ISO C or C++ and have all your identifiers in NFC.
./gnu/usr.bin/gcc4/gcc/gcc.1:Currently the command line option takes precedence 
if there's a conflict.
./gnu/usr.bin/gcc4/gcc/gcc.1:executable, so there's no real reason to use them 
if you can just run that directly.
./lib/libc/sys/minherit.2:inheritance, there's no way to figure out how large a 
region is
./libexec/ftpd/ftpd.8:if there's no limit.
./libexec/ftpd/ftpusers.5:If there's a positive match, the session's root 
directory is changed.
./sbin/bioctl/bioctl.8:to start or cease blinking, if there's
./sbin/mount_portal/examples/cvs.1:Note that there's some support for the 
FreeBSD and OpenBSD anoncvs
./usr.bin/lex/flex.1:input unless there's another quote in the input.
./usr.bin/lex/flex.1:The first few lines tell us that there's a scanner state in
./usr.bin/lex/flex.1:The comment regarding State #8 indicates there's a problem
./usr.bin/lex/flex.1:The final comment reminds us that there's no point going to
./usr.bin/lex/flex.1:since there's no performance gain doing so with compressed 
scanners.
./usr.bin/lex/flex.1:Now, if it's guaranteed that there's exactly one word per 
line,
./usr.sbin/envstat/envstat.8:This flag is provided for compatibility reasons 
and there's no need
./usr.sbin/powerd/powerd.8:When this event is received there's no much time so 
you should only
./usr.sbin/sa/sa.8:that there's not much logic behind their lettering.

Soren