From patchwork Mon Aug 8 20:42:54 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Doug Evans X-Patchwork-Id: 14431 Received: (qmail 12486 invoked by alias); 8 Aug 2016 20:43:06 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Delivered-To: mailing list gdb-patches@sourceware.org Received: (qmail 12475 invoked by uid 89); 8 Aug 2016 20:43:05 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.8 required=5.0 tests=AWL, BAYES_00, RCVD_IN_DNSWL_LOW, RP_MATCHES_RCVD, SPF_PASS autolearn=ham version=3.3.2 spammy=H*Ad:U*eliz, HTo:U*eliz, H*MI:sk:94eb2c0, H*M:sk:94eb2c0 X-HELO: mail-pa0-f74.google.com Received: from mail-pa0-f74.google.com (HELO mail-pa0-f74.google.com) (209.85.220.74) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-GCM-SHA256 encrypted) ESMTPS; Mon, 08 Aug 2016 20:42:55 +0000 Received: by mail-pa0-f74.google.com with SMTP id eq16so6090144pac.0 for ; Mon, 08 Aug 2016 13:42:55 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:message-id:date:subject:from:to; bh=XzXOFwKaZR760HroWqkbDb8gPopBDw5wMm2LK5tn2Gw=; b=bMKU/bbLflFc4ZABIc/c31gU2/OePm9ydaRMcr6e0sZK0UGSdNsvxuIL1Z9iEGQCHu wO89uqzd/MRmQ+dALr0q7RowonqDiWb38/j0n6tIHXaQ76ZPe1bz3O+kWnOB4u7RXrTa 9KqtiA64BQIkoIoiVjReGWFI3rZ5uePD9UHFZBSzBXbXQQUhdaAglOHPbb3PkY4YCiaA 8JJQWrQhaug6mpi5Bm9WF3RVMTvMmdrgD5HKradG6caLVh/vvXlr3oIQ3oq8YxvqNChp Tl7vD8wM9omwOh5oyFx+RV9bS5HUlBR2QO2BzShCHIm/5B03+BDcXVn8r9oJuQ+aQACB cDSg== X-Gm-Message-State: AEkoous5UENaJ6rPhzEP/YXu90lw0/sInpWFqJolNb26Fwdpzl2C7gjUYe8oZKIvJLcHH+updb+jxkgu2PEwzAXHVNBg0HIAWqp46u8nI2EIew4sfuNrTG13JnyLxoYMa5JkTnHehGwu6/x/J8fxemyANOUdyjdNuwXIQzPCXAk4rozKtXgJkA== MIME-Version: 1.0 X-Received: by 10.98.82.72 with SMTP id g69mr80626188pfb.14.1470688974073; Mon, 08 Aug 2016 13:42:54 -0700 (PDT) Message-ID: <94eb2c03c9eee0432205399575cf@google.com> Date: Mon, 08 Aug 2016 20:42:54 +0000 Subject: [doc PATCH] Fix backward compatibility in target feature specs From: Doug Evans To: gdb-patches@sourceware.org, eliz@gnu.org, palves@redhat.com X-IsSubscribed: yes Hi. This is a follow-on to these two patches: https://sourceware.org/ml/gdb-patches/2016-08/msg00105.html https://sourceware.org/ml/gdb-patches/2016-08/msg00106.html to update the documentation. 2016-08-08 Doug Evans * gdb.texinfo (Target Description Format): Update docs on "end" field spec and field default type. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index f5dde61..0b5ec39 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -40681,16 +40681,13 @@ Bitfield values may be named with the empty string, @samp{""}, in which case the field is ``filler'' and its value is not printed. Not all bits need to be specified, so ``filler'' fields are optional. -The @var{start} value is required, and @var{end} and @var{type} -are optional. +The @var{start} and @var{end} values are required, and @var{type} +is optional. The field's @var{start} must be less than or equal to its @var{end}, and zero represents the least significant bit. -The default value of @var{end} is @var{start}, a single bit field. -The default value of @var{type} depends on whether the -@var{end} was specified. If @var{end} is specified then the default -value of @var{type} is an unsigned integer. If @var{end} is unspecified -then the default value of @var{type} is @code{bool}. +The default value of @var{type} is @code{bool} for single bit fields, +and an unsigned integer otherwise. Which to choose? Structures or flags?