From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: [elpa] chess.el: Req. for comment/review: Info manual Date: Wed, 18 Jun 2014 18:09:40 +0300 Message-ID: <83vbrytft7.fsf@gnu.org> References: <874mzqszid.fsf@fx.delysid.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1403104207 11063 80.91.229.3 (18 Jun 2014 15:10:07 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 18 Jun 2014 15:10:07 +0000 (UTC) Cc: emacs-devel@gnu.org To: Mario Lang Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jun 18 17:10:02 2014 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 1WxHUt-0003c1-U2 for ged-emacs-devel@m.gmane.org; Wed, 18 Jun 2014 17:10:00 +0200 Original-Received: from localhost ([::1]:57945 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WxHUt-0000u6-1m for ged-emacs-devel@m.gmane.org; Wed, 18 Jun 2014 11:09:59 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33848) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WxHUi-0000dJ-7B for emacs-devel@gnu.org; Wed, 18 Jun 2014 11:09:54 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WxHUc-0001p1-Ls for emacs-devel@gnu.org; Wed, 18 Jun 2014 11:09:48 -0400 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:48518) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WxHUc-0001og-Ec for emacs-devel@gnu.org; Wed, 18 Jun 2014 11:09:42 -0400 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0N7D00200DY1YB00@a-mtaout20.012.net.il> for emacs-devel@gnu.org; Wed, 18 Jun 2014 18:09:40 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N7D002WUE44QP50@a-mtaout20.012.net.il>; Wed, 18 Jun 2014 18:09:40 +0300 (IDT) In-reply-to: <874mzqszid.fsf@fx.delysid.org> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.166 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:172503 Archived-At: > From: Mario Lang > Date: Thu, 12 Jun 2014 21:23:38 +0200 > > I have recently tried to get the chess.el info manual more > complete/useful. This is my first texi document, and actually the first > time I am trying to document software beyond comments/docstrings and/or > readme's :-). The basic skeleton of chess.info was created by John > Wiegley in 2002. I have just added to it, and fixed some incorrect > stubs. Still, as this is the first info manual I am working on, I'd be > very happy about a bit of external review of my work. If you have > recently checked out chess.el, or have a love for texi, or both, please > have a look at the latest version in elpa. I am really happy about any > kind of help here, be it style corrections (I am not a native speaker) > or even some ideas on how to explain things better/more complete. > > If you have elpa commit access and find anything valuable, just go ahead > and commit it, I am totally fine with that. I've reviewed the manual and have quite a few changes to it. I'm not sure how to proceed with this: the package is maintained outside of elpa, and I probably don't have write access there. OTOH, committing the changes to savannah doesn't sound right, since README says that local changes to externals should be kept to a minimum. Let me know whether to send the diffs to you. Thanks. Btw, your last change to README, viz.: - git clone --reference .. --single-branch --branch externals/PACKAGE git://git.sv.gnu.org/srv/git/emacs/elpa PACKAGE + git clone --reference .. --single-branch --branch externals/PACKAGE $(git config remote.origin.url) PACKAGE is not necessarily for better: now this command and "make externals" will do subtly different things, which not everyone will realize. If we want to be sure people with write access use the URL with write access (and don't want to rely on them to know that and use the correct URL), we should make changes to admin/archive-contents.el to do that when all the externals are checked out.