public inbox for frysk-cvs@sourceware.org
help / color / mirror / Atom feed
From: cagney@sourceware.org
To: frysk-cvs@sourceware.org
Subject: [SCM] master: Add version and common options; tidy up.
Date: Wed, 02 Apr 2008 22:17:00 -0000 [thread overview]
Message-ID: <20080402221711.27249.qmail@sourceware.org> (raw)
The branch, master has been updated
via 46d2f6c9241d74c5ce051beed0687143209f80a7 (commit)
from 4460603b1eb3abdcf12478a5e01334a9cf7a8545 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email.
- Log -----------------------------------------------------------------
commit 46d2f6c9241d74c5ce051beed0687143209f80a7
Author: Andrew Cagney <cagney@redhat.com>
Date: Wed Apr 2 18:14:48 2008 -0400
Add version and common options; tidy up.
frysk-common/ChangeLog
2008-04-02 Andrew Cagney <cagney@redhat.com>
* Makefile.gen.sh (.xml): Recognize ENTITY volumes and names.
frysk-core/frysk/bindir/ChangeLog
2008-04-02 Andrew Cagney <cagney@redhat.com>
* fstack.xml: Use a title and volume entity.
* fauxv.xml: Add standard options and version.
* fmaps.xml: Ditto.
* fhpd.xml: Ditto.
* fdebuginfo.xml: Ditto.
* fdebugrpm.xml: Ditto.
* fcore.xml: Ditto.
* fexe.xml: Ditto.
* ferror.xml: Add standard and stack options; and version.
* fcatch.xml: Ditto.
* ftrace.xml: Ditto.
frysk-core/frysk/util/ChangeLog
2008-04-02 Andrew Cagney <cagney@redhat.com>
* stack-options.xml: Make refsect2.
* standard-options.xml: Ditto.
frysk-gui/frysk/bindir/ChangeLog
2008-04-02 Andrew Cagney <cagney@redhat.com>
* frysk.xml: Add version and standard options.
frysk-gui/frysk/pkglibdir/ChangeLog
2008-04-02 Andrew Cagney <cagney@redhat.com>
* funit.xml: Add version and standard options.
-----------------------------------------------------------------------
Summary of changes:
frysk-common/ChangeLog | 4 +
frysk-common/Makefile.gen.sh | 10 ++-
frysk-core/frysk/bindir/ChangeLog | 14 +++
frysk-core/frysk/bindir/fauxv.xml | 122 +++++++----------------
frysk-core/frysk/bindir/fcatch.xml | 118 ++++++++--------------
frysk-core/frysk/bindir/fcore.xml | 151 ++++++++++------------------
frysk-core/frysk/bindir/fdebuginfo.xml | 144 ++++++++++-----------------
frysk-core/frysk/bindir/fdebugrpm.xml | 137 +++++++++----------------
frysk-core/frysk/bindir/ferror.xml | 114 ++++++++-------------
frysk-core/frysk/bindir/fexe.xml | 114 +++++++++------------
frysk-core/frysk/bindir/fhpd.xml | 125 +++++++++--------------
frysk-core/frysk/bindir/fmaps.xml | 130 ++++++++----------------
frysk-core/frysk/bindir/fstack.xml | 89 +++++-----------
frysk-core/frysk/bindir/fstep.xml | 112 +++++++--------------
frysk-core/frysk/bindir/ftrace.xml | 21 +++-
frysk-core/frysk/util/ChangeLog | 5 +
frysk-core/frysk/util/stack-options.xml | 81 ++++++++-------
frysk-core/frysk/util/standard-options.xml | 61 ++++++-----
frysk-gui/frysk/bindir/ChangeLog | 4 +
frysk-gui/frysk/bindir/frysk.xml | 101 ++++---------------
frysk-gui/frysk/pkglibdir/ChangeLog | 4 +
frysk-gui/frysk/pkglibdir/funit.xml | 89 ++++-------------
22 files changed, 645 insertions(+), 1105 deletions(-)
First 500 lines of diff:
diff --git a/frysk-common/ChangeLog b/frysk-common/ChangeLog
index ce6ebd0..1165e19 100644
--- a/frysk-common/ChangeLog
+++ b/frysk-common/ChangeLog
@@ -1,3 +1,7 @@
+2008-04-02 Andrew Cagney <cagney@redhat.com>
+
+ * Makefile.gen.sh (.xml): Recognize ENTITY volumes and names.
+
2008-03-31 Andrew Cagney <cagney@redhat.com>
* manpages.sh: Handle @abs_root_srcdir@.
diff --git a/frysk-common/Makefile.gen.sh b/frysk-common/Makefile.gen.sh
index 21a4a1f..e8628a6 100755
--- a/frysk-common/Makefile.gen.sh
+++ b/frysk-common/Makefile.gen.sh
@@ -619,11 +619,15 @@ do
*dir/* )
# Only programs in bindir, pkglibdir et.al. get man pages.
# extract the section number
- n=`sed -n -e 's,.*<manvolnum>\([0-9]\)</manvolnum>.*,\1,p' < $xml`
+ n=`sed -n < $xml \
+ -e 's,.*<manvolnum>\([0-9]\)</manvolnum>.*,\1,p' \
+ -e 's,.*ENTITY volume "\([0-9]\)".*,\1,p'`
d=`dirname $xml`
# And the possible list of names.
- sed -n -e 's,^.*<refname>\(.*\)</refname>.*$,\1,p' < $xml \
- | while read title ; do
+ sed -n < $xml \
+ -e 's,^.*<refname>\(.*\)</refname>.*$,\1,p' \
+ -e 's,.*ENTITY command "\([^"]*\)".*,\1,p' \
+ | sort -u | while read title ; do
# Need to generate explicit rules
cat <<EOF
man_MANS += ${d}/${title}.${n}
diff --git a/frysk-core/frysk/bindir/ChangeLog b/frysk-core/frysk/bindir/ChangeLog
index e11cb6d..d6c3ab7 100644
--- a/frysk-core/frysk/bindir/ChangeLog
+++ b/frysk-core/frysk/bindir/ChangeLog
@@ -1,3 +1,17 @@
+2008-04-02 Andrew Cagney <cagney@redhat.com>
+
+ * fstack.xml: Use a title and volume entity.
+ * fauxv.xml: Add standard options and version.
+ * fmaps.xml: Ditto.
+ * fhpd.xml: Ditto.
+ * fdebuginfo.xml: Ditto.
+ * fdebugrpm.xml: Ditto.
+ * fcore.xml: Ditto.
+ * fexe.xml: Ditto.
+ * ferror.xml: Add standard and stack options; and version.
+ * fcatch.xml: Ditto.
+ * ftrace.xml: Ditto.
+
2008-04-01 Andrew Cagney <cagney@redhat.com>
* TestFstack.java: Ditto.
diff --git a/frysk-core/frysk/bindir/fauxv.xml b/frysk-core/frysk/bindir/fauxv.xml
index 301ecce..3da4cdc 100644
--- a/frysk-core/frysk/bindir/fauxv.xml
+++ b/frysk-core/frysk/bindir/fauxv.xml
@@ -44,128 +44,80 @@
-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
-
-<!-- http://docbook.sourceforge.net/snapshots/xsl/manpages/README -->
-
-<refentry id="fauxv">
+ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
+ [
+ <!ENTITY stackoptions SYSTEM "@abs_root_srcdir@/frysk-core/frysk/util/stack-options.xml">
+ <!ENTITY standardoptions SYSTEM "@abs_root_srcdir@/frysk-core/frysk/util/standard-options.xml">
+ <!ENTITY version SYSTEM "@abs_root_srcdir@/common/version.in">
+ <!ENTITY command "fauxv">
+ <!ENTITY volume "1">
+ ]
+>
+
+<refentry>
<refentryinfo>
- <title>fauxv</title>
- <date>March 14 2008</date>
+ <title>Frysk</title>
+ <date>April 2008</date>
</refentryinfo>
<refmeta>
- <refentrytitle>fauxv</refentrytitle>
- <manvolnum>1</manvolnum>
+ <refentrytitle>&command;</refentrytitle>
+ <manvolnum>&volume;</manvolnum>
+ <refmiscinfo class='source'>Frysk</refmiscinfo>
+ <refmiscinfo class='version'>&version;</refmiscinfo>
</refmeta>
<refnamediv>
<refname>fauxv</refname>
- <refpurpose>Prints out a process or a corefile's auxv data.</refpurpose>
+ <refpurpose>print the auxiliary vector</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
- <command>fauxv</command>
- <arg choice="opt">
- <option>--console <replaceable>LOG=LEVEL,...</replaceable></option>
- </arg>
+ <command>&command;</command>
<arg choice="opt">
- <option>--log <replaceable>LOG=LEVEL,...</replaceable></option>
- </arg>
- <arg rep="repeat" choice="plain">
- <replaceable>pids corefile</replaceable>
+ <replaceable>options</replaceable>
</arg>
+ <group choice="req">
+ <arg rep="repeat" choice="plain">
+ <replaceable>pid</replaceable>
+ </arg>
+ <arg rep="repeat" choice="plain">
+ <arg choice="plain">
+ <replaceable>core-file</replaceable>
+ </arg>
+ <arg choice="opt">
+ <replaceable>core-executable</replaceable>
+ </arg>
+ </arg>
+ </group>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
- <para><function>fauxv</function> Executes the frysk axuv dump utility.</para>
+ <para><function>fauxv</function>prints the auxiliary vector of the
+ specified process or core-file.</para>
- <para>fauxv is a utility that prints out a process or a corefile's auxv data. </para>
+ &standardoptions;
- <variablelist>
- <varlistentry>
- <term><option>--console <replaceable>LOG=LEVEL,...</replaceable></option></term>
- <listitem>
- <para> Enable logging to the console and at the specified
- log level. The log level can be: [ OFF | SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST]. </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>--log <replaceable>LOG=LEVEL,...</replaceable></option></term>
- <listitem>
- <para> Specify the file logging level. The log level can be: [ OFF | SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST].</para>
- </listitem>
- </varlistentry>
- </variablelist>
</refsect1>
- <!-- refsect1>
- <title>EXIT STATUS</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>RETURN VALUES</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>ENVIRONMENT</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>FILES</title>
- <para></para>
- </refsect1 -->
-
<refsect1>
<title>EXAMPLE</title>
- <screen>fauxv pid [...]</screen>
+ <screen>&command; 1234</screen>
</refsect1>
-
- <!-- refsect1>
- <title>DIAGNOSTICS</title>
- <para></para>
- </refsect1 -->
- <!-- refsect1>
- <title>ERRORS</title>
- <para></para>
- </refsect1 -->
-
<refsect1>
<title>SEE ALSO</title>
<para>frysk(7)</para>
</refsect1>
- <!-- refsect1>
- <title>STANDARDS</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>HISTORY</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>AUTHORS</title>
- <para></para>
- </refsect1 -->
-
<refsect1>
<title>BUGS</title>
<para>Report bugs to <ulink url="http://sourceware.org/frysk"/></para>
</refsect1>
- <!-- refsect1>
- <title>SECURITY CONSIDERATIONS</title>
- </refsect1 -->
-
</refentry>
diff --git a/frysk-core/frysk/bindir/fcatch.xml b/frysk-core/frysk/bindir/fcatch.xml
index d5da946..52dd1df 100644
--- a/frysk-core/frysk/bindir/fcatch.xml
+++ b/frysk-core/frysk/bindir/fcatch.xml
@@ -44,118 +44,80 @@
-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
-
-<!-- http://docbook.sourceforge.net/snapshots/xsl/manpages/README -->
-
-<refentry id="fcatch">
+ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
+ [
+ <!ENTITY stackoptions SYSTEM "@abs_root_srcdir@/frysk-core/frysk/util/stack-options.xml">
+ <!ENTITY standardoptions SYSTEM "@abs_root_srcdir@/frysk-core/frysk/util/standard-options.xml">
+ <!ENTITY version SYSTEM "@abs_root_srcdir@/common/version.in">
+ <!ENTITY command "fcatch">
+ <!ENTITY volume "1">
+ ]
+>
+
+<refentry>
<refentryinfo>
- <title>fcatch</title>
- <date>March 14 2008</date>
+ <title>Frysk</title>
+ <date>April 2008</date>
</refentryinfo>
<refmeta>
- <refentrytitle>fcatch</refentrytitle>
- <manvolnum>1</manvolnum>
+ <refentrytitle>&command;</refentrytitle>
+ <manvolnum>&volume;</manvolnum>
+ <refmiscinfo class='source'>Frysk</refmiscinfo>
+ <refmiscinfo class='version'>&version;</refmiscinfo>
</refmeta>
<refnamediv>
<refname>fcatch</refname>
- <refpurpose>Runs the frysk application crash and signal stack tracing utility</refpurpose>
+ <refpurpose>print a stack back-trace of a program as it crashes</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
- <command>fcatch [OPTIONS] -- PATH ARGS</command>
- <!-- arg choice="opt">
- <option>-list of options</option>
- </arg -->
+ <command>&command;</command>
+ <arg choice="opt">
+ <replaceable>options</replaceable>
+ </arg>
+ <group choice="req">
+ <arg choice="plain">
+ <arg choice="plain">
+ <replaceable>program</replaceable>
+ </arg>
+ <arg rep="repeat" choice="plain">
+ <replaceable>arg</replaceable>
+ </arg>
+ </arg>
+ </group>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
- <para><function>fcatch</function> Runs the frysk application crash stack tracing utility</para>
+ <para><function>fcatch</function> generate stack backtraces from a
+ running application as it crashes, or upon receiving a variety of
+ signals.</para>
- <para>fcatch is a small utility that uses the frysk engine to generate stack backtraces from an application crash, or upon receiving a variety of signals.</para>
+ &stackoptions;
+ &standardoptions;
- <!-- variablelist>
- <varlistentry>
- <term>-option <replaceable>option-argument</replaceable></term>
- <listitem>
- <para> Description of option. </para>
-
- </listitem>
- </varlistentry>
- <varlistentry>...</varlistentry>
- </variablelist -->
</refsect1>
- <!-- refsect1>
- <title>EXIT STATUS</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>RETURN VALUES</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>ENVIRONMENT</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>FILES</title>
- <para></para>
- </refsect1 -->
-
<refsect1>
<title>EXAMPLE</title>
- <screen>fcatch /usr/bin/foo</screen>
- <screen>fcatch -p [PID]</screen>
+ <screen>&command; 1234</screen>
+ <screen>&command; /usr/bin/foo</screen>
</refsect1>
-
- <!-- refsect1>
- <title>DIAGNOSTICS</title>
- <para></para>
- </refsect1 -->
- <!-- refsect1>
- <title>ERRORS</title>
- <para></para>
- </refsect1 -->
-
<refsect1>
<title>SEE ALSO</title>
- <para>frysk(8)</para>
+ <para>frysk(7)</para>
</refsect1>
- <!-- refsect1>
- <title>STANDARDS</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>HISTORY</title>
- <para></para>
- </refsect1 -->
-
- <!-- refsect1>
- <title>AUTHORS</title>
- <para></para>
- </refsect1 -->
-
<refsect1>
<title>BUGS</title>
<para>Report bugs to <ulink url="http://sourceware.org/frysk"/></para>
</refsect1>
- <!-- refsect1>
- <title>SECURITY CONSIDERATIONS</title>
- </refsect1 -->
-
</refentry>
diff --git a/frysk-core/frysk/bindir/fcore.xml b/frysk-core/frysk/bindir/fcore.xml
index 840fb87..bcc705f 100644
--- a/frysk-core/frysk/bindir/fcore.xml
+++ b/frysk-core/frysk/bindir/fcore.xml
@@ -44,159 +44,110 @@
-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
- "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
-
-<!-- http://docbook.sourceforge.net/snapshots/xsl/manpages/README -->
-
-<refentry id="fcore">
+ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
+ [
+ <!ENTITY stackoptions SYSTEM "@abs_root_srcdir@/frysk-core/frysk/util/stack-options.xml">
+ <!ENTITY standardoptions SYSTEM "@abs_root_srcdir@/frysk-core/frysk/util/standard-options.xml">
+ <!ENTITY version SYSTEM "@abs_root_srcdir@/common/version.in">
+ <!ENTITY command "fcore">
+ <!ENTITY volume "1">
+ ]
+>
+
+<refentry>
<refentryinfo>
- <title>fcore</title>
- <date>March 14 2008</date>
+ <title>Frysk</title>
+ <date>April 2008</date>
</refentryinfo>
<refmeta>
- <refentrytitle>fcore</refentrytitle>
- <manvolnum>1</manvolnum>
+ <refentrytitle>&command;</refentrytitle>
+ <manvolnum>&volume;</manvolnum>
+ <refmiscinfo class='source'>Frysk</refmiscinfo>
+ <refmiscinfo class='version'>&version;</refmiscinfo>
</refmeta>
<refnamediv>
<refname>fcore</refname>
- <refpurpose>Runs the frysk core dump utility.</refpurpose>
+ <refpurpose>extract a core file from a process</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
- <command>fcore</command>
- <arg choice="opt">
- <option>-a </option>
- </arg>
- <arg choice="opt">
- <option>-s </option>
- </arg>
- <arg choice="opt">
- <option>-o <replaceable>filename</replaceable></option>
- </arg>
+ <command>&command;</command>
<arg choice="opt">
- <option>--console <replaceable>LOG=LEVEL,...</replaceable></option>
- </arg>
- <arg choice="opt">
- <option>--log <replaceable>LOG=LEVEL,...</replaceable></option>
- </arg>
- <arg rep="repeat" choice="plain">
- <replaceable>pids</replaceable>
+ <replaceable>options</replaceable>
</arg>
+ <group choice="req">
+ <arg rep="repeat" choice="plain">
+ <replaceable>pid</replaceable>
+ </arg>
+ </group>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
- <para><function>fcore</function> Executes the frysk core dump utility.</para>
-
- <para>fcore is a utility that constructs a core-file from a running process, and writes it to disk. </para>
+ <para><function>fcore</function> constructs a core-file from a
+ running process, and writes it to disk. </para>
<variablelist>
<varlistentry>
- <term><option>-a, -allmaps</option></term>
+ <term>
+ <option>-a</option>
+ </term>
+ <term>
+ <option>-allmaps</option>
+ </term>
<listitem>
<para> Write all readable segment maps. The default level is
- to attempt to emulate gcore segment writing strategy. By
- specifying this option, fcore will write all readable maps.
- </para>
+ to attempt to emulate gcore segment writing strategy. By
+ specifying this option, fcore will write all readable
+ maps.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
- <term><option>-s, -segments <replaceable>regex</replaceable></option></term>
+ <term>
hooks/post-receive
--
frysk system monitor/debugger
reply other threads:[~2008-04-02 22:17 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20080402221711.27249.qmail@sourceware.org \
--to=cagney@sourceware.org \
--cc=frysk-cvs@sourceware.org \
--cc=frysk@sourceware.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).