From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ricardo Wurmus <rekado@elephly.net>
Subject: Re: Real-world example for channels?
Date: Sun, 27 Jan 2019 00:00:58 +0100
Message-ID: <87munnt45x.fsf@elephly.net>
References: <29d3b7b9-6d96-e132-e59e-ec7a5ccdd2f1@crazy-compilers.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([209.51.188.92]:59156)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <rekado@elephly.net>) id 1gnXer-000817-Mv
	for help-guix@gnu.org; Sat, 26 Jan 2019 18:46:42 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <rekado@elephly.net>) id 1gnXep-0006qi-Ji
	for help-guix@gnu.org; Sat, 26 Jan 2019 18:46:41 -0500
Received: from sender-of-o51.zoho.com ([135.84.80.216]:21020)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <rekado@elephly.net>) id 1gnXel-0006oq-Ck
	for help-guix@gnu.org; Sat, 26 Jan 2019 18:46:36 -0500
In-reply-to: <29d3b7b9-6d96-e132-e59e-ec7a5ccdd2f1@crazy-compilers.com>
List-Id: <help-guix.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/help-guix>,
	<mailto:help-guix-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/help-guix/>
List-Post: <mailto:help-guix@gnu.org>
List-Help: <mailto:help-guix-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/help-guix>,
	<mailto:help-guix-request@gnu.org?subject=subscribe>
Errors-To: help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org
Sender: "Help-Guix" <help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org>
To: Hartmut Goebel <h.goebel@crazy-compilers.com>
Cc: help-guix <help-guix@gnu.org>


Hi Hartmut,

> I'm looking for some real-world examples for channels.

Here=E2=80=99s an example:

    https://github.com/BIMSBbioinfo/guix-bimsb

> After reading
> <https://www.gnu.org/software/guix/manual/en/html_node/Channels.html>
> I'm confused:
>
>   * AFAIU Section 3.7.1 shows an example for pulling *whole* guix from a
>     different location. So this needs to be a complete guix-clone
>     (optionally including my own package modules).

Correct.

>   * Section 3.7.2 describes how to add "a Git repository containing [my]
>     own package modules".
>       o What files or scm-packages is this git-repo expected to include?
>         What's the file-layout? Is there a suggested naming-convention?
>         How to #use-module these packages?

No files are expected to be included.  You only include files that you
want to offer.  There is no prescribed file layout, nor is there any
naming convention.

You #:use-module these modules like any other module.

If the repository contains a file =E2=80=9Cfoo.scm=E2=80=9D which starts wi=
th
=E2=80=9C(define-module (foo) =E2=80=A6)=E2=80=9D, then you can =E2=80=9C#:=
use-module (foo)=E2=80=9D after the
repository has been added as a channel.

I suggest putting modules in separate namespaces.  All modules provided
by =E2=80=9Cguix-bimsb=E2=80=9D, for example, are in the =E2=80=9Cbimsb=E2=
=80=9D namespace.

--
Ricardo