From mboxrd@z Thu Jan  1 00:00:00 1970
From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=)
Subject: Re: [PATCH 02/24] gnu: Add ghc-paths.
Date: Wed, 08 Apr 2015 14:10:18 +0200
Message-ID: <87lhi2yg5x.fsf@gnu.org>
References: <CAKrPhPNeoP_Ywx8beVMnrkeXDwBAJqj=gcTwOEZqLN0wq+cjHw@mail.gmail.com>
	<878ue359rz.fsf@gnu.org>
	<CAKrPhPNCQ-=AWOgkJqoSdMVYdkpqE84U84tmsbe4f=7q4bcaOA@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:39629)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1YfooM-00007m-PJ
	for guix-devel@gnu.org; Wed, 08 Apr 2015 08:10:32 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1YfooH-0001GG-Bv
	for guix-devel@gnu.org; Wed, 08 Apr 2015 08:10:26 -0400
Received: from fencepost.gnu.org ([2001:4830:134:3::e]:48862)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <ludo@gnu.org>)
	id 1YfooH-0001GB-8Z
	for guix-devel@gnu.org; Wed, 08 Apr 2015 08:10:21 -0400
In-Reply-To: <CAKrPhPNCQ-=AWOgkJqoSdMVYdkpqE84U84tmsbe4f=7q4bcaOA@mail.gmail.com>
	(Federico Beffa's message of "Wed, 8 Apr 2015 13:44:46 +0200")
List-Id: "Development of GNU Guix and the GNU System distribution."
	<guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-devel>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=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: Federico Beffa <beffa@ieee.org>
Cc: Guix-devel <guix-devel@gnu.org>

Federico Beffa <beffa@ieee.org> skribis:

> On Wed, Apr 8, 2015 at 10:01 AM, Ludovic Court=C3=A8s <ludo@gnu.org> wrot=
e:
>>> +    (synopsis
>>> +     "Knowledge of GHC's installation directories")
>>> +    (description
>>> +     "Knowledge of GHC's installation directories.")
>>
>> Please expound a little bit.  Otherwise OK.
>
> Thanks for reviewing all of these!
>
> The problem with this and some other libraries is that the library
> doesn't have an official home-page (apart from a source repository
> which doesn't include anything other than the source). The description
> is taken one-to-one from the Cabal file and I don't really know how I
> can expand the description.

Often there=E2=80=99s a README or manual that gives a better overview, but =
yeah,
I don=E2=80=99t mean that you should spend another 10 hours on this.  ;-)  =
So if
you find a paragraph that=E2=80=99s clearer, that=E2=80=99s nice, otherwise=
 it=E2=80=99s OK.

> The Cabal file of some other libraries like, e.g., ghc-network, give
> an, IMO, too detailed description (sometimes even with a code
> snippet):

Agreed, something like this one is overly detailed.

Ludo=E2=80=99.