GNU bug report logs - #70830
[PATCH] doc: Document assume-valid-file-name in local-file

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: guix-patches; Reported by: Richard Sent <richard@HIDDEN>; Keywords: patch; Done: Richard Sent <richard@HIDDEN>; Maintainer for guix-patches is guix-patches@HIDDEN.
bug closed, send any further explanations to 70830 <at> debbugs.gnu.org and Richard Sent <richard@HIDDEN> Request was from Richard Sent <richard@HIDDEN> to control <at> debbugs.gnu.org. Full text available.

Message received at 70830 <at> debbugs.gnu.org:


Received: (at 70830) by debbugs.gnu.org; 8 May 2024 18:28:05 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed May 08 14:28:05 2024
Received: from localhost ([127.0.0.1]:50161 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1s4m1N-00077l-0y
	for submit <at> debbugs.gnu.org; Wed, 08 May 2024 14:28:05 -0400
Received: from mail-108-mta121.mxroute.com ([136.175.108.121]:40855)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <richard@HIDDEN>) id 1s4m1K-00077f-Ld
 for 70830 <at> debbugs.gnu.org; Wed, 08 May 2024 14:28:03 -0400
Received: from filter006.mxroute.com ([136.175.111.2] filter006.mxroute.com)
 (Authenticated sender: mN4UYu2MZsgR)
 by mail-108-mta121.mxroute.com (ZoneMTA) with ESMTPSA id
 18f5975f0d10008ca2.001 for <70830 <at> debbugs.gnu.org>
 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384);
 Wed, 08 May 2024 18:27:32 +0000
X-Zone-Loop: 1428933a5500e5317d03acad57bf68572eb2f239e25b
X-Originating-IP: [136.175.111.2]
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
 d=freakingpenguin.com; s=x; h=Content-Type:MIME-Version:Message-ID:Date:
 Subject:To:From:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID:
 Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc
 :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=ZZ5MIDhJGkk7VHUD51/6cfxo6Rm9HHTIaR3+xlpxKrw=; b=o5iGwAshoFNgPVXHPTCnXUV1uf
 RUQIxhf4szHW3pA6wgQuyLlpZafkizp/BA0KKi4eqc/FkhOr8+H9EHt79dUGKcnb7pjvnC8qW98qx
 hLsbmNTwNxUbgd82oB6vDYwbh+FXy0mLyglWT/eANPdwRd4QZ0i3xOJTJl9M7cX9h9fpV+GUQQf5S
 WOk3st3Jb3eLf21gFYiIzbfNVv3CJCy8BsAuPM+I9eq7pZdiki6YjmSg8TtvXJPVROnLb3652c/5L
 x+kwUGJO4FWKm0XhFx+3hDns/wQuM+242uxFC1qacEuKfBbVklKApwVNuOP88VHuTYLbGuc9H1YjZ
 JVTEJ0RA==;
From: Richard Sent <richard@HIDDEN>
To: 70830 <at> debbugs.gnu.org
Subject: Resending as a series
Date: Wed, 08 May 2024 14:27:21 -0400
Message-ID: <87y18kcg6u.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain
X-Authenticated-Id: richard@HIDDEN
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 70830
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

I submitted another patch (https://qa.guix.gnu.org/issue/70829) which
accidentally depends on this one. I'll resubmit to that issue as a
series since the documentation changes are tied together a bit anyway.

-- 
Take it easy,
Richard Sent
Making my computer weirder one commit at a time.




Information forwarded to guix-patches@HIDDEN:
bug#70830; Package guix-patches. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 8 May 2024 12:19:36 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed May 08 08:19:36 2024
Received: from localhost ([127.0.0.1]:48595 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1s4gGm-0002pH-86
	for submit <at> debbugs.gnu.org; Wed, 08 May 2024 08:19:36 -0400
Received: from lists.gnu.org ([2001:470:142::17]:33014)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <richard@HIDDEN>) id 1s4gGj-0002pB-Ur
 for submit <at> debbugs.gnu.org; Wed, 08 May 2024 08:19:34 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10])
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <richard@HIDDEN>)
 id 1s4gGE-0003GY-IW
 for guix-patches@HIDDEN; Wed, 08 May 2024 08:19:02 -0400
Received: from mail-108-mta151.mxroute.com ([136.175.108.151])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <richard@HIDDEN>)
 id 1s4gGB-0006bI-Gk
 for guix-patches@HIDDEN; Wed, 08 May 2024 08:19:02 -0400
