From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-lf1-x12e.google.com (mail-lf1-x12e.google.com [IPv6:2a00:1450:4864:20::12e]) by sourceware.org (Postfix) with ESMTPS id E72293858292 for ; Wed, 17 Aug 2022 22:03:58 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org E72293858292 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=embecosm.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=embecosm.com Received: by mail-lf1-x12e.google.com with SMTP id z25so20708966lfr.2 for ; Wed, 17 Aug 2022 15:03:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=embecosm.com; s=google; h=mime-version:user-agent:references:message-id:in-reply-to:subject :cc:to:from:date:from:to:cc; bh=I5vnzfdwPSPZAWe0GrT4xUUsY2LNzuPj23giEg2wNV0=; b=cnZYIeTG9ngljjFdmTBH6e57qSp6VzYLMxCaH+ZFwqz5hTrIn2LZCRNJpDCb25ny6D VcWd/FQYHxARIjnT/FmHrbnBsU1lOi73z/EzxgxM1rX6mS6DAiBDPIbqyy8ux+HAf1E7 fpqCnI4OlakV8xoqDEd/wp76OrlQOeJq+Gx2750Yko6qV++8pBLP3n804Zuegssr7MPl AKzZ05Z6/pbQKXIGrt+U3oGWT8EC9atrrHoc3QNZXeqY4cSsksWUS3xSfbJjaGFf8jF5 QRuJz/G4pBxSklPC84gDIc36nzPebfDOtstWPoZBu2EXjG8YirJflxnfKy4eIEhJGExy Oykw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=mime-version:user-agent:references:message-id:in-reply-to:subject :cc:to:from:date:x-gm-message-state:from:to:cc; bh=I5vnzfdwPSPZAWe0GrT4xUUsY2LNzuPj23giEg2wNV0=; b=YPyUg85iEze6W1ZTCEjGSvEJ69wHvFiG+P7zlZoEKdNyZEU7lEPaGD7OLWcA97kyv7 Rc8Hyv2CN66gb8C4cJrvpNXtGiS9HRLhIrE1p6kZZrEIRuNVd7CEqRgqZ7yFQhMdBF+A uf2TFWIttRMkdsgUMpwk2geMd2AGHN+fG7VqH4d4/lzwn8QwB6KS4IMSPOyIt+QPHYZ2 of70LvQmAyp2q9eiDY9Eyf5i2GR0v6OudqrJyaWtHZjMPD+1VPcDm8MRTHhFplTOEjHY YOJf0IxI2aZ6ckT4JBa+/9qwNDqckefwWQthpmjQatd8wqBf4ykdkR3lxgwSa/HKmgoB cFjA== X-Gm-Message-State: ACgBeo0S6ZF95ftkVRmcScr63sRIsSx5iqGzbUOMvKw+54rwYNsQCsgY SGumhRzsFfj2kA1WGxeY7A3QLncfkohlVSHL X-Google-Smtp-Source: AA6agR4U5Fw9XswADpr2YdgiWHBFBd7MZW2+uKFuENPVS1eQ0Jt73pBCKDVcZ5Mc62PtA6fE4VS3Sw== X-Received: by 2002:a05:6512:32c7:b0:491:e313:544c with SMTP id f7-20020a05651232c700b00491e313544cmr57777lfg.477.1660773837599; Wed, 17 Aug 2022 15:03:57 -0700 (PDT) Received: from [192.168.219.3] ([78.8.192.131]) by smtp.gmail.com with ESMTPSA id n26-20020a05651203fa00b0048b0526070fsm1837296lfq.71.2022.08.17.15.03.56 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 17 Aug 2022 15:03:57 -0700 (PDT) Date: Wed, 17 Aug 2022 23:03:54 +0100 (BST) From: "Maciej W. Rozycki" To: gdb-patches@sourceware.org cc: Andrew Burgess , Simon Marchi , Tom Tromey , Simon Sobisch Subject: [PATCH v6 2/8] GDB/doc: Document the Guile `#:unlimited' keyword In-Reply-To: Message-ID: References: User-Agent: Alpine 2.20 (DEB 67 2015-01-07) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII X-Spam-Status: No, score=-2.5 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 17 Aug 2022 22:04:00 -0000 Document the Guile `#:unlimited' keyword and deprecate the internal integer representation it corresponds to for integer parameters. --- New change in v6. --- gdb/doc/guile.texi | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) gdb-doc-guile-param-xinteger.diff Index: src/gdb/doc/guile.texi =================================================================== --- src.orig/gdb/doc/guile.texi +++ src/gdb/doc/guile.texi @@ -2135,8 +2135,9 @@ Guile, true and false are represented us @samp{auto} is represented using @code{#:auto}. @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. @item PARAM_ZINTEGER The value is an integer. @@ -2145,9 +2146,10 @@ The value is an integer. The value is an unsigned integer. @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. @item PARAM_STRING The value is a string. When the user modifies the string, any escape