From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1256) id 96FB63858C00; Thu, 1 Sep 2022 10:31:10 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 96FB63858C00 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1662028270; bh=/HRjMwskXd++rst7dRls7ORokxlPeJf5rhS8DnDUD90=; h=From:To:Subject:Date:From; b=GdorEHLn5GSUb8L9OVzuqEPA7ja7dtuRVz40P4ZMPVDnpP6o79NEWtLI/ufxDQr/0 ZFO2QzA9vp0Js4CRG5MkjylpZs3KfRR+pZrl1tTuYj9rqBwIQ7xP6+phYdWRyc6Alt EKPlsriAyxIPT0uVdNAnrpvNrUNqKlWwtGHSk8FQ= Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: Maciej W. Rozycki To: gdb-cvs@sourceware.org Subject: [binutils-gdb] GDB/doc: Document the Guile `#:unlimited' keyword X-Act-Checkin: binutils-gdb X-Git-Author: Maciej W. Rozycki X-Git-Refname: refs/heads/master X-Git-Oldrev: be2057b902e834bba6fe7d3ded16177ec5624f3b X-Git-Newrev: 7b0d7ede79f548915641ac5916fbeb77fc9c44ff Message-Id: <20220901103110.96FB63858C00@sourceware.org> Date: Thu, 1 Sep 2022 10:31:10 +0000 (GMT) List-Id: https://sourceware.org/git/gitweb.cgi?p=3Dbinutils-gdb.git;h=3D7b0d7ede79f5= 48915641ac5916fbeb77fc9c44ff commit 7b0d7ede79f548915641ac5916fbeb77fc9c44ff Author: Maciej W. Rozycki Date: Thu Sep 1 11:30:18 2022 +0100 GDB/doc: Document the Guile `#:unlimited' keyword =20 Document the Guile `#:unlimited' keyword and deprecate the internal integer representation it corresponds to for integer parameters. Diff: --- gdb/doc/guile.texi | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/gdb/doc/guile.texi b/gdb/doc/guile.texi index 63916eed181..ba916009f74 100644 --- a/gdb/doc/guile.texi +++ b/gdb/doc/guile.texi @@ -2135,8 +2135,9 @@ Guile, true and false are represented using boolean c= onstants, and @samp{auto} is represented using @code{#:auto}. =20 @item PARAM_UINTEGER -The value is an unsigned integer. The value of 0 should be -interpreted to mean ``unlimited''. +The value is an unsigned integer. The value of @code{#:unlimited} +should be interpreted to mean ``unlimited'', and the value of @samp{0} +is reserved and should not be used. =20 @item PARAM_ZINTEGER The value is an integer. @@ -2145,9 +2146,10 @@ The value is an integer. The value is an unsigned integer. =20 @item PARAM_ZUINTEGER_UNLIMITED -The value is an integer in the range @samp{[0, INT_MAX]}. -A value of @samp{-1} means ``unlimited'', and other negative -numbers are not allowed. +The value is an integer in the range @samp{[0, INT_MAX]}. The value +of @code{#:unlimited} means ``unlimited'', the value of @samp{-1} is +reserved and should not be used, and other negative numbers are not +allowed. =20 @item PARAM_STRING The value is a string. When the user modifies the string, any escape