From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.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 s14OIKrL7WEhIAAAgWs5BA (envelope-from ) for ; Sun, 23 Jan 2022 22:42:02 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id 42Z/HKrL7WEIQAEA9RJhRA (envelope-from ) for ; Sun, 23 Jan 2022 22:42:02 +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 3FE2D16B6A for ; Sun, 23 Jan 2022 22:42:02 +0100 (CET) Received: from localhost ([::1]:58748 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nBkcb-0000kb-FF for larch@yhetil.org; Sun, 23 Jan 2022 16:42:01 -0500 Received: from eggs.gnu.org ([209.51.188.92]:41334) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nBkbr-0000XQ-Bs for guix-patches@gnu.org; Sun, 23 Jan 2022 16:41:19 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:48539) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nBkbe-0000i3-77 for guix-patches@gnu.org; Sun, 23 Jan 2022 16:41:05 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nBkbe-0000gt-1b for guix-patches@gnu.org; Sun, 23 Jan 2022 16:41:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#53439] [PATCH] doc: Document search paths. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 23 Jan 2022 21:41: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: Maxim Cournoyer Cc: 53439@debbugs.gnu.org Received: via spool by 53439-submit@debbugs.gnu.org id=B53439.16429740172593 (code B ref 53439); Sun, 23 Jan 2022 21:41:02 +0000 Received: (at 53439) by debbugs.gnu.org; 23 Jan 2022 21:40:17 +0000 Received: from localhost ([127.0.0.1]:41442 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nBkav-0000fk-B0 for submit@debbugs.gnu.org; Sun, 23 Jan 2022 16:40:17 -0500 Received: from hera.aquilenet.fr ([185.233.100.1]:59960) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nBkat-0000fW-18 for 53439@debbugs.gnu.org; Sun, 23 Jan 2022 16:40:15 -0500 Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id 2947616D; Sun, 23 Jan 2022 22:40:09 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at aquilenet.fr Received: from hera.aquilenet.fr ([127.0.0.1]) by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id pW2Lo6u3LX-e; Sun, 23 Jan 2022 22:40:08 +0100 (CET) Received: from ribbon (91-160-117-201.subs.proxad.net [91.160.117.201]) by hera.aquilenet.fr (Postfix) with ESMTPSA id 03A594F; Sun, 23 Jan 2022 22:40:07 +0100 (CET) From: Ludovic =?UTF-8?Q?Court=C3=A8s?= References: <20220122104757.1837-1-ludo@gnu.org> <87pmoj6tr0.fsf@gmail.com> Date: Sun, 23 Jan 2022 22:40:07 +0100 In-Reply-To: <87pmoj6tr0.fsf@gmail.com> (Maxim Cournoyer's message of "Sat, 22 Jan 2022 22:00:51 -0500") Message-ID: <875yqayvuw.fsf_-_@gnu.org> 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-Spamd-Bar: / X-Rspamd-Server: hera X-Rspamd-Queue-Id: 2947616D X-Spamd-Result: default: False [-0.10 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; FREEMAIL_ENVRCPT(0.00)[gmail.com]; TO_MATCH_ENVRCPT_ALL(0.00)[]; TAGGED_RCPT(0.00)[]; MIME_GOOD(-0.10)[text/plain]; RCPT_COUNT_TWO(0.00)[2]; FREEMAIL_TO(0.00)[gmail.com]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; MID_RHS_MATCH_FROM(0.00)[] 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=1642974122; 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; bh=gZ/tJCmc6tllg5OAl1n4KUhCHOb/60gk+h+R+0rFj64=; b=a2EKyToQG2iUN55bSX88UsqcML3TJC5PzOY7vsGDtq3J1Bt+aiaIKyXlv8+bNtNo2jBz9Z 05kzsDXkJ2VnZWpfVGBraIK+58UZSrF+uRNR06bISm5dFMBj8SqlC2qVuIq8XrBmgSVR+n uy2SBsJ55QpgJkuH25xOJsS3dGx7H+uPmt8vpF7BsvVPF+zNt1sZ+BQkd6oBYr06yJsBYp ZQNybSiwvKzvG6GF6lDuetJ9TZmpTXJFzbNJOqfdXkLoApaFLfE+r729vxZf4bvsGre/J/ GDvHWv+vwN2dwi/DHQf/BXai/Xk02WgSX2D41eYSyv5YxOLQeQcyAZ4yzFGnQQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1642974122; a=rsa-sha256; cv=none; b=pD4f0nkOCFbidyUQOBvyFdScohj33SR0mU7XYu7zkzr/j3Y2RCU3xT60VBtFHnWyZso/UK YgrSR18LITWy3dJ8R/YZnvhvVeyIdtYXfIscPuuG5anfrTmTUqEYWbU91d9y/PZObpnkEY QYHKOecDDt4L25IU2pw2Wp7KnZzNz5OmxQu+ut0eo/EAWlLOZnUVNkOmsAC48nCreAJX+T CcRJtKN0tsEOKe1jUU5z2vcOsENZ8WhBcy5UCk0ueA0+qZxsug45RHxHttCKeH4MGDJW4w vIwOIUZ7WzYzrlYuszh7vkdOq4ng8mHOY+0VfTXdjrnsGMjutmydrwJl/Xbujw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; 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: -4.43 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; 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: 3FE2D16B6A X-Spam-Score: -4.43 X-Migadu-Scanner: scn0.migadu.com X-TUID: PjmU6nxV3AK9 Hi, Maxim Cournoyer skribis: > 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!). Oh right, these are the symbols returned by =E2=80=98stat:kind=E2=80=99. I= =E2=80=99ll clarify that. >> +@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. =E2=80=9CWhen true=E2=80=9D is to be taken literally: if it has truth value= , in the Scheme sense. But =E2=80=9CUnless @code{#f}=E2=80=9D might be clearer? (=E2=80=9COptional=E2=80=9D sounds confusing to me because there has to be = a value, default or not.) Thanks for taking a look! Ludo=E2=80=99.