From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.devel Subject: Re: ELPA commit freeze Date: Thu, 22 Aug 2013 11:47:20 +0300 Message-ID: <5215D018.70308@yandex.ru> References: <871u5w1tpy.fsf@yandex.ru> <520FA630.8080003@yandex.ru> <5211BBC8.40408@yandex.ru> <52133662.1000900@yandex.ru> <5213FA1C.3080700@yandex.ru> <52147393.9070509@yandex.ru> <5215364A.9000605@yandex.ru> <52155933.4080509@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1377161255 16367 80.91.229.3 (22 Aug 2013 08:47:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 22 Aug 2013 08:47:35 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Aug 22 10:47:39 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 1VCQYM-0002vZ-Df for ged-emacs-devel@m.gmane.org; Thu, 22 Aug 2013 10:47:38 +0200 Original-Received: from localhost ([::1]:58362 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VCQYM-0008HS-2c for ged-emacs-devel@m.gmane.org; Thu, 22 Aug 2013 04:47:38 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45676) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VCQYD-00088L-Hr for emacs-devel@gnu.org; Thu, 22 Aug 2013 04:47:35 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VCQY8-0000j6-Du for emacs-devel@gnu.org; Thu, 22 Aug 2013 04:47:29 -0400 Original-Received: from mail-ee0-x22b.google.com ([2a00:1450:4013:c00::22b]:59657) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VCQY8-0000iv-66 for emacs-devel@gnu.org; Thu, 22 Aug 2013 04:47:24 -0400 Original-Received: by mail-ee0-f43.google.com with SMTP id e52so753569eek.30 for ; Thu, 22 Aug 2013 01:47:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=dFR7rzKWvS+KtYzBX2ve8q7qtlrBODUpKQzIA3wdAiE=; b=K8u8yy6fU98N/c2knDEtEDzikLueGqVWVqr6H0q6mK/1SIiUNJkQNekPQE5PLQWpPZ wP61Y72ZJLU8bQ6eEmTcJbQ0Beevr0Gjt/fUsfWoUvvWwP6LEzGQejBqW5X6akcL3POD 1YesZDK3XyhC8S/tVo81tvmq/O+ypHbLGq2GXQh3hP73Cw1paqAO7FtvcMLFUynRPq/G Tb0Y836N4MIVNghNMxFOwMghI2ofT3dqAgZUMyzP/qrjVd+Z5La5s8gWCD6yZ/Vjbcx+ RvyqWxsFczQ4ykpHlMcl603SbHvSL68vVipIvzhM0RxW4jvU4Z0Fuy0cfJF31z5X7KjT 3oBw== X-Received: by 10.14.174.195 with SMTP id x43mr17150630eel.47.1377161243345; Thu, 22 Aug 2013 01:47:23 -0700 (PDT) Original-Received: from [192.168.10.2] (62-118-214.netrun.cytanet.com.cy. [62.228.118.214]) by mx.google.com with ESMTPSA id bn13sm15885239eeb.11.1969.12.31.16.00.00 (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 22 Aug 2013 01:47:22 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130803 Thunderbird/17.0.8 In-Reply-To: X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2a00:1450:4013:c00::22b 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:162971 Archived-At: On 22.08.2013 04:55, Stefan Monnier wrote: >> README.md also may be missing usage information that's in Commentary. >> I've checked, and it's actually the case with all packages I'm >> maintaining (except one, out of 6), whether I'm the author or not. > > Why couldn't that be fixed? Why should usage info not be in README.md? Because it's customary to put at least something into Commentary, usage info seems to be the most natural info to put there, and duplicating text is not nice. See my previous emails for better arguments. >> Take company's README.md, for example. It's barren, but Commentary in >> company.el contains what you'd expect from a description. I'd like to keep >> things that way there. > > We can remove README.md from elpa/packages/company, if you prefer. Of course I don't. > Or we could just remove support for elpa/packages/*/README.md so that > those files are systematically ignored. That's what I was suggesting. Keep supporting plain README's, unlike Melpa, as a backward compatibility measure, and because they're rare anyway. If you're okay with that, I can make the change. Note that I still like the idea of using README.md's for pages at elpa.gnu.org/packages/*, but that can be implemented later.