public inbox for frysk-cvs@sourceware.org
help / color / mirror / Atom feed
* [SCM] master: Add version and common options; tidy up.
@ 2008-04-02 22:17 cagney
0 siblings, 0 replies; only message in thread
From: cagney @ 2008-04-02 22:17 UTC (permalink / raw)
To: frysk-cvs
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
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2008-04-02 22:17 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2008-04-02 22:17 [SCM] master: Add version and common options; tidy up cagney
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).