From unknown Sun Aug 17 09:10:32 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#44252 <44252@debbugs.gnu.org> To: bug#44252 <44252@debbugs.gnu.org> Subject: Status: [PATCH] doc: Use @code rather than @var for data type items. Reply-To: bug#44252 <44252@debbugs.gnu.org> Date: Sun, 17 Aug 2025 16:10:32 +0000 retitle 44252 [PATCH] doc: Use @code rather than @var for data type items. reassign 44252 guix-patches submitter 44252 Christopher Baines severity 44252 normal tag 44252 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Oct 27 05:54:23 2020 Received: (at submit) by debbugs.gnu.org; 27 Oct 2020 09:54:23 +0000 Received: from localhost ([127.0.0.1]:42948 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kXLgN-0002ra-1v for submit@debbugs.gnu.org; Tue, 27 Oct 2020 05:54:23 -0400 Received: from lists.gnu.org ([209.51.188.17]:39784) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kXLgM-0002rU-4W for submit@debbugs.gnu.org; Tue, 27 Oct 2020 05:54:22 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:53114) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kXLgL-0003Q5-Sx for guix-patches@gnu.org; Tue, 27 Oct 2020 05:54:21 -0400 Received: from mira.cbaines.net ([2a01:7e00:e000:2f8:fd4d:b5c7:13fb:3d27]:44273) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kXLgJ-0006ld-P6 for guix-patches@gnu.org; Tue, 27 Oct 2020 05:54:21 -0400 Received: from localhost (92.41.179.191.threembb.co.uk [92.41.179.191]) by mira.cbaines.net (Postfix) with ESMTPSA id 879C027BBF2 for ; Tue, 27 Oct 2020 09:54:17 +0000 (GMT) Received: from localhost (localhost [local]) by localhost (OpenSMTPD) with ESMTPA id 907611ff for ; Tue, 27 Oct 2020 09:54:15 +0000 (UTC) From: Christopher Baines To: guix-patches@gnu.org Subject: [PATCH] doc: Use @code rather than @var for data type items. Date: Tue, 27 Oct 2020 09:54:15 +0000 Message-Id: <20201027095415.18584-1-mail@cbaines.net> X-Mailer: git-send-email 2.28.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2a01:7e00:e000:2f8:fd4d:b5c7:13fb:3d27; envelope-from=mail@cbaines.net; helo=mira.cbaines.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/27 05:46:05 X-ACL-Warn: Detected OS = ??? X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, UNPARSEABLE_RELAY=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) In the couple of cases where it's inconsistent. * doc/guix.texi (PostgreSQL, Sound Services): Replace @var with @code within data type sections. --- doc/guix.texi | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index a8aa2de0a6..ed15876ed5 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -18564,20 +18564,20 @@ without a @code{pulseaudio} package, consider enabling it through the Data type representing the configuration for @code{pulseaudio-service}. @table @asis -@item @var{client-conf} (default: @code{'()}) +@item @code{client-conf} (default: @code{'()}) List of settings to set in @file{client.conf}. Accepts a list of strings or a symbol-value pairs. A string will be inserted as-is with a newline added. A pair will be formatted as ``key = value'', again with a newline added. -@item @var{daemon-conf} (default: @code{'((flat-volumes . no))}) +@item @code{daemon-conf} (default: @code{'((flat-volumes . no))}) List of settings to set in @file{daemon.conf}, formatted just like @var{client-conf}. -@item @var{script-file} (default: @code{(file-append pulseaudio "/etc/pulse/default.pa")}) +@item @code{script-file} (default: @code{(file-append pulseaudio "/etc/pulse/default.pa")}) Script file to use as @file{default.pa}. -@item @var{system-script-file} (default: @code{(file-append pulseaudio "/etc/pulse/system.pa")}) +@item @code{system-script-file} (default: @code{(file-append pulseaudio "/etc/pulse/system.pa")}) Script file to use as @file{system.pa}. @end table @end deftp @@ -18640,24 +18640,24 @@ Data type representing the configuration for the @code{postgresql-service-type}. @table @asis -@item @var{postgresql} +@item @code{postgresql} PostgreSQL package to use for the service. -@item @var{port} (default: @code{5432}) +@item @code{port} (default: @code{5432}) Port on which PostgreSQL should listen. -@item @var{locale} (default: @code{"en_US.utf8"}) +@item @code{locale} (default: @code{"en_US.utf8"}) Locale to use as the default when creating the database cluster. -@item @var{config-file} (default: @code{(postgresql-config-file)}) +@item @code{config-file} (default: @code{(postgresql-config-file)}) The configuration file to use when running PostgreSQL. The default behaviour uses the postgresql-config-file record with the default values for the fields. -@item @var{data-directory} (default: @code{"/var/lib/postgresql/data"}) +@item @code{data-directory} (default: @code{"/var/lib/postgresql/data"}) Directory in which to store the data. -@item @var{extension-packages} (default: @code{'()}) +@item @code{extension-packages} (default: @code{'()}) @cindex postgresql extension-packages Additional extensions are loaded from packages listed in @var{extension-packages}. Extensions are available at runtime. For instance, -- 2.28.0 From debbugs-submit-bounces@debbugs.gnu.org Tue Oct 27 12:42:02 2020 Received: (at 44252) by debbugs.gnu.org; 27 Oct 2020 16:42:02 +0000 Received: from localhost ([127.0.0.1]:45541 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kXS2s-0007Ov-D6 for submit@debbugs.gnu.org; Tue, 27 Oct 2020 12:42:02 -0400 Received: from eggs.gnu.org ([209.51.188.92]:53048) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kXS2m-0007OG-TN for 44252@debbugs.gnu.org; Tue, 27 Oct 2020 12:41:57 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:53935) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kXS2h-000310-Ax; Tue, 27 Oct 2020 12:41:51 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=39964 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kXS2g-0006jp-SE; Tue, 27 Oct 2020 12:41:51 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Christopher Baines Subject: Re: [bug#44252] [PATCH] doc: Use @code rather than @var for data type items. References: <20201027095415.18584-1-mail@cbaines.net> Date: Tue, 27 Oct 2020 17:41:49 +0100 In-Reply-To: <20201027095415.18584-1-mail@cbaines.net> (Christopher Baines's message of "Tue, 27 Oct 2020 09:54:15 +0000") Message-ID: <87tuuf62pe.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 44252 Cc: 44252@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hi, Christopher Baines skribis: > In the couple of cases where it's inconsistent. > > * doc/guix.texi (PostgreSQL, Sound Services): Replace @var with @code wit= hin > data type sections. Good catch, LGTM! Ludo=E2=80=99. From debbugs-submit-bounces@debbugs.gnu.org Wed Oct 28 09:06:21 2020 Received: (at 44252-done) by debbugs.gnu.org; 28 Oct 2020 13:06:21 +0000 Received: from localhost ([127.0.0.1]:47667 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kXl9h-0004sj-HB for submit@debbugs.gnu.org; Wed, 28 Oct 2020 09:06:21 -0400 Received: from mira.cbaines.net ([212.71.252.8]:59778) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kXl9f-0004sa-Ch for 44252-done@debbugs.gnu.org; Wed, 28 Oct 2020 09:06:19 -0400 Received: from localhost (188.28.126.167.threembb.co.uk [188.28.126.167]) by mira.cbaines.net (Postfix) with ESMTPSA id 7506D27BBF2; Wed, 28 Oct 2020 13:06:18 +0000 (GMT) Received: from capella (localhost [127.0.0.1]) by localhost (OpenSMTPD) with ESMTP id 162ee76e; Wed, 28 Oct 2020 13:06:15 +0000 (UTC) References: <20201027095415.18584-1-mail@cbaines.net> <87tuuf62pe.fsf@gnu.org> User-agent: mu4e 1.4.13; emacs 27.1 From: Christopher Baines To: Ludovic =?utf-8?Q?Court=C3=A8s?= Subject: Re: [bug#44252] [PATCH] doc: Use @code rather than @var for data type items. In-reply-to: <87tuuf62pe.fsf@gnu.org> Date: Wed, 28 Oct 2020 13:06:15 +0000 Message-ID: <874kmezeig.fsf@cbaines.net> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 44252-done Cc: 44252-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Ludovic Court=C3=A8s writes: > Hi, > > Christopher Baines skribis: > >> In the couple of cases where it's inconsistent. >> >> * doc/guix.texi (PostgreSQL, Sound Services): Replace @var with @code wi= thin >> data type sections. > > Good catch, LGTM! Great, I've pushed this along with another PostgreSQL documentation improvement as 0105b8624dbba539677ebbfd0dc0bd35143c6fad. --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQKlBAEBCgCPFiEEPonu50WOcg2XVOCyXiijOwuE9XcFAl+ZbMdfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDNF ODlFRUU3NDU4RTcyMEQ5NzU0RTBCMjVFMjhBMzNCMEI4NEY1NzcRHG1haWxAY2Jh aW5lcy5uZXQACgkQXiijOwuE9XfHNRAAgQPCeMLFU568yB8cGx49TXlS4pmUeqzm oMgGBlMbqQUQG2OF3v9pHb+OT7BZ7ILYlwFj2XsHtDIh4OrpQvOEPSchNHk6wtUv x4/DCNv451tq1Xrh7r7HX3TLGi7OzSPiNQtzSCIsCV2z48dx2Inq1YTIDhHGcid3 0CZNe1KXXpuCiudEWnWAFn3lGWQjhGJbGlvSREKlEU01yqxWmgcPRgS8OZD9fGug 00OyM3kfFfDCXHw4rhehCEHzX7smt4kI+U/puGA+5cri3+nsVkZ53FExN1ryadIp ODFj3WzNx2ffHHXesFALCbeoE8CvVFSA5UqDwPnbjcnZ20awnfTRHfvqYMaD3ZSJ yrpo99OZvPlm8hd95vNgQaInICV0zOs/RbaisUTqRlXyB04nbNHgtjfCifQNUKvN bkGIDDGCO3yZBjSJYfVtwMSEzd0aCEjakb9tAf7GfXuQCLw/IAoSInlIwyJkxhjJ EmSn7cAmgq31DRwevWTcPPqBRSEUGjglNdD2cdBo/jGXT02LGnFnPQtoPNARn1J/ Cue07hRv3VXPBqs/wqhvxRpmvJO7YCUtDTmXwdKeN+h2aME0yBhJuf3oSWP4o2QX vRhHfGO43GRL/2xpe1btodcclhVJn8goU1egE4gkLgUJnAop6Puv27yCFuHiJ/9u 41sBcv/8po4= =XTT4 -----END PGP SIGNATURE----- --=-=-=-- From unknown Sun Aug 17 09:10:32 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 26 Nov 2020 12:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator