Re: Small docstring improvements

[John Wiegley]

>>>>> "PS" == Philipp Stephani <address@hidden> writes:

PS> +START and END are normally buffer positions specifying the part of the
PS> +buffer to send to the process.
PS> +If START is nil, that means to use the entire buffer contents; END is
PS> +ignored.

I would phrase a little differently:

    +If START and END are both buffer positions, they specify the region
    +to send to the process.
    +If START is nil, it means to use the entire buffer contents; END is
    +ignored.

PS> +If START is a string, then send that string to the process +instead of
PS> any buffer contents; END is ignored.

This is a horrible abuse. There should be another function
`call-process-with-string'.

I don't like the way that "START" has three separate meanings, only one of
which has anything to do with beginning a START of something.

-- 
John Wiegley                  GPG fingerprint = 4710 CF98 AF9B 327B B80F
http://newartisans.com                          60E1 46C4 BD1A 7AC1 4BA2