From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: Agreeing on some "rules" for packaging. Date: Sat, 31 Aug 2013 11:31:08 +0200 Message-ID: <87d2ouxl43.fsf@gnu.org> References: <521D1E38.9090604@gmail.com> <87sixuc71q.fsf@gnu.org> <521E423C.7010107@gmail.com> <20130828205616.GA12493@debian> <87r4dd4eug.fsf@gnu.org> <20130830215908.GA28681@debian> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57335) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFhbP-0005J9-GF for guix-devel@gnu.org; Sat, 31 Aug 2013 05:36:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VFhbJ-0003G6-AV for guix-devel@gnu.org; Sat, 31 Aug 2013 05:36:19 -0400 Received: from hera.aquilenet.fr ([141.255.128.1]:56841) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFhbJ-0003G2-42 for guix-devel@gnu.org; Sat, 31 Aug 2013 05:36:13 -0400 In-Reply-To: <20130830215908.GA28681@debian> (Andreas Enge's message of "Fri, 30 Aug 2013 23:59:08 +0200") List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: Andreas Enge Cc: guix-devel@gnu.org Andreas Enge skribis: > On Thu, Aug 29, 2013 at 12:42:31AM +0200, Ludovic Court=C3=A8s wrote: [...] >> I would perhaps move =E2=80=9CPython Modules=E2=80=9D into a =E2=80=9CSp= ecific Packages=E2=80=9D >> subsection (or something like that), where we might eventually have >> =E2=80=9CPerl Packages=E2=80=9D as well. WDYT? > > Maybe once we have Perl Packages. I do not want to create too many sublev= els. > Or we just create a separate section Perl Packages, depending on whether = we > write essentially the same thing or not. OK, makes sense. >> s/But see @ref{Python Modules}/@xref{Python Modules},/ > > No, since @xref creates text starting by "See", so is only suitable for t= he > beginning of a sentence. What I=E2=80=99m suggesting here is precisely to start the sentence with @x= ref, as recommended (info "(texinfo) @ref"): The '@ref' command can tempt writers to express themselves in a manner that is suitable for a printed manual but looks awkward in the Info format. [...] In general, it is best to use '@ref' only when you need some word other than "see" to precede the reference. When "see" (or "See") is ok, '@xref' and '@pxref' are preferable. >> s/defined in @ref {Package Naming}/previously defined (@pxref{Package Na= ming})/ > > This also gives strange output with an additional "see". It yields something like: previously defined (see Section 4.2 =E2=80=9CPackage Naming=E2=80=9D) How strange is that? :-) >> Also, please leave two spaces after an end-of-sentence period. > > Okay. I suppose this also means that the period at the end of a sentence > is not allowed to fall at the end of an input line? No, that=E2=80=99s not necessary, fortunately. > Since there have not been any objections on the content of the guidelines, > maybe you could push Python 3 following this rule, Cyril? I am curious > whether all our packages will survive the switch to Python 3... Well let=E2=80=99s pull the trigger and see what happens. :-) Thanks, Ludo=E2=80=99.