From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Xue Fuqiao Newsgroups: gmane.emacs.devel Subject: Re: Modern conventions for structuring Emacs Lisp libraries Date: Sun, 6 Oct 2013 11:20:22 +0800 Message-ID: References: <87hacvn8sm.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1381029628 24538 80.91.229.3 (6 Oct 2013 03:20:28 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 6 Oct 2013 03:20:28 +0000 (UTC) Cc: Thorsten Jolitz , emacs-devel To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Oct 06 05:20:33 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1VSetU-0002iG-KO for ged-emacs-devel@m.gmane.org; Sun, 06 Oct 2013 05:20:32 +0200 Original-Received: from localhost ([::1]:53686 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VSetT-0003r6-78 for ged-emacs-devel@m.gmane.org; Sat, 05 Oct 2013 23:20:31 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40965) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VSetM-0003py-Pl for emacs-devel@gnu.org; Sat, 05 Oct 2013 23:20:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VSetL-0008Hl-Bg for emacs-devel@gnu.org; Sat, 05 Oct 2013 23:20:24 -0400 Original-Received: from mail-ie0-x22d.google.com ([2607:f8b0:4001:c03::22d]:58311) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VSetL-0008Hh-7V for emacs-devel@gnu.org; Sat, 05 Oct 2013 23:20:23 -0400 Original-Received: by mail-ie0-f173.google.com with SMTP id ar20so12751052iec.18 for ; Sat, 05 Oct 2013 20:20:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=eU5f1x08//IXd+iYOOpcBKXozNWOl5D/sX1DKD7FUTQ=; b=rJ5ROP4iAGaMxKdHH3NV2sSeWC+E9DelLjNgiPaC2SDsvPn7fEh+yZgxowPirWoOF+ Xqi3Sevk7Ck61xuCMWKMrwU8roGQl6wNGkVPHVDMbM5mYWnrQwp1XhfuJ5QmOl/DVQAS yKFVlx6Tl/vskcJVII8pEzybSyued2QCvxguVGZ7PyXVGyC3eQ+wDH/+eF9XdSegvUi6 k6TKdOJ/8jnKDUdaQqOY4kWZk2iBJPmR6tQ6cDjsBEUWT4UDBU1L93G7Ho+meZZRg3q5 QFDN4b9wsrZG2wuHhA0lZ4wY908ryfxNT4cbhYnqMImV0ezA815dxJ9N/HYzuqErpj4L Z3WA== X-Received: by 10.43.60.139 with SMTP id ws11mr13404420icb.12.1381029622263; Sat, 05 Oct 2013 20:20:22 -0700 (PDT) Original-Received: by 10.42.133.72 with HTTP; Sat, 5 Oct 2013 20:20:22 -0700 (PDT) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2607:f8b0:4001:c03::22d X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:163903 Archived-At: On Sun, Oct 6, 2013 at 8:42 AM, Stefan Monnier wrote: > You skipped the part I was looking for: the "Commentary:" > section. I do want this part to be refined. More specifically, I'd > like someone to come up with a description of a markup format to use > there (99% compatible with what we already have), together with code > that can turn such a Commentary section into nicely rendered text in an > Emacs buffer. Agreed. It can also be rendered as HTML in the packages description on elpa.gnu.org (and other package archives, maybe), along with the README. -- Best regards, Xue Fuqiao. http://www.gnu.org/software/emacs/