From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Mario Lang Newsgroups: gmane.emacs.devel Subject: Re: [elpa] chess.el: Req. for comment/review: Info manual Date: Wed, 18 Jun 2014 20:20:14 +0200 Message-ID: <87r42m6pwh.fsf@fx.delysid.org> References: <874mzqszid.fsf@fx.delysid.org> <83vbrytft7.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1403115638 29690 80.91.229.3 (18 Jun 2014 18:20:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 18 Jun 2014 18:20:38 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jun 18 20:20:32 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 1WxKTH-0002zr-VD for ged-emacs-devel@m.gmane.org; Wed, 18 Jun 2014 20:20:32 +0200 Original-Received: from localhost ([::1]:59882 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WxKTH-0002DA-9V for ged-emacs-devel@m.gmane.org; Wed, 18 Jun 2014 14:20:31 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42129) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WxKTA-0002AH-0y for emacs-devel@gnu.org; Wed, 18 Jun 2014 14:20:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WxKT5-0001Pv-3z for emacs-devel@gnu.org; Wed, 18 Jun 2014 14:20:23 -0400 Original-Received: from fep19.mx.upcmail.net ([62.179.121.39]:63694) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WxKT4-0001Pf-Q1 for emacs-devel@gnu.org; Wed, 18 Jun 2014 14:20:19 -0400 Original-Received: from edge03.upcmail.net ([192.168.13.238]) by viefep19-int.chello.at (InterMail vM.8.01.05.05 201-2260-151-110-20120111) with ESMTP id <20140618182016.OZIV12994.viefep19-int.chello.at@edge03.upcmail.net> for ; Wed, 18 Jun 2014 20:20:16 +0200 Original-Received: from fx.delysid.org ([80.109.200.215]) by edge03.upcmail.net with edge id FuLE1o00y4fLMH403uLEx5; Wed, 18 Jun 2014 20:20:16 +0200 X-SourceIP: 80.109.200.215 Original-Received: from mlang by fx.delysid.org with local (Exim 4.82) (envelope-from ) id 1WxKT0-00073J-Jx for emacs-devel@gnu.org; Wed, 18 Jun 2014 20:20:14 +0200 In-Reply-To: <83vbrytft7.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 18 Jun 2014 18:09:40 +0300") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.91 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 62.179.121.39 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:172509 Archived-At: Eli Zaretskii writes: >> From: Mario Lang >> Date: Thu, 12 Jun 2014 21:23:38 +0200 >>=20 >> 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. >>=20 >> 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. Thank you!!! > I'm not sure how to proceed with this: the package is maintained > outside of elpa, That is sort of a misunderstanding. chess.el is maintained as part of ELPA since beginning of June. I originally just wanted to commit it (which is what I initially did) to the master branch in packages/chess/, but Stefan convinced me to keep it in a separate branch (externals/chess) to preserve the history. So while it is under "externals/", it is really a native ELPA package these days. The github repo is basically dead, since the original author has no interest in working on it anymore. To make this short, no, chess.el is part of ELPA, and you are free to commit to its branch directly, it is really the main repository these days. > and I probably don't have write access there. You have. > OTOH, committing the changes to savannah doesn't sound right, since > README says that local changes to externals should be kept to a > minimum. This info is contrary to what Stefan made me do, so just ignore it, in the case of chess.el. (To clarify, it was really for the better to actually preserve VCS history.) > 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. Hmm, I changed just README since I tripped over this behaviour when using make externals. I originally wanted to change the code run by make externals as well, but I was a bit too much chicken regarding me being new on ELPA :-). Feel free to revert the one-liner in README if you think it is too confusing. Or I will do that, if you feel strongly about it. --=20 CYa, =E2=A1=8D=E2=A0=81=E2=A0=97=E2=A0=8A=E2=A0=95