unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Richard Stallman <rms@gnu.org>
Cc: emacs-devel@gnu.org
Subject: Re: Procedure for changing the FAQ
Date: Mon, 28 Apr 2003 00:38:17 -0400	[thread overview]
Message-ID: <E19A0PB-0001xz-00@fencepost.gnu.org> (raw)
In-Reply-To: <84u1clne9j.fsf@lucy.is.informatik.uni-duisburg.de> (kai.grossjohann@gmx.net)

    +@enumerate
    +@item
    +The most simple operation is to just insert a tab character.  This
    +operation does not have a convenient key binding, because it is
    +subsumed by the more general operation described next.  But you can use
    +@kbd{C-q @key{TAB}} to insert a literal tab character.
    +
    +A tab character is displayed as a stretch of whitespace which extends
    +to the next display tab stop position, and the default width of a tab
    +stop is eight.  @xref{Display Custom}, for more details.
    +
    +@item
    +Emacs also supports tab stops.  You can set them at arbitrary
    +positions, and then use @kbd{M-i} to advance to the next tab stop.  The
    +default tab stop list contains positions (columns) that are a multiple
    +of eight, and so the effect of @kbd{M-i} is the same as that of
    +@kbd{C-q @key{TAB}} in the default case.
    +
    +You can set the tab stops with @kbd{M-x edit-tab-stops}.

There is too much detail about specific commands.  Those
belong later (and are already included later).  What we need here
is just the concepts, and maybe cross references.

For instance, when explaining tab stops, there is no need to talk about
the default tab stops.  That is just a detail, and this is not the
place for details.

    +The most simple operation is to just insert a tab character.  This
    +operation does not have a convenient key binding, because it is
    +subsumed by the more general operation described next.
    ...
      The
    +default tab stop list contains positions (columns) that are a multiple
    +of eight, and so the effect of @kbd{M-i} is the same as that of
    +@kbd{C-q @key{TAB}} in the default case.
    +

This is simple and convenient in practice, but your description makes
it sound like something bad.  Here's how to describe the situation and
show how it is convenient.

  The simplest kind of indentation operation is to insert a space or
  tab.  You can insert a tab by typing C-q TAB.  With the default tab
  stops, M-i also does this.

This sort of mention of M-i seems appropriate here, because it
involves less detail than the one I criticized.

  reply	other threads:[~2003-04-28  4:38 UTC|newest]

Thread overview: 19+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2003-04-22 15:45 Procedure for changing the FAQ Glenn Morris
2003-04-23 10:15 ` Eli Zaretskii
2003-04-23 13:11   ` Stefan Monnier
2003-04-23 14:08     ` Frank Schmitt
2003-04-23 20:02       ` Eli Zaretskii
2003-04-23 22:31         ` Alex Schroeder
2003-04-24  6:03           ` Eli Zaretskii
2003-04-24  7:46             ` Kai Großjohann
2003-04-26  2:32               ` Richard Stallman
2003-04-26 21:24                 ` Kai Großjohann
2003-04-28  4:38                   ` Richard Stallman [this message]
2003-04-24 23:14       ` Richard Stallman
2003-04-23 18:48     ` Glenn Morris
2003-04-23 19:50     ` Eli Zaretskii
2003-04-23 18:37   ` Glenn Morris
2003-04-23 20:06     ` Eli Zaretskii
2003-04-24 12:44       ` Simon Josefsson
2003-04-23 20:40     ` Robert J. Chassell
2003-04-26 13:46     ` Richard Stallman

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=E19A0PB-0001xz-00@fencepost.gnu.org \
    --to=rms@gnu.org \
    --cc=emacs-devel@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 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).