aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--binutils/ChangeLog3
-rw-r--r--binutils/binutils.texi16
2 files changed, 14 insertions, 5 deletions
diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index 3bbd49d..a69134b 100644
--- a/binutils/ChangeLog
+++ b/binutils/ChangeLog
@@ -1,5 +1,8 @@
1999-08-08 Ian Lance Taylor <ian@zembu.com>
+ From Eli Zaretskii <eliz@gnu.org>:
+ * binutils.texi: Document cxxfilt as MS-DOS name for c++filt.
+
* configure.in: Define and substitute DEMANGLER_NAME.
* Makefile.am (DEMANGLER_PROG): Set to cxxfilt.
(man_MANS): Use DEMANGLER_NAME rather than DEMANGLER_PROG.
diff --git a/binutils/binutils.texi b/binutils/binutils.texi
index 535df3f..83ab291 100644
--- a/binutils/binutils.texi
+++ b/binutils/binutils.texi
@@ -118,7 +118,8 @@ List printable strings from files
Discard symbols
@item c++filt
-Demangle encoded C++ symbols
+Demangle encoded C++ symbols (on MS-DOS, this program is named
+@code{cxxfilt})
@item addr2line
Convert addresses into file names and line numbers
@@ -145,6 +146,7 @@ Create the files needed to build and use Dynamic Link Libraries
* strings:: List printable strings from files
* strip:: Discard symbols
* c++filt:: Filter to demangle encoded C++ symbols
+* cxxfilt: c++filt. MS-DOS name for c++filt
* addr2line:: Convert addresses to file and line
* nlmconv:: Converts object code into an NLM
* windres:: Manipulate Windows resources
@@ -1707,7 +1709,7 @@ Verbose output: list all object files modified. In the case of
archives, @samp{strip -v} lists all members of the archive.
@end table
-@node c++filt
+@node c++filt, addr2line, strip, Top
@chapter c++filt
@kindex c++filt
@@ -1721,13 +1723,17 @@ c++filt [ -_ | --strip-underscores ]
[ --help ] [ --version ] [ @var{symbol}@dots{} ]
@end smallexample
+@kindex cxxfilt
The C++ and Java languages provides function overloading, which means
that you can write many functions with the same name (providing each
takes parameters of different types). All C++ and Java function names
are encoded into a low-level assembly label (this process is known as
-@dfn{mangling}). The @code{c++filt} program does the inverse mapping: it
-decodes (@dfn{demangles}) low-level names into user-level names so that
-the linker can keep these overloaded functions from clashing.
+@dfn{mangling}). The @code{c++filt}
+@footnote{MS-DOS does not allow @kbd{+} characters in file names, so on
+MS-DOS this program is named @code{cxxfilt}.}
+program does the inverse mapping: it decodes (@dfn{demangles}) low-level
+names into user-level names so that the linker can keep these overloaded
+functions from clashing.
Every alphanumeric word (consisting of letters, digits, underscores,
dollars, or periods) seen in the input is a potential label. If the