From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 22496 invoked by alias); 3 Nov 2013 05:57:36 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 22460 invoked by uid 89); 3 Nov 2013 05:57:35 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.6 required=5.0 tests=AWL,BAYES_00,RDNS_NONE,URIBL_BLOCKED autolearn=no version=3.3.2 X-HELO: relay1.mentorg.com Received: from Unknown (HELO relay1.mentorg.com) (192.94.38.131) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sun, 03 Nov 2013 05:56:32 +0000 Received: from svr-orw-exc-10.mgc.mentorg.com ([147.34.98.58]) by relay1.mentorg.com with esmtp id 1Vcqf8-00020Y-AL from Yao_Qi@mentor.com for gdb-patches@sourceware.org; Sat, 02 Nov 2013 22:55:50 -0700 Received: from SVR-ORW-FEM-02.mgc.mentorg.com ([147.34.96.206]) by SVR-ORW-EXC-10.mgc.mentorg.com with Microsoft SMTPSVC(6.0.3790.4675); Sat, 2 Nov 2013 22:55:50 -0700 Received: from qiyao.dyndns.org (147.34.91.1) by svr-orw-fem-02.mgc.mentorg.com (147.34.96.168) with Microsoft SMTP Server id 14.2.247.3; Sat, 2 Nov 2013 22:55:49 -0700 From: Yao Qi To: Subject: [PATCH 04/10] Don't stress 'remote' in "Data Caching" in doc Date: Sun, 03 Nov 2013 05:57:00 -0000 Message-ID: <1383458049-20893-5-git-send-email-yao@codesourcery.com> In-Reply-To: <1383458049-20893-1-git-send-email-yao@codesourcery.com> References: <1383458049-20893-1-git-send-email-yao@codesourcery.com> MIME-Version: 1.0 Content-Type: text/plain X-IsSubscribed: yes X-SW-Source: 2013-11/txt/msg00039.txt.bz2 When I try to describe the cache and its related commands (in a cache-per-address-space world), I find hard to add, because existing doc is focused on remote debugging, while data cache is used regardless of the target. More precisely, GDB caches target data, instead of remote data. gdb/doc: 2013-11-02 Yao Qi * gdb.texinfo (Data): Rename menu item. (Caching Remote Data): Rename to ... (Caching Target Data): ... it. Update. --- gdb/doc/gdb.texinfo | 18 +++++++++--------- 1 files changed, 9 insertions(+), 9 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 28e6ff9..4d72983 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -8064,7 +8064,7 @@ being passed the type of @var{arg} as the argument. * Core File Generation:: Cause a program dump its core * Character Sets:: Debugging programs that use a different character set than GDB does -* Caching Remote Data:: Data caching for remote targets +* Caching Target Data:: Data caching for targets * Searching Memory:: Searching memory for a sequence of bytes @end menu @@ -10808,13 +10808,13 @@ $10 = 78 '+' The @sc{ibm1047} character set uses the number 78 to encode the @samp{+} character. -@node Caching Remote Data -@section Caching Data of Remote Targets -@cindex caching data of remote targets +@node Caching Target Data +@section Caching Data of Targets +@cindex caching data of targets -@value{GDBN} caches data exchanged between the debugger and a -remote target (@pxref{Remote Debugging}). Such caching generally improves -performance, because it reduces the overhead of the remote protocol by +@value{GDBN} caches data exchanged between the debugger and a target. +Such caching generally improves performance in @ref{Remote Debugging}, +because it reduces the overhead of the remote protocol by bundling memory reads and writes into large chunks. Unfortunately, simply caching everything would lead to incorrect results, since @value{GDBN} does not necessarily know anything about volatile values, memory-mapped I/O @@ -10873,11 +10873,11 @@ Must be a power of 2. @item show dcache size @kindex show dcache size -Show maximum number of dcache entries. See also @ref{Caching Remote Data, info dcache}. +Show maximum number of dcache entries. See also @ref{Caching Target Data, info dcache}. @item show dcache line-size @kindex show dcache line-size -Show default size of dcache lines. See also @ref{Caching Remote Data, info dcache}. +Show default size of dcache lines. See also @ref{Caching Target Data, info dcache}. @end table -- 1.7.7.6