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 12:22:57 +0200 Message-ID: <87k3j2upku.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> <87d2ouxl43.fsf@gnu.org> <20130831100000.GA13269@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]:35466) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFiPX-0004E9-BO for guix-devel@gnu.org; Sat, 31 Aug 2013 06:28:13 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VFiPR-0001MG-5E for guix-devel@gnu.org; Sat, 31 Aug 2013 06:28:07 -0400 Received: from hera.aquilenet.fr ([141.255.128.1]:56956) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VFiPQ-0001KU-VZ for guix-devel@gnu.org; Sat, 31 Aug 2013 06:28:01 -0400 In-Reply-To: <20130831100000.GA13269@debian> (Andreas Enge's message of "Sat, 31 Aug 2013 12:00:00 +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 Sat, Aug 31, 2013 at 11:31:08AM +0200, Ludovic Court=C3=A8s wrote: >> > No, since @xref creates text starting by "See", so is only suitable fo= r the >> > beginning of a sentence. >> 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 o= k, >> '@xref' and '@pxref' are preferable. > > Well, but I would like to start my sentence with "But" and not "See", sin= ce > I am pointing the reader to something that contradicts the previous sente= nce... > >> >> s/defined in @ref {Package Naming}/previously defined (@pxref{Package= Naming})/ >> > This also gives strange output with an additional "see". >> previously defined (see Section 4.2 =E2=80=9CPackage Naming=E2=80=9D) > > and I would like to write "defined in Section..." and not "previously def= ined > (see Section". > > These info rules should not meddle with our writing style. Sure, but the topic of making cross-references that work across media isn=E2=80=99t trivial, which is why Texinfo has several commands with clear rules. > The result is what I wanted to achieve in the pdf, and I think it > looks acceptable in info. Well, by definition, constructs like these look bad in Info. However, perhaps it=E2=80=99s kinda OK with Emacs=E2=80=99 Info reader, which uses h= yperlinks. Nevertheless, I=E2=80=99ve never found it such a hindrance to follow the Te= xinfo rules. >> > Okay. I suppose this also means that the period at the end of a senten= ce >> > is not allowed to fall at the end of an input line? >> No, that=E2=80=99s not necessary, fortunately. > > So texinfo interprets periods at the end of a line as ends of sentences? Presumably, but I don=E2=80=99t know the details. Thanks, Ludo=E2=80=99.