[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Question about intended behavior of 'insert-for-yank-1'.
From: |
Karl Fogel |
Subject: |
Re: Question about intended behavior of 'insert-for-yank-1'. |
Date: |
Sun, 02 Oct 2016 19:53:45 -0500 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) |
This is done now (commit 8cd975ceb). Drew, thanks for pointing out bug #286; I
took care of that doc issue in the same commit.
I can't (re)close the bug, because it was closed earlier as "wontfix" and it
now says "Bug is archived. No further changes may be made." However, I agree
with your reasoning in the bug report, and infer similar agreement from others'
responses in this mailing list thread.
Best regards,
-Karl
Drew Adams <address@hidden> writes:
>> >> Thanks, Eli. Yes, that's true, but note that the doc string for
>> >> `insert-for-yank' just refers the reader to `insert-for-yank-1' for
>> >> details. The only doc string where the STRING-passing behavior is
>> >> discussed is the doc string of `insert-for-yank-1', and that doc
>> >> string indicates, or strongly implies, that the entirety of STRING
>> >> is passed (which it isn't).
>> >
>> >Ah, so this is about the doc string of insert-for-yank, not its
>> >subroutine.
>>
>> I think that's fair, yes. It's about the combination of the two doc
>> strings: right now, the `insert-for-yank' doc string just refers the
>> reader to `insert-for-yank-1' for all the interesting stuff. If your
>> point is that solving this documentation bug involves changing the
>> documentation of `insert-for-yank' more than that of `insert-for-yank-1'
>> (and that the latter might not changing at all), that makes sense, and I
>> thank you for pointing out the real source of the problem.
>>
>> >I agree that the doc string of insert-for-yank should describe what it
>> >does. What it says now hardly qualifies as documentation, and
>> >referring to an internal subroutine for that is, shall we say,
>> >suboptimal ;-)
>>
>> Really, stepping back from the trees to see the forest, that should have
>> been my first reaction :-).
>>
>> >Feel free to improve the doc string of insert-for-yank.
>>
>> Will do.
>>
>> While I don't see any outright errors in the doc string of `insert-for-
>> yank-1', IMHO it should more clearly document that STRING is the default
>> argument to FUNCTION, so I may also fix that.
>
>Bell ringing...
>
>http://debbugs.gnu.org/cgi/bugreport.cgi?bug=286
- Re: Question about intended behavior of 'insert-for-yank-1'.,
Karl Fogel <=
- Re: Question about intended behavior of 'insert-for-yank-1'., Noam Postavsky, 2016/10/02
- Re: Question about intended behavior of 'insert-for-yank-1'., Eli Zaretskii, 2016/10/03
- Re: Question about intended behavior of 'insert-for-yank-1'., Karl Fogel, 2016/10/03
- Re: Question about intended behavior of 'insert-for-yank-1'., Eli Zaretskii, 2016/10/04
- Re: Question about intended behavior of 'insert-for-yank-1'., Karl Fogel, 2016/10/04
- Re: Question about intended behavior of 'insert-for-yank-1'., Eli Zaretskii, 2016/10/04
- Re: Question about intended behavior of 'insert-for-yank-1'., Davis Herring, 2016/10/04
- Re: Question about intended behavior of 'insert-for-yank-1'., Karl Fogel, 2016/10/04