From patchwork Wed Sep 12 23:37:07 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: John Baldwin X-Patchwork-Id: 29349 Received: (qmail 54561 invoked by alias); 12 Sep 2018 23:37:37 -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 54449 invoked by uid 89); 12 Sep 2018 23:37:36 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-25.2 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, SPF_HELO_PASS, SPF_SOFTFAIL autolearn=ham version=3.3.2 spammy=debugged, rights X-HELO: mail.baldwin.cx Received: from bigwig.baldwin.cx (HELO mail.baldwin.cx) (96.47.65.170) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 12 Sep 2018 23:37:34 +0000 Received: from ralph.com (ralph.baldwin.cx [66.234.199.215]) by mail.baldwin.cx (Postfix) with ESMTPSA id AF73510B682 for ; Wed, 12 Sep 2018 19:37:32 -0400 (EDT) From: John Baldwin To: gdb-patches@sourceware.org Subject: [PATCH v2 6/6] Make the "info proc" documentation more consistent. Date: Wed, 12 Sep 2018 16:37:07 -0700 Message-Id: <20180912233707.43492-7-jhb@FreeBSD.org> In-Reply-To: <20180912233707.43492-1-jhb@FreeBSD.org> References: <20180912233707.43492-1-jhb@FreeBSD.org> X-IsSubscribed: yes Remove "running" in a few places since "info proc" can be used with core dumps as well as running processes on both Linux and FreeBSD. Use "the specified process" in the description of most "info proc" subcommands. Use "additional information" instead of "/proc process information" in the "info proc" description to more closely match the language in the manual. gdb/ChangeLog: * infcmd.c (_initialize_infcmd): Remove "running" from "info proc" description. Make "info proc" command descriptions more consistent. gdb/doc/ChangeLog: * gdb.texinfo (info proc): Remove "running". (info proc mappings): Replace "program" with "process". --- gdb/ChangeLog | 6 ++++++ gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 4 ++-- gdb/infcmd.c | 12 ++++++------ 4 files changed, 19 insertions(+), 8 deletions(-) diff --git a/gdb/ChangeLog b/gdb/ChangeLog index fe515b2d0e..b4c6cb64bf 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,9 @@ +2018-09-12 John Baldwin + + * infcmd.c (_initialize_infcmd): Remove "running" from "info proc" + description. Make "info proc" command descriptions more + consistent. + 2018-09-12 John Baldwin * NEWS: Mention 'info proc files' command. diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index e327480af0..e88e047ff0 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2018-09-12 John Baldwin + + * gdb.texinfo (info proc): Remove "running". + (info proc mappings): Replace "program" with "process". + 2018-09-12 John Baldwin * gdb.texinfo (Process Information): Document "info proc files" diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index e0e1379abd..9da6e9ba39 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -22215,7 +22215,7 @@ systems. @cindex process ID @item info proc @itemx info proc @var{process-id} -Summarize available information about any running process. If a +Summarize available information about a process. If a process ID is specified by @var{process-id}, display information about that process; otherwise display information about the program being debugged. The summary includes the debugged process ID, the command @@ -22276,7 +22276,7 @@ Open files: @item info proc mappings @cindex memory address space mappings -Report the memory address space ranges accessible in the program. On +Report the memory address space ranges accessible in a process. On Solaris and FreeBSD systems, each memory range includes information on whether the process has read, write, or execute access rights to each range. On @sc{gnu}/Linux and FreeBSD systems, each memory range diff --git a/gdb/infcmd.c b/gdb/infcmd.c index 5fcb872c98..ab7ae60f4f 100644 --- a/gdb/infcmd.c +++ b/gdb/infcmd.c @@ -3522,13 +3522,13 @@ in the named register groups.")); add_prefix_cmd ("proc", class_info, info_proc_cmd, _("\ -Show /proc process information about any running process.\n\ +Show additional information about a process.\n\ Specify any process id, or use the program being debugged by default."), &info_proc_cmdlist, "info proc ", 1/*allow-unknown*/, &infolist); add_cmd ("mappings", class_info, info_proc_cmd_mappings, _("\ -List of mapped memory regions."), +List memory regions mapped by the specified process."), &info_proc_cmdlist); add_cmd ("stat", class_info, info_proc_cmd_stat, _("\ @@ -3540,15 +3540,15 @@ List process info from /proc/PID/status."), &info_proc_cmdlist); add_cmd ("cwd", class_info, info_proc_cmd_cwd, _("\ -List current working directory of the process."), +List current working directory of the specified process."), &info_proc_cmdlist); add_cmd ("cmdline", class_info, info_proc_cmd_cmdline, _("\ -List command line arguments of the process."), +List command line arguments of the specified process."), &info_proc_cmdlist); add_cmd ("exe", class_info, info_proc_cmd_exe, _("\ -List absolute filename for executable of the process."), +List absolute filename for executable of the specified process."), &info_proc_cmdlist); add_cmd ("files", class_info, info_proc_cmd_files, _("\ @@ -3556,6 +3556,6 @@ List files opened by the specified process."), &info_proc_cmdlist); add_cmd ("all", class_info, info_proc_cmd_all, _("\ -List all available /proc info."), +List all available info about the specified process."), &info_proc_cmdlist); }