From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10052 invoked by alias); 15 Jun 2017 14:45:34 -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 8544 invoked by uid 89); 15 Jun 2017 14:45:14 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-6.5 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_1,SPF_PASS,T_RP_MATCHES_RCVD autolearn=ham version=3.3.2 spammy=documents X-HELO: eggs.gnu.org Received: from eggs.gnu.org (HELO eggs.gnu.org) (208.118.235.92) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 15 Jun 2017 14:45:11 +0000 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dLW1F-0007Iu-H8 for gdb-patches@sourceware.org; Thu, 15 Jun 2017 10:45:12 -0400 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:52600) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dLW1F-0007Im-Dd; Thu, 15 Jun 2017 10:45:09 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2973 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dLW1E-00013M-Q5; Thu, 15 Jun 2017 10:45:09 -0400 Date: Thu, 15 Jun 2017 14:45:00 -0000 Message-Id: <83eful2tu7.fsf@gnu.org> From: Eli Zaretskii To: Yao Qi CC: gdb-patches@sourceware.org In-reply-to: <86zid9tmle.fsf@gmail.com> (message from Yao Qi on Thu, 15 Jun 2017 14:19:25 +0100) Subject: Re: [PATCH 06/25] Generate c for feature instead of tdesc Reply-to: Eli Zaretskii References: <1497256916-4958-1-git-send-email-yao.qi@linaro.org> <1497256916-4958-7-git-send-email-yao.qi@linaro.org> <837f0h5kjz.fsf@gnu.org> <86wp8gccqv.fsf@gmail.com> <83h8zk3pu3.fsf@gnu.org> <86k24fdhvf.fsf@gmail.com> <83efun520e.fsf@gnu.org> <867f0ewne7.fsf@gmail.com> <83poe634za.fsf@gnu.org> <86zid9tmle.fsf@gmail.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-IsSubscribed: yes X-SW-Source: 2017-06/txt/msg00448.txt.bz2 > From: Yao Qi > Cc: gdb-patches@sourceware.org > Date: Thu, 15 Jun 2017 14:19:25 +0100 > > I update the paragraph for this command a little bit, > > @kindex maint print c-tdesc @r{[}@var{file}@r{]} > @item maint print c-tdesc > Print the target description (@pxref{Target Descriptions}) as > a C source file. By default, the target description is for the current > target, but if the optional argument @var{file} is provided, that file > is used to produce the description. The @var{file} should be an XML > document, of the form described in @ref{Target Description Format}. > The created source file is built into @value{GDBN} when @value{GDBN} is > built again. This command is used by developers after they add or > modify XML target descriptions. Thanks, this is good. > > If we remove them, there will be no place where they are documented, > > right? GDB developers are GDB users as well, e.g. I read the manual > > quite a lot. > > > > So I see no reason to remove these commands. We just need to indicate > > when a command makes sense only for GDB developers. > > but GDB users are not GDB developers. Why does user manual documents > some commands users never use? Because I expect GDB developers to look for commands they need to use in this manual. > IMO, these documents should be documented in GDB internals. AFAIU, GDB internals documents the GDB implementation, not commands and options that are used interactively within GDB.