From: Dmitry Gutov <dgutov@yandex.ru>
To: Glenn Morris <rgm@gnu.org>
Cc: emacs-devel@gnu.org
Subject: Re: Trunk still not open
Date: Sat, 15 Mar 2014 05:22:52 +0200 [thread overview]
Message-ID: <87zjksrvqr.fsf@yandex.ru> (raw)
In-Reply-To: <cdob187f21.fsf@fencepost.gnu.org> (Glenn Morris's message of "Fri, 14 Mar 2014 15:31:18 -0400")
Glenn Morris <rgm@gnu.org> writes:
> I hope you will change your mindset so that you view the documentation
> as central to Emacs.
Maybe I already do, except I limit that to the docstrings and
commentaries only. The main self-documenting feature for me, though, is
`find-function'.
Having just now updated the manual WRT to the new
`blink-matching-paren', I feel quite disgusted by having to document the
changes in triplicate.
The docstrings in the code, lispref/display.texi and emacs/programs.texi
all contain the descriptions of the relevant symbols, each using quite
different text.
Writing docs does not come easy to me in general, and editing three
seemingly arbitrarily different descriptions of the same things is a
good recipe for a headache. I have no idea how to judge the changes I
made.
next prev parent reply other threads:[~2014-03-15 3:22 UTC|newest]
Thread overview: 128+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-02-27 5:00 Trunk still not open Stefan Monnier
2014-03-13 20:55 ` Glenn Morris
2014-03-14 7:58 ` Eli Zaretskii
2014-03-14 9:29 ` Stephen J. Turnbull
2014-03-14 9:35 ` David Kastrup
2014-03-14 9:47 ` Eli Zaretskii
2014-03-14 10:02 ` David Kastrup
2014-03-14 10:23 ` Eli Zaretskii
2014-03-14 10:40 ` David Kastrup
2014-03-14 11:02 ` Eli Zaretskii
2014-03-14 9:43 ` Eli Zaretskii
2014-03-14 9:55 ` Bastien
2014-03-14 15:16 ` Stephen J. Turnbull
2014-03-14 11:42 ` Eric S. Raymond
2014-03-15 9:13 ` Jambunathan K
2014-03-14 12:34 ` Dmitry Gutov
2014-03-14 13:38 ` Stefan Monnier
2014-03-14 19:35 ` Glenn Morris
2014-03-18 20:01 ` joakim
2014-03-19 6:29 ` Glenn Morris
2014-03-19 16:43 ` Stefan
2014-03-14 14:34 ` Stephen J. Turnbull
2014-03-14 14:57 ` Dmitry Gutov
2014-03-14 15:29 ` Eli Zaretskii
2014-03-15 6:22 ` Dmitry Gutov
2014-03-15 9:02 ` Eli Zaretskii
2014-03-16 0:26 ` Dmitry Gutov
2014-03-16 3:49 ` Eli Zaretskii
2014-03-14 15:39 ` Stephen J. Turnbull
2014-03-15 6:30 ` Dmitry Gutov
2014-03-17 4:33 ` Stephen J. Turnbull
2014-03-14 19:31 ` Glenn Morris
2014-03-14 20:08 ` Daniel Colascione
2014-03-16 1:00 ` Glenn Morris
2014-03-16 2:30 ` Daniel Colascione
2014-03-15 1:55 ` Stephen J. Turnbull
2014-03-15 2:09 ` Dmitry Gutov
2014-03-15 8:22 ` Eli Zaretskii
2014-03-15 10:52 ` Juanma Barranquero
2014-03-15 11:18 ` Eli Zaretskii
2014-03-15 11:28 ` Juanma Barranquero
2014-03-16 1:08 ` Glenn Morris
2014-03-16 2:09 ` Juanma Barranquero
2014-03-16 10:02 ` martin rudalics
2014-03-17 16:26 ` Glenn Morris
2014-03-17 17:03 ` Juanma Barranquero
2014-03-17 17:25 ` Eli Zaretskii
2014-03-17 17:31 ` Juanma Barranquero
2014-03-18 15:54 ` Glenn Morris
2014-03-18 17:07 ` Juanma Barranquero
2014-03-18 17:21 ` David Kastrup
2014-03-18 17:27 ` Juanma Barranquero
2014-03-19 4:25 ` Stephen J. Turnbull
2014-03-17 4:43 ` Stephen J. Turnbull
2014-03-17 12:38 ` Juanma Barranquero
2014-03-17 14:31 ` Eli Zaretskii
2014-03-18 6:00 ` Stephen J. Turnbull
2014-03-18 7:51 ` David Kastrup
2014-03-18 12:10 ` John Yates
2014-03-18 12:20 ` David Kastrup
2014-03-18 12:52 ` John Yates
2014-03-18 13:01 ` David Kastrup
2014-03-18 10:56 ` Juanma Barranquero
2014-03-18 16:13 ` Jambunathan K
2014-03-18 16:16 ` Juanma Barranquero
2014-03-18 17:25 ` Jambunathan K
2014-03-18 17:30 ` Juanma Barranquero
2014-03-18 17:51 ` Jambunathan K
2014-03-16 0:39 ` Dmitry Gutov
2014-03-16 3:52 ` Eli Zaretskii
2014-03-16 5:25 ` Dmitry Gutov
2014-03-16 16:10 ` Eli Zaretskii
2014-03-16 16:36 ` Dmitry Gutov
2014-03-16 18:20 ` Eli Zaretskii
2014-03-15 10:02 ` Jambunathan K
2014-03-15 10:19 ` David Kastrup
2014-03-15 11:01 ` Jambunathan K
2014-03-15 11:10 ` Eli Zaretskii
2014-03-17 14:32 ` Stefan
2014-03-17 15:13 ` Lars Magne Ingebrigtsen
2014-03-17 16:13 ` Glenn Morris
2014-03-17 16:43 ` Eli Zaretskii
2014-03-17 16:13 ` Glenn Morris
2014-03-17 16:52 ` Eli Zaretskii
2014-03-17 16:33 ` Eli Zaretskii
2014-03-15 3:22 ` Dmitry Gutov [this message]
2014-03-15 7:10 ` Thien-Thi Nguyen
2014-03-15 9:02 ` David Kastrup
2014-03-15 8:45 ` Eli Zaretskii
2014-03-16 0:32 ` Dmitry Gutov
2014-03-16 1:27 ` Glenn Morris
2014-03-16 5:31 ` Dmitry Gutov
2014-03-16 11:26 ` Nicolas Richard
2014-03-16 3:57 ` Jambunathan K
2014-03-16 16:17 ` Eli Zaretskii
2014-03-16 19:17 ` Jambunathan K
2014-03-16 20:10 ` Eli Zaretskii
2014-03-17 4:56 ` Stephen J. Turnbull
2014-03-19 7:57 ` Jambunathan K
2014-03-19 16:06 ` Eli Zaretskii
2014-03-19 23:21 ` Jambunathan K
-- strict thread matches above, loose matches on Subject: below --
2014-03-17 14:47 Barry OReilly
2014-03-18 17:55 ` Juanma Barranquero
2014-03-18 19:05 ` Jambunathan K
2014-03-18 19:24 ` Juanma Barranquero
2014-03-18 19:29 ` Jambunathan K
2014-03-18 19:47 ` David Kastrup
2014-03-18 19:57 ` David Kastrup
2014-03-19 15:17 ` Jambunathan K
2014-03-19 6:20 ` David Kastrup
2014-03-19 7:24 ` Jambunathan K
2014-03-19 15:22 ` Jambunathan K
2014-03-19 14:54 Alexander Poslavsky
2014-03-19 15:18 ` Jambunathan K
2014-03-19 15:21 ` Alexander Poslavsky
2014-03-19 15:51 ` Glenn Morris
2014-03-19 16:23 ` Stephen J. Turnbull
2014-03-19 20:38 ` Jambunathan K
2014-03-19 15:57 ` Bastien
2014-03-19 15:59 ` Bastien
2014-03-19 16:13 ` Glenn Morris
2014-03-19 17:15 ` Nicolas Richard
2014-03-19 23:38 ` Bastien
2014-03-19 18:45 ` Stefan
2014-03-19 20:01 ` Glenn Morris
2014-03-20 1:22 ` Stefan
2014-03-19 21:21 ` Paul Eggert
2014-03-20 1:24 ` Stefan
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=87zjksrvqr.fsf@yandex.ru \
--to=dgutov@yandex.ru \
--cc=emacs-devel@gnu.org \
--cc=rgm@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).