From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nikita Karetnikov Subject: Re: [PATCH] doc: Add 'copyrights' and 'license' macros. Date: Thu, 10 Oct 2013 17:10:45 +0400 Message-ID: <8738o9mfu2.fsf@karetnikov.org> References: <86mwmidra1.fsf@frenzy.freefriends.org> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:40242) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VUFwF-0006Df-D2 for guix-devel@gnu.org; Thu, 10 Oct 2013 09:06:00 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VUFwA-0003TA-H0 for guix-devel@gnu.org; Thu, 10 Oct 2013 09:05:59 -0400 In-Reply-To: <86mwmidra1.fsf@frenzy.freefriends.org> (Karl Berry's message of "Wed, 09 Oct 2013 16:16:06 -0600") List-Id: "Development of GNU Guix and the GNU System distribution." 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: Karl Berry Cc: guix-devel@gnu.org --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable >>> Sorry, I don't understand what problem you're trying to solve. >>> Why are you separating copyright text and license text?=20=20 I don=E2=80=99t know how to keep the @ifinfo trick (see the attachment) wit= hout separating them. Maybe the @ifinfo part should be removed. >>> Can you send me the whole file (beginning of it, anyway)? >>> The diff is hard to read. Attached. >> And yeah, there could be a single macro since the two always go >> together. > Why is a macro needed at all? > (vs. just using text inside @copying). In the document, nearly the same (more on that later) copyright notice is repeated three times. A new contributor would have to adjust each notice, which is error-prone. Now, I said =E2=80=9Cnearly=E2=80=9D because the =E2=80=9CCopyright=E2=80= =9D lines are different, but they should be identical. --=-=-= Content-Type: text/plain; charset=utf-8 Content-Disposition: attachment; filename=guix.texi.beginning Content-Transfer-Encoding: quoted-printable \input texinfo @c -*-texinfo-*- @c %**start of header @setfilename guix.info @documentencoding UTF-8 @settitle GNU Guix Reference Manual @c %**end of header @include version.texi @set YEARS 2012, 2013 @dircategory Package management @direntry * guix: (guix). Guix, the functional package manager. * guix package: (guix)Invoking guix package Managing packages with Guix. * guix build: (guix)Invoking guix build Building packages with Guix. @end direntry @titlepage @title GNU Guix Reference Manual @subtitle Using the GNU Guix Functional Package Manager @author Ludovic Court=C3=A8s @author Andreas Enge @author Nikita Karetnikov @page @vskip 0pt plus 1filll Edition @value{EDITION} @* @value{UPDATED} @* Copyright @copyright{} @value{YEARS} Ludovic Court@`es, Andreas Enge, Nikit= a Karetnikov @ifinfo @quotation Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled ``GNU Free Documentation License''. @end quotation @end ifinfo @end titlepage @copying This manual documents GNU Guix version @value{VERSION}. Copyright @copyright{} @value{YEARS} Ludovic Court=C3=A8s Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled ``GNU Free Documentation License.'' @end copying @contents @c ********************************************************************* @node Top @top GNU Guix This document describes GNU Guix version @value{VERSION}, a functional package management tool written for the GNU system. @quotation Copyright @copyright{} @value{YEARS} Ludovic Court=C3=A8s, Andreas Enge, Ni= kita Karetnikov Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled ``GNU Free Documentation License.'' @end quotation --=-=-=-- --==-=-= Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.10 (GNU/Linux) iQIcBAEBAgAGBQJSVqdYAAoJEM+IQzI9IQ38HvwP/3oP3847GSRIA/SmhKP9CnkD i7JmMWgVj3LNBEtXzSgiLGdvgjx+x+RuNKxoJ3JshqQCfFeOJo4enT90y8ivXqOL LWNPvlBM6yriQu3ec+oMscCtk7hub0xILMkh/CbgOp1FHBHmVqEvq7hM7qj2kJkZ oh1gtY7ab34U2ls/TY+uELvFaJZFaGXNZHs3osUJGRI7IABGSLKGcrYG9psUsZ3U fk8alTIfdfpaQqiPZ04cTnq6WIRdgDWoP0Q0JR5pz72yM+rw5cceJ8DJtp8Yz9Yy UmWGLWcDGS9hmpYVWPIR3siuCl4l/rHO5rOChFJNtGsmHUHO5fDvhuDlbHY6zH1b CDabzKuu3Y1ADBMTy2aPn78FBx6iI3rm5sTj//Fu2N+xSN5NftKbbebMqX6dcvaD +LEapGxRoJoiMQ9p+VSfxofDqiDV4bt+Dg9b89L10Qf/8Uc289zAIb5ErdX9Lki2 x/YrN7a/g/xx7Zb6Pm5lnJ/fryJ18E0KUrrNfpDvTd1cLqKpFf5YYv1oI8FbctBh mlQi8GgWOB5xyFAcmYl5r9p0Fweaeykrm6LyoqLY3REEbOfJqi7rnQvpEXiV2Z0n DBjNSfoS7Pz/5q/bEvcZ9CEqQSXXa3PC1ocCJQe6N2TYOlbJyCbrOs2nOEQQ7zPN g1fL7h7dtYq6ElP7XKZ0 =jhx0 -----END PGP SIGNATURE----- --==-=-=--