ruby-elf 1.0.7 → 1.0.8

data/extras/README.extras

@@ -1,5 +0,0 @@
-These scripts are some extra tools that I've written and aren't really
-part of ruby-elf as they don't relate to parsing ELF files directly.
-
-binding-parser.rb: a parser for the output of LD_DEBUG=bindings from
-  glibc's dynamic loader.

data/extras/bindings-parsers.rb

@@ -1,157 +0,0 @@
-#!/usr/bin/env ruby
-# -*- coding: utf-8 -*-
-# Copyright © 2006-2008, Diego Elio Pettenò <flameeyes@flameeyes.eu>
-#
-# This program is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this generator; if not, write to the Free Software
-# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-
-# == Synopsis
-#
-# bindings-parser: parses the LD_DEBUG=bindings output
-#
-# == Usage
-# 
-# bindings-parser [-S] [-b] [-l library] [-f file]
-#
-# -h, --help:
-#    show help
-#
-# -S, --sort
-#    Sort the statistics by amount of entries.
-#
-# -b, --basename-only
-#    Report only the basename of libraries (shorter).
-#
-# -l <basename>, --library <basename>
-#    Report only the statistics for the given library.
-#
-# -f <inputfile>, --file <inputfile>
-#    Reads the output to parse from file rather than standard input.
-#
-# Feed the standard input (or the file) with the outptu created by
-# LD_DEBUG=bindings somecommand
-# You can use LD_DEBUG_OUTPUT to write the output to a file rather than
-# stderr.
-
-pid = nil
-
-require 'getoptlong'
-require 'rdoc/usage'
-
-opts = GetoptLong.new(
-                      ["--help", "-h", GetoptLong::NO_ARGUMENT],
-                      ["--sort", "-S", GetoptLong::NO_ARGUMENT],
-                      ["--basename-only", "-b", GetoptLong::NO_ARGUMENT],
-                      ["--library", "-l", GetoptLong::REQUIRED_ARGUMENT],
-                      ["--file", "-f", GetoptLong::REQUIRED_ARGUMENT]
-                      )
-
-sort = false
-basename = false
-library = nil
-input = $stdin
-
-opts.each do |opt, arg|
-  case opt
-  when "--help"
-    RDoc::usage
-  when "--sort"
-    sort = true
-  when "--basename-only"
-    basename = true
-  when "--library"
-    library = arg
-  when "--file"
-    input = File.new(arg, "r")
-  end
-end
-
-bindings = []
-
-input.each_line { |line|
-  if line =~ /\s+(\d+):\s+binding file ([^\s]+) \[0\] to ([^\s]+) \[0\]: (\w+) symbol .*/
-    
-    pid = $1.to_i unless pid
-
-    if basename or library
-      bindings << { :origin => File.basename($2), :destination => File.basename($3), :type => $4 }
-    else
-      bindings << { :origin => $2, :destination => $3, :type => $4 }
-    end
-
-  end
-}
-
-maxlen = 0
-
-bindings.each { |b| maxlen = [maxlen, b[:origin].size, b[:destination].size, b[:type].size].max }
-
-maxlen += 4
-
-origins = bindings.collect { |b| b[:origin] }.uniq.sort
-destinations = bindings.collect { |b| b[:destination] }.uniq.sort
-bindtypes = bindings.collect { |b| b[:type] }.uniq.sort
-
-origcount = origins.collect { |key| [ key, bindings.clone.delete_if { |e| e[:origin] != key }.size ] }
-destcount = destinations.collect { |key| [ key, bindings.clone.delete_if { |e| e[:destination] != key }.size ] }
-typescount = bindtypes.collect { |key| [ key, bindings.clone.delete_if { |e| e[:type] != key }.size ] }
-selfcount = origins.collect { |key| [ key, bindings.clone.delete_if { |e| e[:origin] != key or e[:destination] != key }.size ] }
-
-if sort
-  [origcount, destcount, typescount, selfcount].each { |countarray|
-    countarray.sort! { |k1, k2| k2[1] <=> k1[1] } # [1] is the count
-  }
-else
-  [origcount, destcount, typescount, selfcount].each { |countarray|
-    countarray.sort! { |k1, k2| k2[0] <=> k1[0] } # [0] is the name
-  }
-end
-
-if not library
-  puts "Statistics"
-  
-  puts "  Origins"
-  origcount.each { |key, count|
-    print "    #{key}"
-    (maxlen-key.size).times { print " " }
-    puts "#{count}"
-  }
-  
-  puts "  Destinations"
-  destcount.each { |key, count|
-    print "    #{key}"
-    (maxlen-key.size).times { print " " }
-    puts "#{count}"
-  }
-  
-  puts "  Bindtypes"
-  typescount.each { |key, count|
-    print "    #{key}"
-    (maxlen-key.size).times { print " " }
-    puts "#{count}"
-  }
-  
-  puts "  Self-loops (candidate for protected visibility)"
-  selfcount.each { |key, count|
-    next if count == 0
-    print "    #{key}"
-    (maxlen-key.size).times { print " " }
-    puts "#{count}"
-  }
-else
-  puts "Statistics for #{library}"
-  puts "  Origin:       #{origcount.assoc(library)[1].to_s.rjust(8)}" if origcount.assoc(library)
-  puts "  Destination:  #{destcount.assoc(library)[1].to_s.rjust(8)}" if destcount.assoc(library)
-  puts "  Self-loops:   #{selfcount.assoc(library)[1].to_s.rjust(8)}" if selfcount.assoc(library)
-end

