* bug#1144: 23.0.60; No doc string for `symbol-at-point' and other, similar functions @ 2008-10-11 21:56 ` Drew Adams 2008-10-22 21:00 ` bug#1144: marked as done (23.0.60; No doc string for `symbol-at-point' and other, similar functions) Emacs bug Tracking System [not found] ` <handler.1144.D1144.12247086444763.notifdone@emacsbugs.donarmstrong.com> 0 siblings, 2 replies; 6+ messages in thread From: Drew Adams @ 2008-10-11 21:56 UTC (permalink / raw) To: emacs-pretest-bug Subject line says it all. Please add doc strings. Particularly for `symbol-at-point', which returns a symbol, not a string. In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-10-03 on LENNART-69DE564 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include -fno-crossjumping' ^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#1144: marked as done (23.0.60; No doc string for `symbol-at-point' and other, similar functions) 2008-10-11 21:56 ` bug#1144: 23.0.60; No doc string for `symbol-at-point' and other, similar functions Drew Adams @ 2008-10-22 21:00 ` Emacs bug Tracking System [not found] ` <handler.1144.D1144.12247086444763.notifdone@emacsbugs.donarmstrong.com> 1 sibling, 0 replies; 6+ messages in thread From: Emacs bug Tracking System @ 2008-10-22 21:00 UTC (permalink / raw) To: Chong Yidong [-- Attachment #1: Type: text/plain, Size: 908 bytes --] Your message dated Wed, 22 Oct 2008 16:50:43 -0400 with message-id <87ljwgbbh8.fsf@cyd.mit.edu> and subject line Re: 23.0.60; No doc string for `symbol-at-point' and other, similar functions has caused the Emacs bug report #1144, regarding 23.0.60; No doc string for `symbol-at-point' and other, similar functions to be marked as done. This means that you claim that the problem has been dealt with. If this is not the case it is now your responsibility to reopen the bug report if necessary, and/or fix the problem forthwith. (NB: If you are a system administrator and have no idea what this message is talking about, this may indicate a serious mail system misconfiguration somewhere. Please contact don@donarmstrong.com immediately.) -- 1144: http://emacsbugs.donarmstrong.com/cgi-bin/bugreport.cgi?bug=1144 Emacs Bug Tracking System Contact don@donarmstrong.com with problems [-- Attachment #2: Type: message/rfc822, Size: 2915 bytes --] From: "Drew Adams" <drew.adams@oracle.com> To: <emacs-pretest-bug@gnu.org> Subject: 23.0.60; No doc string for `symbol-at-point' and other, similar functions Date: Sat, 11 Oct 2008 14:56:21 -0700 Message-ID: <000e01c92bec$32d29eb0$0200a8c0@us.oracle.com> Subject line says it all. Please add doc strings. Particularly for `symbol-at-point', which returns a symbol, not a string. In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-10-03 on LENNART-69DE564 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include -fno-crossjumping' [-- Attachment #3: Type: message/rfc822, Size: 989 bytes --] From: Chong Yidong <cyd@stupidchicken.com> To: "Drew Adams" <drew.adams@oracle.com> Cc: 1144-done@emacsbugs.donarmstrong.com Subject: Re: 23.0.60; No doc string for `symbol-at-point' and other, similar functions Date: Wed, 22 Oct 2008 16:50:43 -0400 Message-ID: <87ljwgbbh8.fsf@cyd.mit.edu> Done. ^ permalink raw reply [flat|nested] 6+ messages in thread
[parent not found: <handler.1144.D1144.12247086444763.notifdone@emacsbugs.donarmstrong.com>]
* bug#1144: closed by Chong Yidong <cyd@stupidchicken.com> (Re: 23.0.60; No doc string for `symbol-at-point' and other, similar functions) [not found] ` <handler.1144.D1144.12247086444763.notifdone@emacsbugs.donarmstrong.com> @ 2009-04-06 6:24 ` Drew Adams 2011-07-07 17:05 ` Lars Magne Ingebrigtsen 0 siblings, 1 reply; 6+ messages in thread From: Drew Adams @ 2009-04-06 6:24 UTC (permalink / raw) To: 1144 Trying again, after trying to unarchive. > -----Original Message----- > From: Drew Adams Sent: Sunday, April 05, 2009 8:37 PM > > Must I send a separate bug for each such function? I thought > when your complete response was "Done" that you had taken > care of all such functions. > > The following functions are all in the same boat. They are > all functions for which users will want to see the doc. > > beginning-of-thing > end-of-thing > in-string-p > end-of-sexp > beginning-of-sexp > thing-at-point-bounds-of-url-at-point > forward-whitespace > forward-symbol > forward-same-syntax > word-at-point > sentence-at-point > form-at-point ^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#1144: closed by Chong Yidong <cyd@stupidchicken.com> (Re: 23.0.60; No doc string for `symbol-at-point' and other, similar functions) 2009-04-06 6:24 ` bug#1144: closed by Chong Yidong <cyd@stupidchicken.com> (Re: 23.0.60; " Drew Adams @ 2011-07-07 17:05 ` Lars Magne Ingebrigtsen 2011-07-07 17:30 ` Drew Adams 2011-07-07 18:32 ` Chong Yidong 0 siblings, 2 replies; 6+ messages in thread From: Lars Magne Ingebrigtsen @ 2011-07-07 17:05 UTC (permalink / raw) To: Drew Adams; +Cc: 1144 "Drew Adams" <drew.adams@oracle.com> writes: > Trying again, after trying to unarchive. > >> -----Original Message----- >> From: Drew Adams Sent: Sunday, April 05, 2009 8:37 PM >> >> Must I send a separate bug for each such function? I thought >> when your complete response was "Done" that you had taken >> care of all such functions. >> >> The following functions are all in the same boat. They are >> all functions for which users will want to see the doc. >> >> beginning-of-thing >> end-of-thing >> in-string-p >> end-of-sexp >> beginning-of-sexp >> thing-at-point-bounds-of-url-at-point >> forward-whitespace >> forward-symbol >> forward-same-syntax >> word-at-point >> sentence-at-point >> form-at-point No, Chong added documentation to the autoloaded, "external" functions, but not the purely internal thingatpt functions. And I think that's the right decision. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ ^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#1144: closed by Chong Yidong <cyd@stupidchicken.com> (Re: 23.0.60; No doc string for `symbol-at-point' and other, similar functions) 2011-07-07 17:05 ` Lars Magne Ingebrigtsen @ 2011-07-07 17:30 ` Drew Adams 2011-07-07 18:32 ` Chong Yidong 1 sibling, 0 replies; 6+ messages in thread From: Drew Adams @ 2011-07-07 17:30 UTC (permalink / raw) To: 'Lars Magne Ingebrigtsen'; +Cc: 1144 > >> Must I send a separate bug for each such function? I thought > >> when your complete response was "Done" that you had taken > >> care of all such functions. > >> > >> The following functions are all in the same boat. They are > >> all functions for which users will want to see the doc. > >> > >> beginning-of-thing > >> end-of-thing > >> in-string-p > >> end-of-sexp > >> beginning-of-sexp > >> thing-at-point-bounds-of-url-at-point > >> forward-whitespace > >> forward-symbol > >> forward-same-syntax > >> word-at-point > >> sentence-at-point > >> form-at-point > > No, Chong added documentation to the autoloaded, "external" functions, > but not the purely internal thingatpt functions. And I think > that's the right decision. No, it's not the right thing. Emacs users include Emacs-Lisp users. Users of thingatpt.el, in particular, are mainly Emacs-Lisp users. Whether to document something has nothing to do with whether it is a command or is autoloaded. That is, those predicates do not at all suffice to determine whether something should be documented. And for Emacs there really is no such thing as an "internal" function. Yes, we need not document every function or variable, and yes, some functions and variables we generally do not expect users to fiddle with. But Emacs is 100% open, and it should document itself, as originally intended. ^ permalink raw reply [flat|nested] 6+ messages in thread
* bug#1144: closed by Chong Yidong <cyd@stupidchicken.com> (Re: 23.0.60; No doc string for `symbol-at-point' and other, similar functions) 2011-07-07 17:05 ` Lars Magne Ingebrigtsen 2011-07-07 17:30 ` Drew Adams @ 2011-07-07 18:32 ` Chong Yidong 1 sibling, 0 replies; 6+ messages in thread From: Chong Yidong @ 2011-07-07 18:32 UTC (permalink / raw) To: Lars Magne Ingebrigtsen; +Cc: 1144 Lars Magne Ingebrigtsen <larsi@gnus.org> writes: >>> The following functions are all in the same boat. They are all >>> functions for which users will want to see the doc. I added the other doc strings. Closing again. ^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2011-07-07 18:32 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
[not found] <87ljwgbbh8.fsf@cyd.mit.edu>
2008-10-11 21:56 ` bug#1144: 23.0.60; No doc string for `symbol-at-point' and other, similar functions Drew Adams
2008-10-22 21:00 ` bug#1144: marked as done (23.0.60; No doc string for `symbol-at-point' and other, similar functions) Emacs bug Tracking System
[not found] ` <handler.1144.D1144.12247086444763.notifdone@emacsbugs.donarmstrong.com>
2009-04-06 6:24 ` bug#1144: closed by Chong Yidong <cyd@stupidchicken.com> (Re: 23.0.60; " Drew Adams
2011-07-07 17:05 ` Lars Magne Ingebrigtsen
2011-07-07 17:30 ` Drew Adams
2011-07-07 18:32 ` Chong Yidong
Code repositories for project(s) associated with this public inbox https://git.savannah.gnu.org/cgit/emacs.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).