From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id qI6nFw6p8GHMnAAAgWs5BA (envelope-from ) for ; Wed, 26 Jan 2022 02:51:10 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id QARIFA6p8GHOKgAAauVa8A (envelope-from ) for ; Wed, 26 Jan 2022 02:51:10 +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 12E4823537 for ; Wed, 26 Jan 2022 02:51:10 +0100 (CET) Received: from localhost ([::1]:51996 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nCXSm-0008Lp-Oe for larch@yhetil.org; Tue, 25 Jan 2022 20:51:08 -0500 Received: from eggs.gnu.org ([209.51.188.92]:52842) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nCXSg-0008Lh-75 for guix-patches@gnu.org; Tue, 25 Jan 2022 20:51:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:57683) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nCXSf-00040p-TK for guix-patches@gnu.org; Tue, 25 Jan 2022 20:51:01 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nCXSf-0001PW-RR for guix-patches@gnu.org; Tue, 25 Jan 2022 20:51:01 -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: Wed, 26 Jan 2022 01:51:01 +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.16431618525406 (code B ref 53439); Wed, 26 Jan 2022 01:51:01 +0000 Received: (at 53439) by debbugs.gnu.org; 26 Jan 2022 01:50:52 +0000 Received: from localhost ([127.0.0.1]:50586 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nCXSW-0001P8-9G for submit@debbugs.gnu.org; Tue, 25 Jan 2022 20:50:52 -0500 Received: from mail-qt1-f170.google.com ([209.85.160.170]:45813) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nCXST-0001Oq-9a for 53439@debbugs.gnu.org; Tue, 25 Jan 2022 20:50:51 -0500 Received: by mail-qt1-f170.google.com with SMTP id o3so6290731qtm.12 for <53439@debbugs.gnu.org>; Tue, 25 Jan 2022 17:50:49 -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=aoSFL7Yu+S9hnd9JEyuf6cX1mtOCgqidpdA5ikfIY28=; b=fjUCqxH8Sn1KL3uuD0Pdr4JoUadnDPw0dKlc/lCNkeTzcJAsMj2rShKyf45NfSNuMz E7LAjMJuf/JLy/zZ1UvwV2DEKRF1inl/W6S+lKl2RpjHvjdsPBmOXfFduM9K/UD8rTbJ MHcVCjSitydKVS5U4oVYf5P1TzM+ug/UPqlrbFYCjoAJhLmogx+9DiOMFCEvg2inmbE4 ZcBQFDLlUaWq6wibj0um1vQuheFfkFpQdbf9DM62FEyOOxD8iyVeX59ILo3e6UHobufr 7E+9k1xrNokJJq7bzNioVKz58MdWen6oYe7MccaPD/KS7Hhvf1SnZeKtHPEmqyliXyBu k4Ow== 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=aoSFL7Yu+S9hnd9JEyuf6cX1mtOCgqidpdA5ikfIY28=; b=6QraUfQZpU9IWXQAU/n2DixDB3u7VyTZeR5t74OKOw2g1E23nDct3FpQxT7DU0kCs/ 4XWuH3kcPhzX3EU6/GJRaqSBRzD9A0lutQJyaeLQwjAoy8FeTzpA/1bdvYXPc9cG1yfX oO1LQLrnfK+HuZ/Rh9wRhKcyt+lqErytC+Lr3Lso/az76bcZkJ6EWQ2C/NXLkHm3aAkY CqPD1LBvK4vftUpKCpTa//meRg34EIarbaMkW82mhBJ4eG2yymqX7RsxH/0n7zdqEz3c q2roua9VratsitOy9q1embVp86utyZqvYFiCmh3cPOtgq2FBxgsygweKGO9mWnfQHsFv RYcQ== X-Gm-Message-State: AOAM532ga66gXX9CYGkqKOtxdq2asHVOz9RIvuNJGiV71LMy+8vHDItB QIW+IFt4DjRK4C5ABcKNUwLlyogH/yU= X-Google-Smtp-Source: ABdhPJzYtzy+yOBOynKk8Je1e2s4iO/dyD5jFF2qDePH/pRiGK2ggjUPo/+V8qpfFPb0TCcIOtvu2Q== X-Received: by 2002:ac8:5f96:: with SMTP id j22mr7888496qta.334.1643161843383; Tue, 25 Jan 2022 17:50:43 -0800 (PST) Received: from hurd (dsl-205-233-124-191.b2b2c.ca. [205.233.124.191]) by smtp.gmail.com with ESMTPSA id b9sm9740009qkj.10.2022.01.25.17.50.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 25 Jan 2022 17:50:43 -0800 (PST) From: Maxim Cournoyer References: <20220122104757.1837-1-ludo@gnu.org> <87pmoj6tr0.fsf@gmail.com> <875yqayvuw.fsf_-_@gnu.org> <87r18w6dxx.fsf@gmail.com> <87a6fknevs.fsf@gnu.org> Date: Tue, 25 Jan 2022 20:50:42 -0500 In-Reply-To: <87a6fknevs.fsf@gnu.org> ("Ludovic =?UTF-8?Q?Court=C3=A8s?="'s message of "Tue, 25 Jan 2022 14:06:47 +0100") Message-ID: <875yq7464t.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=1643161870; 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=aoSFL7Yu+S9hnd9JEyuf6cX1mtOCgqidpdA5ikfIY28=; b=CWwU4WaLc8O0JYPx066gTuZebEg8s1Ml2sKPd1SjyqWrPISXwsLwsLOLPokhrnrO4ZI2Xs R9c/NyKzrOFoofEnTaEKf57n0/4wbd7zS78A+Ga1BSEV87pfiGB71hP5B6DyYrZh4hQx8q prIZEPQI0Or8Hr3coiI/F/6h3m4RZ8FzeBlQdbcrZ4bzAqEvnOVmaeltBc7TIAqRShlDDk 0nKHKPgxNfSpP2Hb33Kap6ryYuDxuSo/LwcSX82ePN8RVxLm3g33PFHN9Pu+l8mHu5pJnL pFt5jRUVxeSYhLWnhTTlWDmUiaqk1psAyPWuB9zqO0buhEzXtbBY2gJLdZy8zw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1643161870; a=rsa-sha256; cv=none; b=oYuB4vWCz2YLsloDbniCEyD8yZqnLBtptDRNtOXY+4uFJ799IwFPxzGwRubmSIdEirxkze /wqBZfgf+uW1GlbMZNM7nG3ZRKD8Cy1ZSC3xDYR3tk8zSSRee9IWrjQwAuVjgBfQUoanjY Pa1DjI8c+LGjGuEaytQd3ZVpa5uNlc2iyyrQ02AVWbndxmUcWsBYNAzZXBoHYj+kohmo1z swiQRkV6EFiOuEAwIYvKOhrGT2BS3XtJ4xTzsfx38intOrDc3f+Y9GNjafSZ2tnFGjMvdX LYRvBcun1jjkhE7ntyxbeHPR+6A1t2SQcqmDQnTVxOHm+Yckt/50Xm8GNw9JQg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=fjUCqxH8; 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: -3.33 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=fjUCqxH8; 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: 12E4823537 X-Spam-Score: -3.33 X-Migadu-Scanner: scn0.migadu.com X-TUID: ouDy6OfhR52P Hello! [...] > Regarding the truth value, I ended up in > a00dff3ac113722a709dbe97a727777b3739a5c1 with hopefully clearer wording: > > @item @code{file-pattern} (default: @code{#f}) > This must be either @code{#f} or a regular expression specifying > files to be matched @emph{within} the sub-directories specified by the > @code{files} field. That's explicit and avoid the issue altogether, I like it! > I guess we=E2=80=99re nitpicking :-) but I like to have, on one hand, tex= t in > natural language with examples that conveys ideas in an informal way, > and on the other hand, reference material (@deftp, @deffn, etc.) that=E2= =80=99s > rigorous. I see; that makes sense. Thanks for taking the time to adjust the final result! Maxim