* C-h v problem on Emacs trunk on Mac OS X
@ 2011-02-20 4:12 Ben Key
2011-02-20 7:48 ` Ben Key
0 siblings, 1 reply; 4+ messages in thread
From: Ben Key @ 2011-02-20 4:12 UTC (permalink / raw
To: Emacs-devel
[-- Attachment #1: Type: text/plain, Size: 938 bytes --]
I am using Emacs 24.0.50.2 built from revision 103358 of the Emacs trunk on
Mac OS X. When I do a C-h v <var-name> I sometimes get output that includes
the line "Not documented as a variable" where the variable documentation
ordinarily would be. For example, C-h v cursor-type displays the following.
cursor-type's value is t
Automatically becomes buffer-local when set in any fashion.
Documentation:
Not documented as a variable.
This is not the only variable that has this problem. I get the same results
for emacs-basic-display and I have seen several others. However, for some
variables, such as emacs-version, I do not see this problem.
In Emacs 23.2, I do not see this problem.
I started Emacs with the -Q command line argument to make certain that the
cause was not in my initialization files.
Does anyone have any ideas what might be causing this problem or should I
just start debugging Emacs to look for the cause?
[-- Attachment #2: Type: text/html, Size: 1068 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: C-h v problem on Emacs trunk on Mac OS X
2011-02-20 4:12 C-h v problem on Emacs trunk on Mac OS X Ben Key
@ 2011-02-20 7:48 ` Ben Key
2011-02-21 10:08 ` Ben Key
0 siblings, 1 reply; 4+ messages in thread
From: Ben Key @ 2011-02-20 7:48 UTC (permalink / raw
To: Emacs-devel
[-- Attachment #1: Type: text/plain, Size: 429 bytes --]
Hello,
I have begun looking into this problem. So far I have learned that the
documentation is generated by the make-docfile tool. I have also learned
that the cursor-type variable is defined in buffer.c. As a test I ran
make-docfile
against buffer.c and looked at the output. The documentation of the
cursor-type variable was not included in the output.
I will begin looking into this problem with make-docfile tomorrow.
[-- Attachment #2: Type: text/html, Size: 520 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: C-h v problem on Emacs trunk on Mac OS X
2011-02-20 7:48 ` Ben Key
@ 2011-02-21 10:08 ` Ben Key
2011-02-21 18:03 ` Chong Yidong
0 siblings, 1 reply; 4+ messages in thread
From: Ben Key @ 2011-02-21 10:08 UTC (permalink / raw
To: Emacs-devel
[-- Attachment #1: Type: text/plain, Size: 852 bytes --]
Hello,
I have some more information on the cause of this bug. It turns out that it
is an unintended consequence of the recent BVAR and KVAR changes. The
parser used be make-docfile is very simplistic. It assumes that when it
sees a DEFVAR_PER_BUFFER it can start looking for the documentation after 2
commas. This assumption is no longer valid because of the added comma in
the usage of the BVAR macro.
The following patch appears to fix this problem.
<patch>
=== modified file 'lib-src/make-docfile.c'
--- lib-src/make-docfile.c 2011-02-09 00:30:33 +0000
+++ lib-src/make-docfile.c 2011-02-21 09:39:03 +0000
@@ -815,7 +815,7 @@
if (defunflag)
commas = 5;
else if (defvarperbufferflag)
- commas = 2;
+ commas = 3;
else if (defvarflag)
commas = 1;
else /* For DEFSIMPLE and DEFPRED */
</patch>
[-- Attachment #2: Type: text/html, Size: 975 bytes --]
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: C-h v problem on Emacs trunk on Mac OS X
2011-02-21 10:08 ` Ben Key
@ 2011-02-21 18:03 ` Chong Yidong
0 siblings, 0 replies; 4+ messages in thread
From: Chong Yidong @ 2011-02-21 18:03 UTC (permalink / raw
To: Ben Key; +Cc: Emacs-devel
Ben Key <bkey76@gmail.com> writes:
> I have some more information on the cause of this bug. It turns out
> that it is an unintended consequence of the recent BVAR and KVAR
> changes. The parser used be make-docfile is very simplistic. It
> assumes that when it sees a DEFVAR_PER_BUFFER it can start looking for
> the documentation after 2 commas. This assumption is no longer valid
> because of the added comma in the usage of the BVAR macro.
>
> The following patch appears to fix this problem.
Thanks; committed.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2011-02-21 18:03 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-02-20 4:12 C-h v problem on Emacs trunk on Mac OS X Ben Key
2011-02-20 7:48 ` Ben Key
2011-02-21 10:08 ` Ben Key
2011-02-21 18:03 ` Chong Yidong
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.