From 9d51cc66fb8587ea050f2f3d779d1e994b57a9a8 Mon Sep 17 00:00:00 2001 From: Ian Lance Taylor Date: Sun, 8 Aug 1999 18:18:11 +0000 Subject: [PATCH] From Eli Zaretskii : * binutils.texi: Document cxxfilt as MS-DOS name for c++filt. --- binutils/ChangeLog | 3 +++ binutils/binutils.texi | 16 +++++++++++----- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/binutils/ChangeLog b/binutils/ChangeLog index 3bbd49d7e87..a69134b7f43 100644 --- a/binutils/ChangeLog +++ b/binutils/ChangeLog @@ -1,5 +1,8 @@ 1999-08-08 Ian Lance Taylor + From Eli Zaretskii : + * 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 535df3f6b8a..83ab291e3e6 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 -- 2.30.2