Re: GNU Coding Standards tools

[Eric Blake]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

According to Ralf Wildenhues on 11/9/2008 12:44 PM:
> Hi ERic,
> 
> * Eric Blake wrote on Fri, Nov 07, 2008 at 10:09:15PM CET:
>> I'm thinking of adding the following patch, so that all of the tools
>> mentioned in GNU Coding Standards at least have a mention (our manual
>> mentions more tools than GNU Coding Standards requires, but without
>> this patch, it doesn't provide complete coverage).  We can add known
>> portability problems later.  Thoughts?
> 
> Only non-serious ones.

Applied, with the following tweak:

> 
>> address@hidden @command{read}
>> address@hidden -----------------
>> address@hidden @command{read}
>> +Not all shells support @option{-r} (Solaris @command{/bin/sh} for example).
> 
> How about the stronger: No options are portable, not even @option{-r} ...,
> so readers of bash help are helped.  :-)

This was just moving existing text, but I like the improved wording, so I
changed it.

>> address@hidden @command{sleep}
>> address@hidden ------------------
>> address@hidden @command{sleep}
>> +Using @command{sleep} is generally portable.  However, remember that
>> +adding a @command{sleep} to work around timestamp issues, with a minimum
>> +granularity of one second, doesn't scale well for parallel builds on
>> +modern machines with sub-second process completion.
> 
> But you can use '-j20' to work around this issue.  :-)

I didn't see the point of rewording anything here; -j20 comes with its own
set of problems on Makefiles that aren't topologically complete when it
comes to dependencies.  :-)

- --
Don't work too hard, make some time for fun as well!

Eric Blake             address@hidden
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Public key at home.comcast.net/~ericblake/eblake.gpg
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkkYQ4UACgkQ84KuGfSFAYC2iACffh2R0bfb7fGvcFjLuGSnX8PI
JGcAn2dso83Oe6ngb1guqxhTHjPnRp2t
=TNXd
-----END PGP SIGNATURE-----