data/manpages/cowstats.1.xml

@@ -1,234 +0,0 @@
-<?xml version='1.0'?>
-<!--
-Copyright © 2008-2011, Diego Elio Pettenò <flameeyes@flameeyes.eu>
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this generator; if not, write to the Free Software
-Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
--->
-<article xmlns="http://docbook.org/ns/docbook"
-         xmlns:xl="http://www.w3.org/1999/xlink"
-         xmlns:xi="http://www.w3.org/2001/XInclude"
-         version="5.0" xml:lang="en">
-  <info>
-    <title>cowstats</title>
-
-    <xi:include parse="xml" href="author.xmli" />
-  </info>
-
-  <section>
-    <title>Reference</title>
-
-    <refentry>
-      <info>
-        <date>October 2008</date>
-        <productname>ruby-elf</productname>
-      </info>
-      <refmeta>
-        <refentrytitle>cowstats</refentrytitle>
-        <manvolnum>1</manvolnum>
-      </refmeta>
-      <refnamediv>
-        <refname>cowstats</refname>
-        <refpurpose>ELF Copy-on-Write analyzer</refpurpose>
-      </refnamediv>
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>cowstats</command>
-          <arg choice="opt"><option>--statistics</option></arg>
-          <arg choice="opt"><option>--total</option></arg>
-          <arg choice="opt"><option>--ignore-cxx</option></arg>
-          <arg choice="opt"><option>--ignore-profiling</option></arg>
-          <arg choice="opt"><option>--ignore-data-rel-ro</option></arg>
-          <arg choice="opt">
-            <option>--sort-by</option>
-            <replaceable>section-column</replaceable>
-          </arg>
-
-          <xi:include href="common.xmli"  xpointer="xpointer(id('filelist.synopsis')/*)" />
-        </cmdsynopsis>
-      </refsynopsisdiv>
-
-      <refsect1>
-        <title>Description</title>
-        <para>
-          <command>cowstats</command> is a script that analyses ELF object files, results of
-          compilation of C, C++ or other languages on an Unix system, and reports about the
-          variables that enter Copy-on-Write sections.
-        </para>
-
-        <para>
-          Static variables (initialised and not) and constant pointers on PIC or PIE enabled object
-          files are emitted in the so-called Copy-on-Write sections, which require copying over
-          pages from the original ELF executable file to a private resident area of memory at
-          runtime.
-        </para>
-
-        <para>
-          <command>cowstats</command> reports the possible symbols that were emitted in
-          Copy-on-Write sections so that they can be looked after to see if they can be made
-          constant and/or removed or reworked.
-        </para>
-      </refsect1>
-
-      <refsect1>
-        <title>Options</title>
-
-        <variablelist>
-          <varlistentry>
-            <term><option>-s</option></term>
-            <term><option>--statistics</option></term>
-            <listitem>
-              <para>
-                Instead of reporting all the variables found in Copy-on-Write sections, only
-                generate a table showing the sie of data in Copy-on-Write sections per each file,
-                divided into <constant>.data</constant>, <constant>.bss</constant> and
-                <constant>.data.rel</constant> (for variables, uninitialised variables, and
-                relocated variables and constants).
-              </para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><option>-t</option></term>
-            <term><option>--total</option></term>
-            <listitem>
-              <para>
-                Shows some rough totals for the amount of data in Copy-on-Write sections for the
-                program, assuming all the object files given are linked in the same executable. This
-                will also show a rough page-based total, which bases itself on 4K-sized pages.
-              </para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><option>-x</option></term>
-            <term><option>--ignore-cxx</option></term>
-            <listitem>
-              <para>
-                Ignore some C++ entries that could be considered false positives. C++ object files
-                will report as CoW data the vtables and typeinfo objects for C++ classes, since they
-                are actually emitted in Copy-on-Write sections. Since they cannot be moved from
-                thre, this option hides them on the output, to reduce clutter and noise.
-              </para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><option>-p</option></term>
-            <term><option>--ignore-profiling</option></term>
-            <listitem>
-              <para>
-                Similarly to C++, also profiling (with <command>gcov</command>) will add some
-                symbols that would be identified as CoW data. Use this option to avoid reporting
-                those symbols.
-              </para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term><option>-r</option></term>
-            <term><option>--ignore-data-rel-ro</option></term>
-            <listitem>
-              <para>
-                Don't report constants found in the .data.rel.ro section, and consider it as
-                non-relocated. This is helpful to reduce the noise when looking for writable data
-                symbols, or when analysing non-PIC builds.
-              </para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>
-              <option>-S</option>
-              <replaceable>section-column</replaceable>
-            </term>
-            <term>
-              <option>--sort-by</option>
-              <replaceable>section-column</replaceable>
-            </term>
-
-            <listitem>
-              <para>
-                Sort the output of <option>--statistics</option> by the given column. Useful when
-                looking for which objects have the most hit for one particular CoW problem. The
-                column can be one of the following section names:
-              </para>
-
-              <itemizedlist>
-                <listitem><para>.bss</para></listitem>
-                <listitem><para>.data</para></listitem>
-                <listitem><para>.data.rel</para></listitem>
-                <listitem><para>.data.rel.ro</para></listitem>
-              </itemizedlist>
-            </listitem>
-          </varlistentry>
-
-          <xi:include href="common.xmli" xpointer="xpointer(id('filelist.option')/*)" />
-
-        </variablelist>
-      </refsect1>
-
-      <refsect1>
-        <title>Bugs</title>
-
-        <para>
-          <command>cowstats</command> is still an experiment, and is
-          not yet entirely complete, there are thus a number of bugs
-          that haven't been discovered or well tested yet.
-        </para>
-
-        <para>
-          A known "bug" or misbehaviour is that <command>cowstats</command> cannot know whether
-          multple object files will be linked together in the same module (executable or shared
-          object) or not. For this reason the output of <option>--total</option> might not be
-          consistent with the runtime behaviour of the module itself.
-        </para>
-
-        <xi:include href="common.xmli" xpointer="xpointer(id('filelist.bugpara')/*)" />
-      </refsect1>
-
-      <refsect1>
-        <title>See Also</title>
-        <para>
-          <citation xl:href="http://blog.flameeyes.eu/">Flameeyes's Weblog</citation>
-          http://blog.flameeyes.eu/
-        </para>
-
-        <para>
-          Related tools:
-
-          <citerefentry>
-            <refentrytitle>rbelf-size</refentrytitle>
-            <manvolnum>1</manvolnum>
-          </citerefentry>,
-
-          <citerefentry>
-            <refentrytitle>objdump</refentrytitle>
-            <manvolnum>1</manvolnum>
-          </citerefentry>.
-        </para>
-      </refsect1>
-    </refentry>
-  </section>
-</article>
-<!--
-    Local Variables:
-    mode: nxml
-    mode: auto-fill
-    mode: flyspell
-    ispell-local-dictionary: "english"
-    fill-column: 100
-    indent-tabs-mode: nil
-    End:
--->

