* bug#11565: delayed init variables don't get documentation properties @ 2012-05-26 22:29 Glenn Morris 2012-05-27 13:00 ` Stefan Monnier 0 siblings, 1 reply; 5+ messages in thread From: Glenn Morris @ 2012-05-26 22:29 UTC (permalink / raw) To: 11565 Package: emacs Version: 24.1.50 Current trunk: emacs -Q C-h v Info-default-directory-list -> Not documented as a variable. The doc string is in the DOC file though. I think this is because: 1) it's a preloaded defcustom using custom-initialize-delay 2) custom-initialize-delay keeps variables unbound until they are initialized. There's a comment about this in the source: "This seemed to be at least as good as setting it to an arbitrary value like nil". 3) Snarf-documentation (semi-recently; bug#11036) ignores unbound variables, on the assumption that they are for other platforms (eg w32-specific). I guess either we undo 3), or change 2) so that it sets the variable to nil. The latter seems ok to me ...? ^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#11565: delayed init variables don't get documentation properties 2012-05-26 22:29 bug#11565: delayed init variables don't get documentation properties Glenn Morris @ 2012-05-27 13:00 ` Stefan Monnier 2012-05-28 19:53 ` Glenn Morris 0 siblings, 1 reply; 5+ messages in thread From: Stefan Monnier @ 2012-05-27 13:00 UTC (permalink / raw) To: Glenn Morris; +Cc: 11565 > I guess either we undo 3), or change 2) so that it sets the variable to > nil. The latter seems ok to me ...? Undoing the var-part of 3 sounds fine to me. Stefan ^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#11565: delayed init variables don't get documentation properties 2012-05-27 13:00 ` Stefan Monnier @ 2012-05-28 19:53 ` Glenn Morris 2012-05-28 19:56 ` Glenn Morris 2012-05-28 20:27 ` Stefan Monnier 0 siblings, 2 replies; 5+ messages in thread From: Glenn Morris @ 2012-05-28 19:53 UTC (permalink / raw) To: Stefan Monnier; +Cc: 11565 Stefan Monnier wrote: >> I guess either we undo 3), or change 2) so that it sets the variable to >> nil. The latter seems ok to me ...? > > Undoing the var-part of 3 sounds fine to me. There's a downside to doing that, in that bug#11036 will be reopened. What's the downside to making custom-initialize-delay temporarily bind variables to nil? Another option: Snarf-documentation to check if variables are bound, or members of custom-delayed-init-variables. ^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#11565: delayed init variables don't get documentation properties 2012-05-28 19:53 ` Glenn Morris @ 2012-05-28 19:56 ` Glenn Morris 2012-05-28 20:27 ` Stefan Monnier 1 sibling, 0 replies; 5+ messages in thread From: Glenn Morris @ 2012-05-28 19:56 UTC (permalink / raw) To: Stefan Monnier; +Cc: 11565 PS this issue will presumably go away if you go through with http://lists.gnu.org/archive/html/emacs-devel/2012-05/msg00474.html and stop keeping the docs of preloaded lisp files in DOC. ^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#11565: delayed init variables don't get documentation properties 2012-05-28 19:53 ` Glenn Morris 2012-05-28 19:56 ` Glenn Morris @ 2012-05-28 20:27 ` Stefan Monnier 1 sibling, 0 replies; 5+ messages in thread From: Stefan Monnier @ 2012-05-28 20:27 UTC (permalink / raw) To: Glenn Morris; +Cc: 11565 >>> I guess either we undo 3), or change 2) so that it sets the variable to >>> nil. The latter seems ok to me ...? >> Undoing the var-part of 3 sounds fine to me. > There's a downside to doing that, in that bug#11036 will be reopened. It doesn't strike me as a serious problem. > What's the downside to making custom-initialize-delay temporarily bind > variables to nil? The downside is that I don't know the consequences ;-) > Another option: Snarf-documentation to check if variables are bound, or > members of custom-delayed-init-variables. Yuck. > PS this issue will presumably go away if you go through with > http://lists.gnu.org/archive/html/emacs-devel/2012-05/msg00474.html That's likely to happen, indeed. Stefan ^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2012-05-28 20:27 UTC | newest] Thread overview: 5+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2012-05-26 22:29 bug#11565: delayed init variables don't get documentation properties Glenn Morris 2012-05-27 13:00 ` Stefan Monnier 2012-05-28 19:53 ` Glenn Morris 2012-05-28 19:56 ` Glenn Morris 2012-05-28 20:27 ` Stefan Monnier
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).