summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEric S. Raymond <esr@thyrsus.com>2010-12-05 18:06:46 -0500
committerEric S. Raymond <esr@thyrsus.com>2010-12-05 18:06:46 -0500
commitbd618133879ccaa661cac0ae4ca4baaef72dad19 (patch)
tree0092ccfd6743858307e0c602c647acd4a414ee77
parent82ded416e09f1c25d591276b07637fee7ef2814a (diff)
downloaddeheader-bd618133879ccaa661cac0ae4ca4baaef72dad19.tar.gz
deheader-bd618133879ccaa661cac0ae4ca4baaef72dad19.tar.bz2
deheader-bd618133879ccaa661cac0ae4ca4baaef72dad19.tar.xz
deheader-bd618133879ccaa661cac0ae4ca4baaef72dad19.zip
Typo fixes and more caveats.
-rw-r--r--deheader.xml14
1 files changed, 11 insertions, 3 deletions
diff --git a/deheader.xml b/deheader.xml
index 4e227ee..68ee2b9 100644
--- a/deheader.xml
+++ b/deheader.xml
@@ -113,7 +113,7 @@ Takes a Python regular expression.</para>
<varlistentry>
<term>-V</term>
<listitem>
-<para>Show version of program snd exit.</para>
+<para>Show version of program and exit.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -124,11 +124,19 @@ Takes a Python regular expression.</para>
<para>Test-compiling after running with <option>-r</option> will
sometimes show that this tool removed some headers that are actually
required for your build. This happens because
-<command>deheader</command> doesn't know about all the strange thungs
+<command>deheader</command> doesn't know about all the strange things
your build system gets up to, and the problem of analyzing it to
-undertand them would be Turing-complete. Simply revert the altered
+understand them would be Turing-complete. Simply revert the altered
files and continue.</para>
+<para>Due to minor variations in system headers, it is possible your
+program may not port correctly to other Unix variants after being
+deheadered. This is normally not a problem with the portion of the API
+specified by POSIX and ANSI C, but may be for headers that are not
+stndardized or only weakly standardized. The sockets API (sys/select.h,
+sys/sockets.h, and friends such as sys/types.h and sys.stat.h) is
+perhaps the most serious trouble spot.</para>
+
<para>Sufficiently perverse C++ can silently invalidate the simple
algorithm this tool uses. Example: if an overloaded function has
different overloads from two different files, removing one may expose