all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
To: "'Eli Zaretskii'" <eliz@gnu.org>
Cc: 10451@debbugs.gnu.org
Subject: bug#10451: 24.0.92; Bad cross reference in Info manual
Date: Sun, 8 Jan 2012 11:19:43 -0800	[thread overview]
Message-ID: <FCCD50F04D76443F998E0E3F08FAE55D@us.oracle.com> (raw)
In-Reply-To: <83zkdydnfp.fsf@gnu.org>

> This is not the one I had in mind.

It's the one I pretty clearly cited:

>> Please note that the links I am talking about are in node 
>> `Help Xref', not in node `Expert Info'.

And in the same mail I quoted the same text from node `Help Xref' (twice now).

> If you are talking about this one,

Yes, I am talking about node `Help Xref'.

> then there's another problem: this manual also comes with the Texinfo
> package.  If that reference is changed to point to the Emacs manual,
> it will be broken for someone who installs the Texinfo manual and
> doesn't have the Emacs manual installed.

I addressed that in the original bug report:

>> I realize that the Info manual is not only for Emacs.  Still, many
>> readers will read it in Emacs, and this is borne out by some of the
>> manual text that says things like "If you are reading this in Emacs...".
>>  
>> It is likely that at least as many readers of the Info manual will have
>> the Emacs manual (and perhaps some other manuals that are provided with
>> Emacs) as will have the Texinfo manual installed.  And most Info users
>> will never be creating Info files and thus using Texinfo.

And no, it is not true that "this [Info] manual also comes with the Texinfo
package".  That might be true sometimes, but it is not true in general.

That's the point.  If the `Info' manual always came with the `Texinfo' manual
then I would not have filed this bug report - the links would just work.  Please
read what I wrote.

For an Emacs distribution (this is an _Emacs_ bug report), it is not always the
case that Emacs is distributed with Texinfo (and rightly so, IMHO).

If you can find a way to make the text be such that it works for Info with
Texinfo (and perhaps without Emacs) as well as working for Info with Emacs but
without Texinfo, fine.  Barring that, let's please fix this for Emacs users -
people who will read Info within Emacs, and who will not necessarily also have
the Texinfo manual installed.






  reply	other threads:[~2012-01-08 19:19 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-01-08  6:40 bug#10451: 24.0.92; Bad cross reference in Info manual Drew Adams
2012-01-08  8:56 ` Eli Zaretskii
2012-01-08 15:29   ` Drew Adams
2012-01-08 18:12     ` Eli Zaretskii
2012-01-08 18:56       ` Drew Adams
2012-01-08 19:06         ` Eli Zaretskii
2012-01-08 19:19           ` Drew Adams [this message]
2012-01-08 22:34   ` Richard Stallman
2013-02-08 21:09     ` Drew Adams
2014-02-09  5:25       ` Lars Ingebrigtsen

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=FCCD50F04D76443F998E0E3F08FAE55D@us.oracle.com \
    --to=drew.adams@oracle.com \
    --cc=10451@debbugs.gnu.org \
    --cc=eliz@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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.