From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Daniel Hackney Newsgroups: gmane.emacs.devel Subject: Re: GNU ELPA visibility Date: Fri, 2 Nov 2012 03:12:46 -0400 Message-ID: References: <878valgb6v.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 1351840396 31627 80.91.229.3 (2 Nov 2012 07:13:16 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 2 Nov 2012 07:13:16 +0000 (UTC) Cc: Jambunathan K , emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 02 08:13:25 2012 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 1TUBRU-000590-AE for ged-emacs-devel@m.gmane.org; Fri, 02 Nov 2012 08:13:24 +0100 Original-Received: from localhost ([::1]:52614 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TUBRL-0002gR-EW for ged-emacs-devel@m.gmane.org; Fri, 02 Nov 2012 03:13:15 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:51637) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TUBRI-0002fZ-Hi for emacs-devel@gnu.org; Fri, 02 Nov 2012 03:13:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TUBRE-0005QY-BD for emacs-devel@gnu.org; Fri, 02 Nov 2012 03:13:12 -0400 Original-Received: from mail-ie0-f169.google.com ([209.85.223.169]:56914) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TUBRE-0005QM-3r for emacs-devel@gnu.org; Fri, 02 Nov 2012 03:13:08 -0400 Original-Received: by mail-ie0-f169.google.com with SMTP id 10so5650222ied.0 for ; Fri, 02 Nov 2012 00:13:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=haxney.org; s=google; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=YZlHla4NQ/fWvASkY/dCntp3F73oKhycrrZSb7MswEI=; b=L/9+wr4nOcSEmf4cUmErFWVDPzYXLMxjF/KwxTUV2Gwa4wWfxE01mKxp6YuFvDDUOT Q3AKSLzGKjvTLP6aTHW8N93K8vPtGRsRPV0AnEj+bULc+PQHQJA3oZ046OEYTsJrPYjL 92OGyP2h8zWYU+7rkIjh9/wVJWbTOkR9jpDuI= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type:x-gm-message-state; bh=YZlHla4NQ/fWvASkY/dCntp3F73oKhycrrZSb7MswEI=; b=OknM6aHpIj14/WNI2Ho1s2FMkpVlCbdTH+lZFDOu2coIJs4WOhUYpN41N7724ZsyCE z28uO5OyerWscIf2W7Edkym4SG68a+nbKke+grRPCHwZ8wW6HfhH1uJdCLOIhBNyfCEQ dNmIgauAjCD/McTPotpdKmgvtCBKx1+JgLHrzin7DQhS40mwAsbTE8WKipWUleSFp9OA w5MM5mEr/zMQdaZnNnnuCYlSkjMS6z/+XFcigTv2YTZK7upBPyRSw6Q7l3BiuDLLjFLZ fR1p7TQOmIZGMCKNZlqzd2Asy5C2SsHPzDWO05g9S9A9D/AqG2y36yCacB1hFzJXwmYq 4BUA== Original-Received: by 10.50.188.225 with SMTP id gd1mr947100igc.15.1351840387020; Fri, 02 Nov 2012 00:13:07 -0700 (PDT) Original-Received: by 10.64.0.110 with HTTP; Fri, 2 Nov 2012 00:12:46 -0700 (PDT) In-Reply-To: X-Gm-Message-State: ALoCoQkv9klcE2CSB8J1IRT//QqJqy10P+X+c132Vyet5npSXQtPY5aPn21tC7qkRdbeHnKbnobv X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 209.85.223.169 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:154623 Archived-At: Stefan Monnier wrote: >>> I.e. we need to replace the READMEs with more structured files which >>> can be easily turned into acceptable HTML (no need to be fancy, here) >>> as well as easy to render acceptably in Emacs (extra bonus points if >>> that same format can end up being used as a replacement for Info ;-). >> Org can be exported to HTML, Plain text (ASCII) and texi. > > So far, Org, ReST, Markdown, and Texinfo sound like the best > options, indeed. Put another vote in for Org. Aside from shipping with Emacs out-of-the-box, all of its incredibly advanced stuff could come in handy if we want to get fancy down the road. I'm thinking about the embedded source code, which could be very useful as examples of the usage of a library. Other formats allow for 
 equivalents, but none have the
features of Org-babel. More generally, Org has an enormous ability to
store machine-extractable data (in its headers) and much more flexible
formatting. I think it is a no-brainer.

If you wanted to get crazy, you could distribute entire packages as
Org-mode files and unpack them with `org-babel-tangle' ;)

--
Daniel Hackney