data/manpages/elfgrep.1.xml

@@ -1,423 +0,0 @@
-<?xml version='1.0'?>
-<!--
-Copyright © 2011, Diego Elio Pettenò <flameeyes@flameeyes.eu>
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this generator; if not, write to the Free Software
-Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
--->
-<article xmlns="http://docbook.org/ns/docbook"
-         xmlns:xl="http://www.w3.org/1999/xlink"
-         xmlns:xi="http://www.w3.org/2001/XInclude"
-         version="5.0" xml:lang="en">
-  <info>
-    <title>elfgrep</title>
-
-    <xi:include parse="xml" href="author.xmli" />
-  </info>
-
-  <section>
-    <title>Reference</title>
-
-    <refentry>
-      <info>
-        <date>November 2011</date>
-        <productname>ruby-elf</productname>
-      </info>
-      <refmeta>
-        <refentrytitle>elfgrep</refentrytitle>
-        <manvolnum>1</manvolnum>
-      </refmeta>
-      <refnamediv>
-        <refname>elfgrep</refname>
-        <refpurpose>Search for symbols matching an expression in ELF files</refpurpose>
-      </refnamediv>
-      <refsynopsisdiv>
-        <cmdsynopsis>
-          <command>elfgrep</command>
-
-          <arg choice="opt">
-            <option>--fixed-strings</option>
-          </arg>
-
-          <arg choice="opt">
-            <option>--ignore-case</option>
-          </arg>
-
-          <arg choice="opt">
-            <option>--match-version</option>
-          </arg>
-
-          <group choice="opt">
-            <arg choice="plain">
-              <option>--match-undefined</option>
-            </arg>
-
-            <arg choice="plain">
-              <option>--match-defined</option>
-            </arg>
-          </group>
-
-          <arg choice="opt">
-            <option>--invert-match</option>
-          </arg>
-
-          <arg choice="opt">
-            <option>--count</option>
-          </arg>
-
-          <group choice="opt">
-            <arg choice="plain">
-              <option>--files-without-match</option>
-            </arg>
-
-            <arg choice="plain">
-              <option>--files-with-matches</option>
-            </arg>
-          </group>
-
-          <group choice="opt">
-            <arg choice="plain">
-              <option>--with-filename</option>
-            </arg>
-
-            <arg choice="plain">
-              <option>--no-filename</option>
-            </arg>
-          </group>
-
-          <arg choice="opt">
-            <option>--null</option>
-          </arg>
-
-          <arg choice="opt">
-            <option>--symbol-regexp</option>
-          </arg>
-
-          <xi:include href="common.xmli"  xpointer="xpointer(id('filelist.synopsis.options')/*)" />
-
-          <group choice="req">
-            <arg choice="plain" rep="repeat">
-              <option>--regexp</option>
-              <replaceable>PATTERN</replaceable>
-            </arg>
-
-            <arg choice="plain" rep="repeat">
-              <option>--file</option>
-              <replaceable>FILE</replaceable>
-            </arg>
-
-            <arg choice="plain">
-              <replaceable>PATTERN</replaceable>
-            </arg>
-          </group>
-
-          <xi:include href="common.xmli"  xpointer="xpointer(id('filelist.synopsis.arguments')/*)" />
-        </cmdsynopsis>
-      </refsynopsisdiv>
-
-      <refsect1>
-        <title>Description</title>
-        <para>
-          <command>elfgrep</command> is a simple script that allows to earch for particular symbols
-          within a file, by matching regular expression on their name. It is insipired by the common
-          Unix
-          <citerefentry><refentrytitle>grep</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-          tool.
-        </para>
-      </refsect1>
-
-      <refsect1>
-        <title>Options</title>
-
-        <refsect2>
-          <title>Matching Control</title>
-
-          <variablelist>
-            <varlistentry>
-              <term><option>-F</option></term>
-              <term><option>--fixed-strings</option></term>
-              <listitem>
-                <para>
-                  Interpret <replaceable>PATTERN</replaceable> as a list of fixed strings, separated
-                  by newlines, any of which is to be matched.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term>
-                <option>-e</option>
-                <replaceable>PATTERN</replaceable>
-              </term>
-              <term>
-                <option>--regexp</option>
-                <replaceable>PATTERN</replaceable>
-              </term>
-
-              <listitem>
-                <para>
-                  Use <replaceable>PATTERN</replaceable> as the pattern. This can be used to specify
-                  multiple search patterns, or to protect a pattern beginning with a hyphen
-                  (<literal>-</literal>).
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term>
-                <option>-f</option>
-                <replaceable>FILE</replaceable>
-              </term>
-              <term>
-                <option>--file</option>
-                <replaceable>FILE</replaceable>
-              </term>
-
-              <listitem>
-                <para>
-                  Obtain patterns from <replaceable>FILE</replaceable>, one per line.
-                </para>
-
-                <note>
-                  <title>Behaviour difference from <application>grep</application> semantics</title>
-
-                  <para>
-                    For <application>grep</application>'s <option>--file</option> option, an empty
-                    line (with only a newline character) is a “match all” pattern, while a totally
-                    empty file (zero bytes sized) is a “match none” pattern. This doesn't make much
-                    sense, especially for <application>elfgrep</application>, so both empty lines
-                    and empty files are simply skipped over. Passing <option>--file</option>
-                    pointing to a file that gets totally ignored (zero bytes sized, or a sequence of
-                    newline characters) will still stop <application>elfgrep</application> from
-                    looking for a pattern in the first non-option argument.
-                  </para>
-                </note>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-i</option></term>
-              <term><option>--ignore-case</option></term>
-              <listitem>
-                <para>
-                  Ignore case distinction in both the <replaceable>PATTERN</replaceable> and the
-                  symbols' names.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-V</option></term>
-              <term><option>--match-version</option></term>
-              <listitem>
-                <para>
-                  Append the ELF version information for the symbol, separated by an @ symbol, before
-                  testing the expression for match. This allows to match only symbols that are defined
-                  with a particular version.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-U</option></term>
-              <term><option>--match-undefined</option></term>
-              <listitem>
-                <para>
-                  Report matches on undefined symbols. By default <command>elfgrep</command> will
-                  report matches on both defined and undefined symbols. This switch makes it ignore
-                  matches on defined symbols.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-D</option></term>
-              <term><option>--no-match-defined</option></term>
-              <listitem>
-                <para>
-                  Report matches on defined symbols. By default <command>elfgrep</command> will
-                  report matches on both defined and undefined symbols. This switch makes it ignore
-                  matches on undefined symbols.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-v</option></term>
-              <term><option>--invert-match</option></term>
-              <listitem>
-                <para>
-                  Invert the sense of matching, to select non-matching symbols. This does not invert
-                  the sense of <option>--no-match-undefined</option> and
-                  <option>--no-match-defined</option>.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-s</option></term>
-              <term><option>--symbol-regexp</option></term>
-              <listitem>
-                <para>
-                  Select only those matches that exactly match the whole line.
-                </para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </refsect2>
-
-        <refsect2>
-          <title>Output Control</title>
-
-          <variablelist>
-
-            <varlistentry>
-              <term><option>-c</option></term>
-              <term><option>--count</option></term>
-              <listitem>
-                <para>
-                  Suppress normal output; instead print a count of matching lines for each input
-                  file. With the <option>--invert-match</option> option, count non-matching lines.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-L</option></term>
-              <term><option>--files-without-match</option></term>
-
-              <listitem>
-                <para>
-                  Suppress normal output; instead print the name of each input file from which no
-                  output would normally have been printed.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-l</option></term>
-              <term><option>--files-with-matches</option></term>
-
-              <listitem>
-                <para>
-                  Suppress normal output; instead print the name of each input file from which output
-                  would normally have been printed. The scalling will stop on the first match.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-H</option></term>
-              <term><option>--with-filename</option></term>
-
-              <listitem>
-                <para>
-                  Print the file name for each match. This is the default when there is more than one
-                  file to search.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-h</option></term>
-              <term><option>--no-filename</option></term>
-
-              <listitem>
-                <para>
-                  Suppress the prefixing of file names on output. This is the default when there is
-                  only one file to search.
-                </para>
-              </listitem>
-            </varlistentry>
-
-            <varlistentry>
-              <term><option>-Z</option></term>
-              <term><option>--null</option></term>
-
-              <listitem>
-                <para>
-                  Output a zero byte (the ASCII <literal>NUL</literal> character) instead of the
-                  character that normally follows a file name. For example <command>elfgrep
-                  -lZ</command> outputs a zero byte after each file name instead of the usual
-                  newline. This option makes the output unambiguous, even in presence of file names
-                  containing unusual characters like newlines, so that it can be used with commands
-                  like <command>xargs -0</command>.
-                </para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </refsect2>
-
-        <refsect2>
-          <title>General Options</title>
-
-          <variablelist>
-            <xi:include href="common.xmli" xpointer="xpointer(id('filelist.option')/*)" />
-          </variablelist>
-        </refsect2>
-      </refsect1>
-
-      <refsect1>
-        <title>Bugs and Missing Features</title>
-
-        <para>
-          By default, <application>elfgrep</application> uses standard Ruby regular expressions,
-          which are neither the basic or extended regular expressions as implemented by
-          <citerefentry><refentrytitle>grep</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-          nor the Perl (or compatible) regular expressions.
-        </para>
-
-        <xi:include href="common.xmli" xpointer="xpointer(id('filelist.bugpara')/*)" />
-      </refsect1>
-
-      <refsect1>
-        <title>See Also</title>
-        <para>
-          <citation xl:href="http://blog.flameeyes.eu/">Flameeyes's Weblog</citation>
-          http://blog.flameeyes.eu/
-        </para>
-
-        <para>
-          Related tools:
-
-          <citerefentry>
-            <refentrytitle>grep</refentrytitle>
-            <manvolnum>1</manvolnum>
-          </citerefentry>,
-
-          <citerefentry>
-            <refentrytitle>rbelf-nm</refentrytitle>
-            <manvolnum>1</manvolnum>
-          </citerefentry>.
-        </para>
-
-        <para>
-          Lots of description of options above are lifted directly from the
-          <application>grep</application> man page, to avoid confusing with different
-          wordings.
-        </para>
-      </refsect1>
-    </refentry>
-  </section>
-</article>
-<!--
-    Local Variables:
-    mode: nxml
-    mode: auto-fill
-    mode: flyspell
-    ispell-local-dictionary: "english"
-    fill-column: 100
-    indent-tabs-mode: nil
-    End:
--->