unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: Bozhidar Batsov <bozhidar@batsov.com>
To: Stefan Monnier <monnier@iro.umontreal.ca>
Cc: "Rüdiger Sonderfeld" <ruediger@c-plusplus.de>,
	emacs-devel <emacs-devel@gnu.org>
Subject: Re: [Emacs-diffs] trunk r115961: Document `subr-x' functions.
Date: Fri, 10 Jan 2014 18:22:02 +0200	[thread overview]
Message-ID: <CAM9Zgm1Y7TLzSA4jek-jK3YTSQkHMx2C2kqsO5n=U+_H0ND=FA@mail.gmail.com> (raw)
In-Reply-To: <jwvppnzc179.fsf-monnier+emacsdiffs@gnu.org>

[-- Attachment #1: Type: text/plain, Size: 473 bytes --]

There should be some guidelines about what needs documenting and what
doesn't. Personally, I feel that hash and string related functions are
worth documenting, as many people are likely learning Elisp by reading the
Elisp manual.


On 10 January 2014 17:22, Stefan Monnier <monnier@iro.umontreal.ca> wrote:

> >   Document `subr-x' functions.
>
> Please don't.  The Elisp manual is already very large, we don't want to
> document everything in it.
>
>
>         Stefan
>
>

[-- Attachment #2: Type: text/html, Size: 887 bytes --]

  reply	other threads:[~2014-01-10 16:22 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <E1W1bSL-0003KG-4g@vcs.savannah.gnu.org>
2014-01-10 15:22 ` [Emacs-diffs] trunk r115961: Document `subr-x' functions Stefan Monnier
2014-01-10 16:22   ` Bozhidar Batsov [this message]
2014-01-10 17:24     ` Stefan Monnier
2014-01-10 17:40       ` Bozhidar Batsov
2014-01-10 16:26   ` Rüdiger Sonderfeld
2014-01-10 17:22     ` Stefan Monnier
2014-01-10 17:58       ` Rüdiger Sonderfeld

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='CAM9Zgm1Y7TLzSA4jek-jK3YTSQkHMx2C2kqsO5n=U+_H0ND=FA@mail.gmail.com' \
    --to=bozhidar@batsov.com \
    --cc=emacs-devel@gnu.org \
    --cc=monnier@iro.umontreal.ca \
    --cc=ruediger@c-plusplus.de \
    /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).