unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* 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 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).