From patchwork Wed Jul 8 16:45:01 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Burgess X-Patchwork-Id: 7584 Received: (qmail 129182 invoked by alias); 8 Jul 2015 16:45:14 -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 129143 invoked by uid 89); 8 Jul 2015 16:45:10 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-HELO: mail-wi0-f178.google.com Received: from mail-wi0-f178.google.com (HELO mail-wi0-f178.google.com) (209.85.212.178) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-GCM-SHA256 encrypted) ESMTPS; Wed, 08 Jul 2015 16:45:10 +0000 Received: by wiclp1 with SMTP id lp1so86178750wic.0 for ; Wed, 08 Jul 2015 09:45:07 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=Pq72EUw0S5+jKDVp2jjk2AI4FrIjnjlA122F1KJU/+k=; b=Ki30AeZFA7TEoR8pE3wxRu0XMndiAaozVeKGvSH0Dy8E2Xi1HHUaqVKZjgMn1wSBbL M4xygWRAmkwXIEh2h7PlXeHjczSb//+1ICz1nBXysTfvU92bTe4a7MZpH/Sz1gbOK3ie JotOfOHDkY1OIIkp3gwRHOZnr+XM7LijSU0Ij8eFmXBbEb7JlBXuID9Q7dJwkqmk/K3y QLVnvWCsw8mqQXfAXz0Y2xVlQVJVx2OfancJM2jTX9tafFRgOCgUZsnJRllO8+Q735AC AIviaky659CzNQ1LYZaEs353bnDMmcvIQ3y1JM1Bzkjec6M9uzWbJWgIViAInBI6RkLK QrlQ== X-Gm-Message-State: ALoCoQnTemS8wZyCXmmjRe0oj2YACsUL6y3kSDOwwS6s/s6UzueQZRjaq8RnzgqAq16Z/ZjKHOEc X-Received: by 10.180.11.68 with SMTP id o4mr18795318wib.10.1436373907164; Wed, 08 Jul 2015 09:45:07 -0700 (PDT) Received: from localhost (host81-158-4-174.range81-158.btcentralplus.com. [81.158.4.174]) by smtp.gmail.com with ESMTPSA id k16sm4351782wjr.7.2015.07.08.09.45.05 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 08 Jul 2015 09:45:06 -0700 (PDT) From: Andrew Burgess To: gdb-patches@sourceware.org Cc: Andrew Burgess Subject: [PATCH] gdb/doc: Update 'frame' command documentation. Date: Wed, 8 Jul 2015 17:45:01 +0100 Message-Id: <1436373901-2025-1-git-send-email-andrew.burgess@embecosm.com> X-IsSubscribed: yes The documentation for the 'frame' command has gotten a little out of date, it still mentions architecturally specific details that are no longer relevant. This commit removes the old details that no longer apply, and tries to expand the existing text a little to make the usage clearer for some cases. gdb/doc/ChangeLog: * gdb.texinfo (Selection): Update documentation for 'frame' command. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 18 +++++------------- 2 files changed, 10 insertions(+), 13 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 18d9039..cf37489 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2015-07-08 Andrew Burgess + + * gdb.texinfo (Selection): Update documentation for 'frame' + command. + 2015-07-02 Markus Metzger * gdb.texinfo (Maintenance Commands): Document "maint btrace" diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index eec4dce..9e2ecd1 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -7320,22 +7320,14 @@ Select frame number @var{n}. Recall that frame zero is the innermost innermost one, and so on. The highest-numbered frame is the one for @code{main}. -@item frame @var{addr} -@itemx f @var{addr} -Select the frame at address @var{addr}. This is useful mainly if the +@item frame @var{stack-addr} [ @var{pc-addr} ] +@itemx f @var{stack-addr} [ @var{pc-addr} ] +Select the frame at address @var{stack-addr}. This is useful mainly if the chaining of stack frames has been damaged by a bug, making it impossible for @value{GDBN} to assign numbers properly to all frames. In addition, this can be useful when your program has multiple stacks and -switches between them. - -On the SPARC architecture, @code{frame} needs two addresses to -select an arbitrary frame: a frame pointer and a stack pointer. - -On the @acronym{MIPS} and Alpha architecture, it needs two addresses: a stack -pointer and a program counter. - -On the 29k architecture, it needs three addresses: a register stack -pointer, a program counter, and a memory stack pointer. +switches between them. The optional @var{pc-addr} can also be given to +specify the value of PC for the stack frame. @kindex up @item up @var{n}