From mboxrd@z Thu Jan  1 00:00:00 1970
From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=)
Subject: Re: [PATCH] doc: Improve wording and fix typos in "Introduction" and
	"Requirements".
Date: Sun, 26 May 2013 22:07:47 +0200
Message-ID: <87ip251p4c.fsf@gnu.org>
References: <87r4gwh8jm.fsf@karetnikov.org> <87ip28wfj1.fsf@gnu.org>
	<87k3mnnboc.fsf@karetnikov.org> <8761y75fjt.fsf@gnu.org>
	<8761y6n2ki.fsf@karetnikov.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([208.118.235.92]:38087)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1UghEW-0007xD-Gb
	for bug-guix@gnu.org; Sun, 26 May 2013 16:08:01 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1UghET-0002FE-BH
	for bug-guix@gnu.org; Sun, 26 May 2013 16:08:00 -0400
Received: from [2a01:e0b:1:123:ca0a:a9ff:fe03:271e] (port=56223
	helo=xanadu.aquilenet.fr) by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1UghET-00021a-5y
	for bug-guix@gnu.org; Sun, 26 May 2013 16:07:57 -0400
In-Reply-To: <8761y6n2ki.fsf@karetnikov.org> (Nikita Karetnikov's message of
	"Sun, 26 May 2013 01:59:25 +0400")
List-Id: Bug reports for GNU Guix <bug-guix.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-guix>
List-Post: <mailto:bug-guix@gnu.org>
List-Help: <mailto:bug-guix-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-guix>,
	<mailto:bug-guix-request@gnu.org?subject=subscribe>
Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org
Sender: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org
To: Nikita Karetnikov <nikita@karetnikov.org>
Cc: bug-guix@gnu.org

Nikita Karetnikov <nikita@karetnikov.org> skribis:

>> =E2=80=9CConsists of=E2=80=9D may be OK (any native speaker around, thou=
gh?).
>
> "Consist in" means "To have the thing mentioned as the only or most
> important part." [1]  "Consist of" is usually about several things [2],
> AFAICT.
>
> Which one should I use?

=E2=80=9CConsists of=E2=80=9D appears to be the correct one (thanks, Alex ;=
-)).

>> =E2=80=9CPreserving=E2=80=9D instead of =E2=80=9Chonoring=E2=80=9D chang=
es the meaning.  The intended
>> meaning of the sentence was that the system would automatically install
>> any dependencies, or, if building from source, install any build time
>> dependencies.  What did you mean?
>
> I meant the same.  Should I keep "honoring"?

I would say so (though again, I=E2=80=99m not a native speaker.)

(Feel free to commit a revised patch that takes into account this
discussion.)

>> Actually, documentation-wise, my wish would be for people to primarily
>> focus on those parts of the manual that are *not* written yet.  :-)
>
> Which parts would you like to see documented before the next release?

The =E2=80=9CGNU Distribution=E2=80=9D section could be improved.  For inst=
ance, the
bits about bootstrapping from the ELS paper could be incorporated
somehow, because I think it=E2=80=99s an interesting topic, and a distingui=
shing
feature as well.  Also bits about the API, in particular =E2=80=98build-sys=
tem=E2=80=99
objects.

WDYT?

Thanks,
Ludo=E2=80=99.