all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Drew Adams <drew.adams@oracle.com>
To: emacs-devel@gnu.org
Cc: rms-assist@gnu.org
Subject: RE: Suggestion for a witty Emacs command for a mug?
Date: Thu, 25 Jan 2018 09:40:10 -0800 (PST)	[thread overview]
Message-ID: <35e9b929-654b-4f4e-9728-cea8e337c3cb@default> (raw)
In-Reply-To: <E1eekPl-0004BP-Bp@fencepost.gnu.org>

Use `auto-fill-mode' - or perhaps `auto-fill-mug'.

After that as a heading, include the doc in a _tiny_ font.

For that, we could use what `C-h f' says, but it's not so great:

  auto-fill-mode is an interactive compiled Lisp function in
  `simple.el'.

  (auto-fill-mode &optional ARG)

  Toggle automatic line breaking (Auto Fill mode).
  Interactively, with a prefix argument, enable
  Auto Fill mode if the prefix argument is positive,
  and disable it otherwise.  If called from Lisp, toggle
  the mode if ARG is ‘toggle’, disable the mode if ARG is
  a non-positive integer, and enable the mode otherwise
  (including if ARG is omitted or nil or a positive integer).

  When Auto Fill mode is enabled, inserting a space at a column
  beyond ‘current-fill-column’ automatically breaks the line at a
  previous space.

  When ‘auto-fill-mode’ is on, the ‘auto-fill-function’ variable is
  non-nil.

  The value of ‘normal-auto-fill-function’ specifies the function to use
  for ‘auto-fill-function’ when turning Auto Fill mode on.

Much better would be to use what (emacs) `Auto Fill' says:

  Auto Fill Mode
  --------------

  “Auto Fill” mode is a buffer-local minor mode (see Minor Modes) in
  which lines are broken automatically at spaces when the line becomes too
  wide.

  ‘M-x auto-fill-mode’
       Enable or disable Auto Fill mode.
  ‘<SPC>’
  ‘<RET>’
       In Auto Fill mode, break lines when appropriate.

     The mode command ‘M-x auto-fill-mode’ toggles Auto Fill mode in the
  current buffer.  Like any other minor mode, with a positive numeric
  argument, it enables Auto Fill mode, and with a negative argument it
  disables it.  To enable Auto Fill mode automatically in certain major
  modes, add ‘auto-fill-mode’ to the mode hooks (*note Major Modes::).
  When Auto Fill mode is enabled, the mode indicator ‘Fill’ appears in the
  mode line (see Mode Line).

     Auto Fill mode breaks lines automatically at spaces whenever they get
  longer than the desired width.  This line breaking occurs only when you
  type <SPC> or <RET>.  If you wish to insert a space or newline without
  permitting line-breaking, type ‘C-q <SPC>’ or ‘C-q C-j’ respectively.
  Also, ‘C-o’ inserts a newline without line breaking.

     When Auto Fill mode breaks a line, it tries to obey the “adaptive
  fill prefix”: if a fill prefix can be deduced from the first and/or
  second line of the current paragraph, it is inserted into the new line
  (see Adaptive Fill).  Otherwise the new line is indented, as though
  you had typed <TAB> on it (see Indentation).  In a programming
  language mode, if a line is broken in the middle of a comment, the
  comment is split by inserting new comment delimiters as appropriate.

     Auto Fill mode does not refill entire paragraphs; it breaks lines but
  does not merge lines.  Therefore, editing in the middle of a paragraph
  can result in a paragraph that is not correctly filled.  To fill it,
  call the explicit fill commands (see Fill Commands).

This makes the point/joke, while showing Emacs as the self-documenting,
self-deprecating/self-kidding editor.



  reply	other threads:[~2018-01-25 17:40 UTC|newest]

Thread overview: 31+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-01-24 18:30 Suggestion for a witty Emacs command for a mug? Jeanne Rasata
2018-01-24 18:50 ` Davis Herring
2018-01-24 18:54 ` Alexis
2018-01-24 19:33 ` Ken Olum
2018-01-24 20:26   ` Drew Adams
2018-01-24 19:35 ` Marcin Borkowski
2018-01-24 22:50   ` Paul Eggert
2018-01-24 23:18     ` Kaushal Modi
2018-01-24 22:20 ` Dimakakos Dimos
2018-01-25  1:59 ` Phil Sainty
2018-01-25  5:29   ` Marcin Borkowski
2018-01-25  7:14     ` Karl Fogel
2018-01-25  8:37       ` Toon Claes
2018-01-25  9:09       ` Stephen Berman
2018-01-25 13:54         ` Herring, Davis
2018-01-25 14:03           ` Stephen Berman
2018-01-25 15:19             ` Toon Claes
2018-01-26 10:12       ` Simon Leinen
2018-01-26 18:00         ` Boruch Baum
2018-01-25 10:20 ` Vincent Ambo
2018-01-25 16:30   ` Richard Stallman
2018-01-25 17:40     ` Drew Adams [this message]
2018-01-26 10:16 ` Simon Leinen
2018-01-26 16:17   ` Drew Adams
2018-01-29 13:25   ` Jeanne Rasata
2018-04-19 19:03     ` Alex Hutcheson
2018-05-02 14:15       ` Jeanne Rasata
2018-05-02 14:27         ` Alex Hutcheson
2018-08-13 15:34           ` Jeanne Rasata
2018-08-13 15:42             ` Kaushal Modi
2018-08-13 23:34               ` 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

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

  git send-email \
    --in-reply-to=35e9b929-654b-4f4e-9728-cea8e337c3cb@default \
    --to=drew.adams@oracle.com \
    --cc=emacs-devel@gnu.org \
    --cc=rms-assist@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.