[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Small docstring improvements
From: |
John Wiegley |
Subject: |
Re: Small docstring improvements |
Date: |
Fri, 19 Aug 2016 12:34:40 -0700 |
User-agent: |
Gnus/5.130014 (Ma Gnus v0.14) Emacs/25.1 (darwin) |
>>>>> "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
Re: Small docstring improvements, Dmitry Gutov, 2016/08/19
Re: Small docstring improvements, Eli Zaretskii, 2016/08/20