From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id WNF6M4ifuWRFNQEASxT56A (envelope-from ) for ; Thu, 20 Jul 2023 22:56:40 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id 0J9/M4ifuWQOMwAAauVa8A (envelope-from ) for ; Thu, 20 Jul 2023 22:56:40 +0200 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 4FAEB3CC88 for ; Thu, 20 Jul 2023 22:56:40 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=sbtRRQwX; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1689886600; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=mETDBTCDIgQ1syBWnRQwGRX/K8hOlRrShM5zG6KjTkA=; b=td8HhgbUxZVXM3P/z0vVMe6yZpvEEXrFO8D5/LYP1Wa5WMqnoVCzFTttniZ8wziYRTrrcy LH2M11scM0qJ2dLRYkB/YDs1FaHwDXv65moAsQdwjwGZMmRRUyjHoHVxE6RJmotGasTCJ7 MtFPz371yQbkar0B24T/aag9N/hVTnuwYGXMLPBnX2Iul3krS8xD3IlCFADxEzqnizhiD1 gqGihiZe222B2BaXM5aKL/h0ll94RDFQDEr7rNBYlM5TpIcisFrTIp3JwNwjt4mC7M5+9M 7pOUukzbgnvPC0oNnEyYir/MIYfFxLvGaFOJHMFKBGzJ5CMX1cDH7N14veiClw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1689886600; a=rsa-sha256; cv=none; b=NGDNjMObmE9AiPOl59F2hqekhNEVSbkfekmbO5Oo0hzJJWoCj7viMcH73MHP1DtTpHFnHD dOphSZ0lYDcdMOkJCzyc7ETj8n2+eBZCO8EjaD5T4iZnBIzw8LthoUEHo0Ud17C2Z21kr/ 3mxbnJIZ2EKyMikXZIYkfRVOu00Xbz1mbykyV+HywwKEPlUkgGyImefClpPrC8OGcTRqgA +Epn1AfA965YvmOY6CTuYwC4WJUGsnB8kB0VLB6SQ3tbsfOOuouoc/vjiGvpipsk6GiYT1 9GjGtgUBCK+HmT93ZrZLl5H8T0AG9ASYQMVYK9dBgwBfcd0TWQxfUW/CDK7POA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=sbtRRQwX; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qMagu-0002KI-6H; Thu, 20 Jul 2023 16:56:04 -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 ) id 1qMags-0002Jt-5X for bug-guix@gnu.org; Thu, 20 Jul 2023 16:56:02 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qMagr-0003jT-R7 for bug-guix@gnu.org; Thu, 20 Jul 2023 16:56:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qMagr-0000yk-Mt for bug-guix@gnu.org; Thu, 20 Jul 2023 16:56:01 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#64754: =?UTF-8?Q?=E2=80=98generate-documentation=E2=80=99?= shows evaluated default values Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Thu, 20 Jul 2023 20:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 64754 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 64754@debbugs.gnu.org X-Debbugs-Original-To: bug-guix@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.16898865333717 (code B ref -1); Thu, 20 Jul 2023 20:56:01 +0000 Received: (at submit) by debbugs.gnu.org; 20 Jul 2023 20:55:33 +0000 Received: from localhost ([127.0.0.1]:60082 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qMagP-0000xt-Co for submit@debbugs.gnu.org; Thu, 20 Jul 2023 16:55:33 -0400 Received: from lists.gnu.org ([2001:470:142::17]:40738) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qMagN-0000xf-5p for submit@debbugs.gnu.org; Thu, 20 Jul 2023 16:55:32 -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 ) id 1qMagD-0002Fr-OG for bug-guix@gnu.org; Thu, 20 Jul 2023 16:55:22 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qMagD-0003Ad-1E for bug-guix@gnu.org; Thu, 20 Jul 2023 16:55:21 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:Subject:To:From:in-reply-to: references; bh=mETDBTCDIgQ1syBWnRQwGRX/K8hOlRrShM5zG6KjTkA=; b=sbtRRQwXc21R13 1kVqwisT1K3xizG9qqwCWzqrdOBV0zQX5Mzkrjtn0N7IgzQq6O1gFuTREle7YofTJ8cUQkm8yOtLZ j288c0zaPAXoJ/Te56vCYI7jP6z+jpAE1QN/ErUgK3U1XzUYL4O+cpeIQjakECMbCcdsLiNaYrTTE 44MdONI0z/Bf1+LK3uD5Wb3FU0EErqaCpP028+ZPLa2VEzR1ykPuDPzHPaNqGs8IFyhKIvU+/RD2I X8hiuUAz0T4G1oqlSOFKUwewqaHLe+fpwBv6NDoJgZ70zEYoiIWSIVDfXZMwCfTTsyTwtVyePbReh 5gYofj5Pwou9Q71sohGw==; Received: from [78.199.208.147] (helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qMag5-0007kg-79 for bug-guix@gnu.org; Thu, 20 Jul 2023 16:55:19 -0400 From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Thu, 20 Jul 2023 12:58:12 +0200 Message-ID: <875y6eetob.fsf@inria.fr> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: Duodi 2 Thermidor an 231 de la =?UTF-8?Q?R=C3=A9volution, ?= jour du Bouillon-blanc X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu 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: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: bug-guix-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Spam-Score: -6.86 X-Spam-Score: -6.86 X-Migadu-Queue-Id: 4FAEB3CC88 X-Migadu-Scanner: mx1.migadu.com X-TUID: T91XfbIJbQ24 The =E2=80=98generate-documentation=E2=80=99 procedure of (gnu services con= figuration) shows evaluated default values, as in this example: --8<---------------cut here---------------start------------->8--- scheme@(gnu services admin)> (define serialize-string identity) scheme@(gnu services admin)> (define-configuration foo (f (string (version)) "The version string.")) scheme@(gnu services admin)> (foo) $44 =3D #< f: "3.0.99-git" %location: #f> scheme@(gnu services admin)> (display (generate-documentation `((foo ,foo-f= ields)) 'foo)) @c %start of fragment @deftp {Data Type} foo Available @code{foo} fields are: @table @asis @item @code{f} (default: @code{"3.0.99-git"}) (type: string) The version string. @end table @end deftp @c %end of fragment --8<---------------cut here---------------end--------------->8--- Notice that the =E2=80=98version=E2=80=99 call is expanded. This is problematic because sometimes we explicitly want to have default values like =E2=80=98%default-xyz=E2=80=99 or =E2=80=98(expt 2 10)=E2=80=99= , and this is what we want to appear in the manual, not their evaluation result. Ludo=E2=80=99.