From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id qHaCCdtl/WIjwCgAWB0awg (envelope-from ) for ; Wed, 17 Aug 2022 18:04:11 -0400 Received: by simark.ca (Postfix, from userid 112) id 231F61E5EA; Wed, 17 Aug 2022 18:04:11 -0400 (EDT) Authentication-Results: simark.ca; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=embecosm.com header.i=@embecosm.com header.a=rsa-sha256 header.s=google header.b=cnZYIeTG; dkim-atps=neutral X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-2.7 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 Received: from sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id CF1351E13B for ; Wed, 17 Aug 2022 18:04:10 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 8AF613858C54 for ; Wed, 17 Aug 2022 22:04:10 +0000 (GMT) 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 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-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: , Cc: Simon Sobisch , Tom Tromey , Andrew Burgess Errors-To: gdb-patches-bounces+public-inbox=simark.ca@sourceware.org Sender: "Gdb-patches" 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