unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
Subject: RE: Info tutorial is out of date
Date: Mon, 17 Jul 2006 22:03:14 -0700	[thread overview]
Message-ID: <EIENLHALHGIMHGDOLMIMIEMPCJAA.drew.adams@oracle.com> (raw)
In-Reply-To: <200607180440.k6I4eOTi017515@jane.dms.auburn.edu>

       Nonetheless, some of the suggested changes that Drew made
       are good ones. The topic of invisible text is confusing

    I do not see what is confusing about it.  It has been claimed that it
    is not very useful.  But it really is, for people using Info from
    within Emacs.  The fact that quite a bit of text appears apparently
    out of nowhere when yanking, printing or writing to a file can be very
    confusing to people (I still quite often get surprised by it and I can
    only imagine how confusing it can be for less experienced users).  The
    node explains to people why that happens and how they can see exactly
    what they are going to yank, print or write to file by temporarily
    making all text visible using visible-mode.

And the relation to Info is?

    This is useful knowledge, not just for Info, but for other
    Emacs buffers with invisible text as well.

To the question "What does it have to do with *Info*?", you seem to have
answered: nothing; it's not Info-specific.

In that case, it doesn't belong in an Info tutorial. It sounds like an
attempt to explain an Emacs invisible-text gotcha. Put it in the Emacs
manual where invisible text is discussed - after making it comprehensible.

    `visible-mode' which is introduced in this node, is used later to help
    users who want to learn how to use both the Emacs and standalone Info
    readers see how the same text looks in the standalone reader (and
    hence understand remarks about that reader) without actually having to
    launch that reader and search for the same example text in that reader.

Ah, that's what I gathered too. If that's the raison d'etre, then I say toss
it. Put it somewhere else if you like, but certainly not near the beginning
of the Info tutorial that beginner Emacs users will follow _to try to
understand how to use a manual_. It has no place there.

Besides, it's so poorly written that it is, to me, incomprehensible.

Before you explained it, I thought maybe there would be some argument for it
in the tutorial, once I understood more. Now that I understand (a little)
more, it seems to be totally inappropriate for the Info tutorial.

*IF* (I, for one, am not convinced) it were important for people who would
be using both Emacs and the standalone Info, as you say, then it could be
part of the Info _manual_ (not the tutorial). It is not written as a
tutorial procedure, anyway.

On the other hand, you seem to suggest that it is not Info-specific, and
describes an invisible text gotcha whose scope is Emacs. In that case, it
belongs in the Emacs manual (after rewriting), if it is important/useful.

    The note also explains how readers who prefer to have the info that
    Emacs (but not the standalone reader) hides by default available in
    Emacs as well, can achieve that by using `Info-hide-note-references'.

Somewhere else, please.

    I believe that all of this is useful information and the node is not
    even very long.

I believe that all of this is N characters too long, where N is its length.

    Note that the decision to add that material to the Info manual was
    made after quite some discussion on Emacs devel, with your approval
    and with Karl's support.

Maybe it's just in the wrong place, and needs to be rewritten a bit.

  reply	other threads:[~2006-07-18  5:03 UTC|newest]

