From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: GNU ELPA visibility Date: Thu, 01 Nov 2012 08:42:55 -0400 Message-ID: References: <878valgb6v.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1351773790 16079 80.91.229.3 (1 Nov 2012 12:43:10 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 1 Nov 2012 12:43:10 +0000 (UTC) Cc: emacs-devel@gnu.org To: Jambunathan K Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Nov 01 13:43:15 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 1TTu76-0000oE-V1 for ged-emacs-devel@m.gmane.org; Thu, 01 Nov 2012 13:43:13 +0100 Original-Received: from localhost ([::1]:40280 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TTu6y-0005D0-3D for ged-emacs-devel@m.gmane.org; Thu, 01 Nov 2012 08:43:04 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:44479) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TTu6s-00059L-4h for emacs-devel@gnu.org; Thu, 01 Nov 2012 08:43:02 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TTu6r-0000Ek-4P for emacs-devel@gnu.org; Thu, 01 Nov 2012 08:42:57 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.182]:52493) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TTu6r-0000Ee-0E for emacs-devel@gnu.org; Thu, 01 Nov 2012 08:42:57 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av0EAG6Zu0/O+LET/2dsb2JhbABEtBGBCIIVAQEEAVYjEAs0EhQYDSSIHAW6CZBEA6MzgViDBQ X-IronPort-AV: E=Sophos;i="4.75,637,1330923600"; d="scan'208";a="203296409" Original-Received: from 206-248-177-19.dsl.teksavvy.com (HELO pastel.home) ([206.248.177.19]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 01 Nov 2012 08:42:56 -0400 Original-Received: by pastel.home (Postfix, from userid 20848) id AB1EE58C9F; Thu, 1 Nov 2012 08:42:55 -0400 (EDT) In-Reply-To: <878valgb6v.fsf@gmail.com> (Jambunathan K.'s message of "Thu, 01 Nov 2012 10:40:48 +0530") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 206.248.154.182 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:154608 Archived-At: >> 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. Texinfo requires an extra step (generate Info) before rendering in Emacs but has the advantage that this rendering already exists and that Texinfo is the standard GNU documentation format. It has its weaknesses, but it's a tool we know (i.e. which is why we already know its weaknesses). I'd be interested to see some sample rendering of Markdown, Org, and ReST both in HTML and inside Emacs, for comparison. Stefan