* bug#9876: 24.0.90; doc for `define-derived-mode'
@ 2011-10-26 17:42 Drew Adams
2012-09-17 0:27 ` Drew Adams
2014-02-09 6:04 ` Lars Ingebrigtsen
0 siblings, 2 replies; 3+ messages in thread
From: Drew Adams @ 2011-10-26 17:42 UTC (permalink / raw)
To: 9876
The doc, in both the Elisp manual and the doc string, should say that
parameter NAME corresponds to variable `mode-name'.
Users who define major modes without using `define-derived-mode' will
learn about `mode-name' and understand it when they need it or come in
contact with it. Users who use only `define-derived-mode' are ignorant
of this connection to the variable, unless the doc points it out.
Similarly, for other variables that might be concerned - e.g.,
`major-mode'. Such variables should be mentioned in the doc for `d-d-m'
and the connection made to its parameters.
In GNU Emacs 24.0.90.1 (i386-mingw-nt5.1.2600)
of 2011-10-24 on MARVIN
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.6) --no-opt --cflags
-I"D:/devel/emacs/libs/libXpm-3.5.8/include"
-I"D:/devel/emacs/libs/libXpm-3.5.8/src"
-I"D:/devel/emacs/libs/libpng-dev_1.4.3-1/include"
-I"D:/devel/emacs/libs/zlib-dev_1.2.5-2/include"
-I"D:/devel/emacs/libs/giflib-4.1.4-1/include"
-I"D:/devel/emacs/libs/jpeg-6b-4/include"
-I"D:/devel/emacs/libs/tiff-3.8.2-1/include"
-I"D:/devel/emacs/libs/gnutls-2.10.1/include" --ldflags
-L"D:/devel/emacs/libs/gnutls-2.10.1/lib"'
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#9876: 24.0.90; doc for `define-derived-mode'
2011-10-26 17:42 bug#9876: 24.0.90; doc for `define-derived-mode' Drew Adams
@ 2012-09-17 0:27 ` Drew Adams
2014-02-09 6:04 ` Lars Ingebrigtsen
1 sibling, 0 replies; 3+ messages in thread
From: Drew Adams @ 2012-09-17 0:27 UTC (permalink / raw)
To: 9876
ping
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#9876: 24.0.90; doc for `define-derived-mode'
2011-10-26 17:42 bug#9876: 24.0.90; doc for `define-derived-mode' Drew Adams
2012-09-17 0:27 ` Drew Adams
@ 2014-02-09 6:04 ` Lars Ingebrigtsen
1 sibling, 0 replies; 3+ messages in thread
From: Lars Ingebrigtsen @ 2014-02-09 6:04 UTC (permalink / raw)
To: Drew Adams; +Cc: 9876
"Drew Adams" <drew.adams@oracle.com> writes:
> The doc, in both the Elisp manual and the doc string, should say that
> parameter NAME corresponds to variable `mode-name'.
>
> Users who define major modes without using `define-derived-mode' will
> learn about `mode-name' and understand it when they need it or come in
> contact with it. Users who use only `define-derived-mode' are ignorant
> of this connection to the variable, unless the doc points it out.
>
> Similarly, for other variables that might be concerned - e.g.,
> `major-mode'. Such variables should be mentioned in the doc for `d-d-m'
> and the connection made to its parameters.
I think that just sounds more confusing. The doc looks good to me the
way it is. Closing.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog http://lars.ingebrigtsen.no/
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2014-02-09 6:04 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-10-26 17:42 bug#9876: 24.0.90; doc for `define-derived-mode' Drew Adams
2012-09-17 0:27 ` Drew Adams
2014-02-09 6:04 ` Lars Ingebrigtsen
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.