From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id qMIcCv7E7GGrZQEAgWs5BA (envelope-from ) for ; Sun, 23 Jan 2022 04:01:18 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id cJvYAv7E7GEXiAAAG6o9tA (envelope-from ) for ; Sun, 23 Jan 2022 04:01:18 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 7CEFA3561D for ; Sun, 23 Jan 2022 04:01:17 +0100 (CET) Received: from localhost ([::1]:45396 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nBT80-0007R7-Lq for larch@yhetil.org; Sat, 22 Jan 2022 22:01:16 -0500 Received: from eggs.gnu.org ([209.51.188.92]:52866) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nBT7m-0007Qx-Vn for guix-patches@gnu.org; Sat, 22 Jan 2022 22:01:03 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:45426) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nBT7m-0007bu-LH for guix-patches@gnu.org; Sat, 22 Jan 2022 22:01:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nBT7m-0007FT-FF for guix-patches@gnu.org; Sat, 22 Jan 2022 22:01:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#53439] [PATCH] doc: Document search paths. Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 23 Jan 2022 03:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 53439 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 53439@debbugs.gnu.org Received: via spool by 53439-submit@debbugs.gnu.org id=B53439.164290686127849 (code B ref 53439); Sun, 23 Jan 2022 03:01:02 +0000 Received: (at 53439) by debbugs.gnu.org; 23 Jan 2022 03:01:01 +0000 Received: from localhost ([127.0.0.1]:38329 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nBT7k-0007F6-Gp for submit@debbugs.gnu.org; Sat, 22 Jan 2022 22:01:00 -0500 Received: from mail-qk1-f174.google.com ([209.85.222.174]:40734) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nBT7i-0007Et-AK for 53439@debbugs.gnu.org; Sat, 22 Jan 2022 22:00:58 -0500 Received: by mail-qk1-f174.google.com with SMTP id z10so15424788qkf.7 for <53439@debbugs.gnu.org>; Sat, 22 Jan 2022 19:00:58 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=vGkhHM7FktlGUTUHQg1dB+Z+vWedRl5EsnbrqejqAOY=; b=Cwc3JknLQn3x340u9xF0eR8C3dUh4oJbnxYW6v3R/km94sG2UHvPzt6cVu7JbfFakB PtrvSE0fZwMGNB40VsaaKtg+BRc4doP/nHd1R+LU8x/JmZflPCJ0jZ976CNWnivs8XjX dKL898KrmExP/X2agJhLNM/KJpB1fDgDNJw0hTMRtANxV0qhPWzK55VdLKPlmlLzwaIj dkFgiT2QT2EUhGtOtZhfxbIoiCyiHcGrYGwu3uJQyeB3ndOgh8ah/uimZiXGjHlnoU0g 2hoDWtDbRdQkqiEVoBVQ0375UuWQJe4/1LIN3ZUXkhzqBq0xBpcQxRI35HNC0ZYMEuvU 1KEQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=vGkhHM7FktlGUTUHQg1dB+Z+vWedRl5EsnbrqejqAOY=; b=nqQA59q2ysuCE4PTqB8/jQ13rtQC0RAuF98DQjK+axI/YLUE+9QRaSAH6AEPcTEm3y Bc5nJ+cx4aetc+t4mDLDdEmTppcCLlHVoX4z/u4E0/EwSM8cKo7Jsp92f98qU0MQ8lB8 W3na9NkbKIlPbD/RqLGpC7QiQpstOcvM82XdDtfmSL3UKkT1bLz8AO0fkNtguCEyVk8w Ftjv/3ggr7qzjf8iocZNLjT+rEuWd2OPkHFgfJB5N5tQwyeSmHlrzH1TQn0UuKxWY6J2 fu3WoPP75j2BByiCXRGY+T24FNTHDnnkAjLQjjlECuY5uh3PLMkkd0PTEG4FiHXNUY7t sUAg== X-Gm-Message-State: AOAM531ROrDcvYOpiQM3WgPNtDYzHouCKOm/M/GblQo9A518l7gvOd2l JuQGXPXchBMCb9lMPlCkMnetfZULs+8= X-Google-Smtp-Source: ABdhPJx/czhCsvOHiq2qZ/yPe26+0hxMVKNXPSOWodWwah+AZt805rTVdOfcexcMhdnO6bx2x4QOwA== X-Received: by 2002:ae9:eb82:: with SMTP id b124mr1333504qkg.582.1642906852537; Sat, 22 Jan 2022 19:00:52 -0800 (PST) Received: from hurd (dsl-205-236-230-254.b2b2c.ca. [205.236.230.254]) by smtp.gmail.com with ESMTPSA id y2sm5233204qke.33.2022.01.22.19.00.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 22 Jan 2022 19:00:51 -0800 (PST) From: Maxim Cournoyer References: <20220122104757.1837-1-ludo@gnu.org> Date: Sat, 22 Jan 2022 22:00:51 -0500 In-Reply-To: <20220122104757.1837-1-ludo@gnu.org> ("Ludovic =?UTF-8?Q?Court=C3=A8s?="'s message of "Sat, 22 Jan 2022 11:47:57 +0100") Message-ID: <87pmoj6tr0.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1642906877; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=vGkhHM7FktlGUTUHQg1dB+Z+vWedRl5EsnbrqejqAOY=; b=ODCFOQZolc6Xx8p2K6ApDBGiCVEFzPuGnFWeFC7hHuObgQmoAzStM+54Yi24P1zFc/DSzk boB75bOuchNtHKFGqFuHY2uSBeC7gnBRoblop9WiUQFSNDtJfI89jAUhtHb2De3WR5NfML ResMbMa6Mc0PPopHAp6zNzFw7MDAZX1dqpYXL/WSEJQnwR3p0e7yGMmgogEIlxYwtNU5zE f8IJyWPBqRlM4lEjgXbTouxcN1D5uGeTLvs3Oh4IoSXThE34TD+KYtU/wcLG8tDrCpLKn2 4/YwvdzU8QsR7z2RM9sglzY/TKW2kHie+bAVxRbcw5oOyiq8uGyk5HhvAdpTOw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1642906877; a=rsa-sha256; cv=none; b=CLsbAktM1oc8cR/1NQ7PXLWRLHQKKoo+q9cuj/sy4gfJk5b5/AWdKOZdv5YOwvyZKRrEey SlUxdaS4aS9mJgjdgaAZp2eNmu/aSPdb6hed1ckvAbiN99ByoduxOL9bYzg0XdMwKtZ1J1 ZPlCzHIvms0+s5kWjD/6RyZ5sObC8cQqOMecfg6rTwtfZ7vKNC0AjT5H3wIXWRwrgwzdsW Ky0Axk9vozQkwNdgd9XntSr89hRV6i1ftmO//fF+G6GOfBCdx9PXQ/+qNnRQ6AzcZ8OBil DtQKwHVDJmz9NpAu/2O4+4vt57b9n1pOELS/rzvq3FF1H4ZPQ4JGHJIZaXBBOw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=Cwc3JknL; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -2.53 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=Cwc3JknL; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 7CEFA3561D X-Spam-Score: -2.53 X-Migadu-Scanner: scn0.migadu.com X-TUID: VGAPxtMT7Olk Hi Ludovic, Ludovic Court=C3=A8s writes: > * doc/guix.texi (package Reference): Link to "Search Paths". > (Build Phases): Mention 'set-paths' phase. > (Search Paths): New node. > --- > doc/guix.texi | 184 +++++++++++++++++++++++++++++++++++++++++++++++++- > 1 file changed, 183 insertions(+), 1 deletion(-) [...] > +@item @code{file-type} (default: @code{'directory}) > +The type of file being matched. > + > +In the libxml2 example above, we would match regular files. Here I am left wondering what other valid values (other than 'regular or 'directory) may be? I remember trying to find such answer, and it was not obvious (I can't remember where the answer lies in the Guile manual as I type this!). > +@item @code{file-pattern} (default: @code{#f}) > +When true, this is a regular expression specifying files to be > matched I'd replace "When true", which I find confusing, by 'Optional' or similar. > +@emph{within} the sub-directories specified by the @code{files} field. > + > +Again, the libxml2 example shows a situation where this is needed. > +@end table > +@end deftp > + > +How do you turn search path specifications on one hand and a bunch of > +directories on the other hand in a set of environment variable > +definitions? That's the job of @code{evaluate-search-paths}. > + > +@deffn {Scheme Procedure} evaluate-search-paths @var{search-paths} @ > + @var{directories} [@var{getenv}] > +Evaluate @var{search-paths}, a list of search-path specifications, for > +@var{directories}, a list of directory names, and return a list of > +specification/value pairs. Use @var{getenv} to determine the current > +settings and report only settings not already effective. > +@end deffn > + > +The @code{(guix profiles)} provides a higher-level helper procedure, > +@code{load-profile}, that sets the environment variables of a profile. > + > @node The Store > @section The Store This LGTM, taking the comments from Maxime into account. Thank you! Maxim