* bug#3503: 23.0.94; Emacs manual, main menu typo
@ 2009-06-08 22:39 Drew Adams
2009-06-08 23:02 ` Drew Adams
2011-07-11 16:32 ` Lars Magne Ingebrigtsen
0 siblings, 2 replies; 7+ messages in thread
From: Drew Adams @ 2009-06-08 22:39 UTC (permalink / raw
To: emacs-pretest-bug
emacs -Q
C-h r
``region'' in the main menu should be just region - or possibly
"region", if you consider that this somehow defines a region (which I
don't). AFAIK, there is never a need for ``...'' in Info.
In GNU Emacs 23.0.94.1 (i386-mingw-nt5.1.2600)
of 2009-05-24 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
^ permalink raw reply [flat|nested] 7+ messages in thread
* bug#3503: 23.0.94; Emacs manual, main menu typo
2009-06-08 22:39 bug#3503: 23.0.94; Emacs manual, main menu typo Drew Adams
@ 2009-06-08 23:02 ` Drew Adams
2011-07-11 16:32 ` Lars Magne Ingebrigtsen
1 sibling, 0 replies; 7+ messages in thread
From: Drew Adams @ 2009-06-08 23:02 UTC (permalink / raw
To: 3503, emacs-pretest-bug
Same thing for ``edit'' in the same node.
Also, ``Shifted motion keys'' in node Setting Mark.
Also, ``GNU Free Documentation License'' in the node of the same name.
There are no other occurrences of `` in the Emacs manual, AFAICT.
^ permalink raw reply [flat|nested] 7+ messages in thread
* bug#3503: 23.0.94; Emacs manual, main menu typo
2009-06-08 22:39 bug#3503: 23.0.94; Emacs manual, main menu typo Drew Adams
2009-06-08 23:02 ` Drew Adams
@ 2011-07-11 16:32 ` Lars Magne Ingebrigtsen
2011-07-11 17:04 ` Drew Adams
1 sibling, 1 reply; 7+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-11 16:32 UTC (permalink / raw
To: Drew Adams; +Cc: 3503
"Drew Adams" <drew.adams@oracle.com> writes:
> ``region'' in the main menu should be just region - or possibly
> "region", if you consider that this somehow defines a region (which I
> don't). AFAIK, there is never a need for ``...'' in Info.
I think this looks OK the way it is. It's introducing a concept that
most newbies won't be familiar with.
> Same thing for ``edit'' in the same node.
Ditto.
> Also, ``Shifted motion keys'' in node Setting Mark.
That one looked rather odd, yes. I've rewritten it.
> Also, ``GNU Free Documentation License'' in the node of the same name.
>
> There are no other occurrences of `` in the Emacs manual, AFAICT.
Eg.:
In the combination, you must combine any sections Entitled ``History''
in the various original documents, forming one section Entitled
``History''; likewise combine any sections Entitled ``Acknowledgements'',
and any sections Entitled ``Dedications''. You must delete all
sections Entitled ``Endorsements.''
And so on. So I think I'll leave that one alone, too.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog http://lars.ingebrigtsen.no/
^ permalink raw reply [flat|nested] 7+ messages in thread
* bug#3503: 23.0.94; Emacs manual, main menu typo
2011-07-11 16:32 ` Lars Magne Ingebrigtsen
@ 2011-07-11 17:04 ` Drew Adams
2011-07-11 17:21 ` Eli Zaretskii
0 siblings, 1 reply; 7+ messages in thread
From: Drew Adams @ 2011-07-11 17:04 UTC (permalink / raw
To: 'Lars Magne Ingebrigtsen'; +Cc: 3503
Lars> I think this looks OK the way it is.
Lars> It's introducing a concept that most newbies won't
Lars> be familiar with.
There is never any purpose in using double single quotes this way in the manual,
AFAICT.
Maybe Eli will correct me. If Eli checks this and he agrees with you, then I'm
OK with it. Otherwise, I maintain that it is not helpful to use ``...'' in the
manual.
I am not the expert on the formatting conventions for our manuals, but this
seems odd to me.
^ permalink raw reply [flat|nested] 7+ messages in thread
* bug#3503: 23.0.94; Emacs manual, main menu typo
2011-07-11 17:04 ` Drew Adams
@ 2011-07-11 17:21 ` Eli Zaretskii
2011-07-11 17:21 ` Drew Adams
2011-07-11 20:50 ` Lars Magne Ingebrigtsen
0 siblings, 2 replies; 7+ messages in thread
From: Eli Zaretskii @ 2011-07-11 17:21 UTC (permalink / raw
To: Drew Adams; +Cc: 3503, larsi
> From: "Drew Adams" <drew.adams@oracle.com>
> Cc: <3503@debbugs.gnu.org>, "'Eli Zaretskii'" <eliz@gnu.org>
> Date: Mon, 11 Jul 2011 10:04:41 -0700
>
> Lars> I think this looks OK the way it is.
> Lars> It's introducing a concept that most newbies won't
> Lars> be familiar with.
>
> There is never any purpose in using double single quotes this way in the manual,
> AFAICT.
>
> Maybe Eli will correct me. If Eli checks this and he agrees with you, then I'm
> OK with it. Otherwise, I maintain that it is not helpful to use ``...'' in the
> manual.
Drew is right, the Info output should not use ``..'' quoting here.
Let me explain.
Normally, when the Info output is produced from Texinfo sources,
`makeinfo' converts ``...'' into "...", while in the printed output, TeX
converts that into “...”. This is why one normally should use ``...''
in Texinfo, not "...". But in menus, which are only visible in the
Info output, this conversion is evidently not done, so ``...'' stays
unchanged, which is not what we want.
You will see further down the main menu that "..." is used correctly.
Bottom line: the ``region'' thing (and ``edit'') should be changed to
use "..." quoting.
^ permalink raw reply [flat|nested] 7+ messages in thread
* bug#3503: 23.0.94; Emacs manual, main menu typo
2011-07-11 17:21 ` Eli Zaretskii
@ 2011-07-11 17:21 ` Drew Adams
2011-07-11 20:50 ` Lars Magne Ingebrigtsen
1 sibling, 0 replies; 7+ messages in thread
From: Drew Adams @ 2011-07-11 17:21 UTC (permalink / raw
To: 'Eli Zaretskii'; +Cc: 3503, larsi
> Drew is right, the Info output should not use ``..'' quoting here.
> Let me explain.
>
> Normally, when the Info output is produced from Texinfo sources,
> `makeinfo' converts ``...'' into "...", while in the printed
> output, TeX
> converts that into "...". This is why one normally should use ``...''
> in Texinfo, not "...". But in menus, which are only visible in the
> Info output, this conversion is evidently not done, so ``...'' stays
> unchanged, which is not what we want.
>
> You will see further down the main menu that "..." is used correctly.
>
> Bottom line: the ``region'' thing (and ``edit'') should be changed to
> use "..." quoting.
Thanks, and thanks for the explanation. I know little about TexInfo and the
manual conventions.
^ permalink raw reply [flat|nested] 7+ messages in thread
* bug#3503: 23.0.94; Emacs manual, main menu typo
2011-07-11 17:21 ` Eli Zaretskii
2011-07-11 17:21 ` Drew Adams
@ 2011-07-11 20:50 ` Lars Magne Ingebrigtsen
1 sibling, 0 replies; 7+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-11 20:50 UTC (permalink / raw
To: Eli Zaretskii; +Cc: 3503
Eli Zaretskii <eliz@gnu.org> writes:
> Normally, when the Info output is produced from Texinfo sources,
> `makeinfo' converts ``...'' into "...", while in the printed output, TeX
> converts that into “...”. This is why one normally should use ``...''
> in Texinfo, not "...". But in menus, which are only visible in the
> Info output, this conversion is evidently not done, so ``...'' stays
> unchanged, which is not what we want.
I see. I'll fix the three ``...'' entries in the menus in emacs.texi.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog http://lars.ingebrigtsen.no/
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2011-07-11 20:50 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-06-08 22:39 bug#3503: 23.0.94; Emacs manual, main menu typo Drew Adams
2009-06-08 23:02 ` Drew Adams
2011-07-11 16:32 ` Lars Magne Ingebrigtsen
2011-07-11 17:04 ` Drew Adams
2011-07-11 17:21 ` Eli Zaretskii
2011-07-11 17:21 ` Drew Adams
2011-07-11 20:50 ` Lars Magne 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.