Thread overview: 114+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2006-07-15 14:44 Info tutorial is out of date Drew Adams
2006-07-15 15:04 ` David Kastrup
2006-07-15 17:07   ` Drew Adams
2006-07-16  6:25     ` Richard Stallman
2006-07-16 17:33       ` Drew Adams
2006-07-16 18:02         ` Eli Zaretskii
2006-07-17 16:06         ` Richard Stallman
2006-07-20 19:03       ` Slawomir Nowaczyk
2006-07-20 23:10         ` Miles Bader
2006-07-21  1:11           ` Slawomir Nowaczyk
2006-07-15 17:46 ` Thien-Thi Nguyen
2006-07-15 23:41   ` Drew Adams
2006-07-16  8:29     ` Thien-Thi Nguyen
2006-07-16 17:33       ` Drew Adams
2006-07-16 17:52       ` Eli Zaretskii
2006-07-16 18:51         ` Thien-Thi Nguyen
2006-07-15 22:14 ` Alan Mackenzie
2006-07-15 22:56   ` martin rudalics
2006-07-15 23:41     ` Drew Adams
2006-07-15 23:41   ` Drew Adams
2006-07-16  0:26     ` Drew Adams
2006-07-16  6:23     ` David Kastrup
2006-07-16 17:33       ` Drew Adams
2006-07-16 17:49         ` David Kastrup
2006-07-20 19:03           ` Slawomir Nowaczyk
2006-07-16 18:42         ` Jay Belanger
2006-07-16 19:24           ` Lennart Borgman
2006-07-16 20:13             ` Jay Belanger
2006-07-16 20:28               ` Lennart Borgman
2006-07-20 19:03               ` Slawomir Nowaczyk
2006-07-20 19:35                 ` Jay Belanger
2006-07-16 22:16           ` Mathias Dahl
2006-07-17  3:09           ` Stefan Monnier
2006-07-17  3:54             ` Luc Teirlinck
2006-07-17  5:07               ` Luc Teirlinck
2006-07-17  5:54               ` Eli Zaretskii
2006-07-17 16:54                 ` Drew Adams
2006-07-17 19:06                   ` Eli Zaretskii
2006-07-17 23:01                     ` Drew Adams
2006-07-18  3:32                       ` Eli Zaretskii
2006-07-18  4:37                         ` Drew Adams
2006-07-18 19:42                           ` Eli Zaretskii
2006-07-18 22:19                             ` Drew Adams
2006-07-19  3:01                               ` Eli Zaretskii
2006-07-17 16:37               ` Drew Adams
2006-07-17 19:01                 ` Eli Zaretskii
2006-07-17 23:01                   ` Drew Adams
2006-07-18  3:34                     ` Eli Zaretskii
2006-07-18  4:37                       ` Drew Adams
2006-07-18 19:43                         ` Eli Zaretskii
2006-07-18 22:19                           ` Drew Adams
2006-07-19  3:02                             ` Eli Zaretskii
2006-07-18 13:37                 ` Richard Stallman
2006-07-18  0:13               ` Richard Stallman
2006-07-18  4:40                 ` Luc Teirlinck
2006-07-18  5:03                   ` Drew Adams [this message]
2006-07-18 15:00                   ` Richard Stallman
2006-07-17  4:20             ` Luc Teirlinck
2006-07-18  2:03             ` Miles Bader
2006-07-18 14:24               ` Stefan Monnier
2006-07-19  3:18                 ` Miles Bader
2006-07-17 16:06           ` Richard Stallman
2006-07-17 16:37           ` Drew Adams
2006-07-17 17:03             ` Jay Belanger
2006-07-17 17:11               ` Drew Adams
2006-07-17 19:01                 ` Jay Belanger
2006-07-17 23:01                   ` Drew Adams
2006-07-17 13:21         ` Alan Mackenzie
2006-07-17 16:37           ` Drew Adams
2006-07-20 19:03             ` Slawomir Nowaczyk
2006-07-20 22:41             ` Richard Stallman
     [not found]       ` <87k66devap.fsf_-_@hans.local.net>
2006-07-16 20:28         ` Info tutorial is out of date; mouse usage David Kastrup
2006-07-16 21:13           ` Drew Adams
2006-07-16  9:08     ` Info tutorial is out of date Alan Mackenzie
2006-07-16 17:33       ` Drew Adams
2006-07-16 18:44         ` Thien-Thi Nguyen
2006-07-16 22:28         ` Mathias Dahl
2006-07-16 23:35         ` Alan Mackenzie
2006-07-16 22:57           ` Mathias Dahl
2006-07-17  1:07           ` Drew Adams
2006-07-17  9:33             ` Alan Mackenzie
2006-07-17 12:49             ` Robert J. Chassell
2006-07-17  8:19           ` Alan Mackenzie
2006-07-18  2:29         ` Miles Bader
2006-07-18  4:37           ` Drew Adams
2006-07-18  7:03             ` Thien-Thi Nguyen
2006-07-18 15:00             ` "shortcut" Richard Stallman
2006-07-19  3:35             ` Info tutorial is out of date Miles Bader
2006-07-17  1:40       ` Richard Stallman
2006-07-17  2:16         ` Jay Belanger
2006-07-17  9:44         ` Alan Mackenzie
2006-07-17 12:25           ` Sascha Wilde
2006-07-17 14:37             ` Mathias Dahl
2006-07-17 14:41               ` Lennart Borgman
2006-07-17 16:37             ` Drew Adams
2006-07-17 18:57               ` Eli Zaretskii
2006-07-17 23:01                 ` Drew Adams
2006-07-18  9:38                   ` Alan Mackenzie
2006-07-18 15:28                     ` Drew Adams
2006-07-18 16:57                       ` Thien-Thi Nguyen
2006-07-18 17:39                         ` Drew Adams
2006-07-18 19:06                           ` Thien-Thi Nguyen
2006-07-18 17:34                       ` Thien-Thi Nguyen
2006-07-17 16:37           ` Drew Adams
2006-07-19  2:23           ` Brad Collins
2006-07-19  9:53             ` Alan Mackenzie
2006-07-19 14:38             ` Richard Stallman
2006-07-17 12:48         ` Robert J. Chassell
2006-07-18  0:12           ` Richard Stallman
2006-07-18 13:39             ` David Hansen
2006-07-16  2:16   ` Jorgen Schaefer
2006-07-16 17:30   ` Richard Stallman
2006-07-16  6:25 ` Richard Stallman
2006-07-16 17:33   ` Drew Adams

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

  List information: https://www.gnu.org/software/emacs/

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

  git send-email \
    --in-reply-to=EIENLHALHGIMHGDOLMIMIEMPCJAA.drew.adams@oracle.com \
    --to=drew.adams@oracle.com \
    /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 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).