Received: from filter006.mxroute.com ([136.175.111.2] filter006.mxroute.com)
 (Authenticated sender: mN4UYu2MZsgR)
 by mail-108-mta151.mxroute.com (ZoneMTA) with ESMTPSA id
 18f582473120008ca2.001 for <guix-patches@HIDDEN>
 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384);
 Wed, 08 May 2024 12:18:54 +0000
X-Zone-Loop: fc493972ed88e22053073d83ee931439a1395d9bf978
X-Originating-IP: [136.175.111.2]
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;
 d=freakingpenguin.com; s=x; h=Content-Transfer-Encoding:MIME-Version:
 Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type:Content-ID:
 Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc
 :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=R6M4tOOKT77eI9G8RTf+631Jy8ww9kLSosjGWCySFYo=; b=rV8VjMm6FNr8XR6HDY6qCCpeTv
 pex3OGKQ8bTGNI8fzTZqkr/WITPZKVPpOK0zd9YSlMJ9J+3/Uv53xnn6Wcr5b7R8n9mPvhFWiuSpL
 Wzs21JgQCvcG/o1o/Xe2SUxBFn8y2mXESeKCXxrsY+njLHVamL9qg7o0zof+uP+JJcQpwNvVlFa2s
 4ss3bZyGjOueafvZgXxl7gj+i7eqJ57sSyuulaPVwsdlYFrO24hqX60RLZk/ZroPqBrQD9bjUEufL
 aWWAoE0Gzom2WcHujK3lcX2+hPtCgOlf1I7XaI/9e6GcCXlStINeSzTonLIvNevq34nvtzEoinNyf
 dF0S17+g==;
From: Richard Sent <richard@HIDDEN>
To: guix-patches@HIDDEN
Subject: [PATCH] doc: Document assume-valid-file-name in local-file
Date: Wed,  8 May 2024 08:17:51 -0400
Message-ID: <9832f834c7b20b664554f4cc8090f0bf1f0a96ae.1715170671.git.richard@HIDDEN>
MIME-Version: 1.0
X-Debbugs-Cc: Florian Pelz <pelzflorian@HIDDEN>, Ludovic Courtès <ludo@HIDDEN>
Content-Transfer-Encoding: 8bit
X-Authenticated-Id: richard@HIDDEN
Received-SPF: pass client-ip=136.175.108.151;
 envelope-from=richard@HIDDEN; helo=mail-108-mta151.mxroute.com
X-Spam_score_int: -16
X-Spam_score: -1.7
X-Spam_bar: -
X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1,
 DKIM_SIGNED=0.1, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=no autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.9 (/)
X-Debbugs-Envelope-To: submit
Cc: Richard Sent <richard@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.1 (/)

doc/guix.texi (G-Expressions): Document the use of assume-valid-file-name with
local-file.
---
Hi Guix!

I found it odd that assume-valid-file-name isn't documented in the
manual. Well, now it is!

 doc/guix.texi | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index 1c1e0164e7..221db5c022 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -12154,6 +12154,18 @@ G-Expressions
 absolute file name and @var{stat} is the result of @code{lstat}; exclude
 entries for which @var{select?} does not return true.
 
+@var{file} can be wrapped in the @code{assume-valid-file-name} syntactic
+keyword. When this is done, there will not be a warning when
+@code{local-file} is used with a non-literal path.  The path is still
+looked up relative to the current working directory at run time.
+Wrapping is done like this:
+
+@lisp
+(define alice-key-file-path "alice.pub")
+;; ...
+(local-file (assume-valid-file-name alice-key-file-path))
+@end lisp
+
 This is the declarative counterpart of the @code{interned-file} monadic
 procedure (@pxref{The Store Monad, @code{interned-file}}).
 @end deffn

base-commit: da41a8f5e85774e2a507d821b5d52e600fb9d1d7
-- 
2.41.0





Acknowledgement sent to Richard Sent <richard@HIDDEN>:
New bug report received and forwarded. Copy sent to pelzflorian@HIDDEN, ludo@HIDDEN, guix-patches@HIDDEN. Full text available.
Report forwarded to pelzflorian@HIDDEN, ludo@HIDDEN, guix-patches@HIDDEN:
bug#70830; Package guix-patches. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Wed, 8 May 2024 18:45:01 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.