gcc/libiberty
Ian Lance Taylor 2d6c4025cc cp-demangle.c (CP_DYNAMIC_ARRAYS): Define if compiler supports dynamic arrays.
* cp-demangle.c (CP_DYNAMIC_ARRAYS): Define if compiler supports
	dynamic arrays.
	(struct d_operator_info): Add len field.
	(struct d_builtin_type_info): Add len and java_len fields.
	(struct d_standard_sub_info): Add simple_len, full_len, and
	set_last_name_len fields.
	(struct d_comp): Add len field to s_string.
	(struct d_info): Add send, did_subs, and expansion fields.
	(d_append_string_constant): Define.
	(d_append_string): Remove.  Change all users to use
	d_append_string_constant or d_append_buffer instead.
	(d_make_sub): Add len parameter.  Change all callers.
	(d_name): Increase expansion when substituting std::.
	(d_unqualified_name): Increase expansion for an operator.
	(d_number): Don't use multiplication for negative numbers.
	(d_identifier): Make sure there are enough characters in the
	string for the specified length.  Adjust expansion for an
	anonymous namespace.
	(d_operators): Initialize len field.
	(d_special_name, d_ctor_dtor_name): Increase expansion.
	(d_builtin_types): Initialize len and java_len fields.
	(d_type): Increase expansion for a builtin type.
	(d_cv_qualifiers): Increase expansion for each qualifier.
	(d_bare_function_type): Decrease expansion when removing single
	void parameter.
	(d_template_param): Increment did_subs.
	(d_expression): Increase expansion for an operator.
	(d_expr_primary): Decrease expansion for a type we will print
	specially.
	(standard_subs): Initialize new fields.
	(d_substitution): Increment did_subs when doing a normal
	substitution.  Increase expansion for a special substitution.
	(d_print): Add estimate parameter.  Change all callers.
	(d_print_comp) [D_COMP_NAME]: Handle C++ case inline.
	(d_print_comp) [D_COMP_BINARY]: Use length to avoid strcmp call.
	(d_print_java_identifier): Rename from d_print_identifier.  Handle
	only Java case.  Change caller.
	(d_init_info): Change return type to void.  Change all callers.
	Initialize send, did_subs, and expansion fields.  Do not
	initialize comps and subs fields.
	(d_demangle): Ifdef CP_DYNAMIC_ARRAYS, allocate comps and subs
	arrays on stack.  Make an estimate of the length of the demangled
	name.  Ifdef CP_DEMANGLE_DEBUG, print estimation failures.
	(is_ctor_or_dtor): Ifdef CP_DYNAMIC_ARRAYS, allocate comps and
	subs arrays on stack.

From-SVN: r74933
2003-12-22 15:45:12 +00:00
..
config aclocal.m4 (libiberty_AC_FUNC_C_ALLOCA): New. 2001-03-06 09:52:35 +00:00
testsuite cp-demangle.c (d_identifier): In Java mode, skip an optional '$' after the identifier. 2003-12-20 15:53:06 +00:00
COPYING.LIB COPYING.LIB: Update to LGPL 2.1 from the FSF. 2001-02-02 19:38:01 +00:00
ChangeLog cp-demangle.c (CP_DYNAMIC_ARRAYS): Define if compiler supports dynamic arrays. 2003-12-22 15:45:12 +00:00
Makefile.in Makefile.in (floatformat.o): Add dependency on config.h to accompany change of 2003-12-03. 2003-12-15 14:00:49 -05:00
README Update email addresses for bugs and patches. 2002-09-19 18:07:23 +00:00
_doprnt.c Makefile.in (TESTLIB): New. 2002-01-22 15:03:29 -05:00
acconfig.h acconfig.h: New file. 2003-02-13 01:54:07 +00:00
aclocal.m4 re PR bootstrap/12100 (time.h:402: error: previous declaration of `clock'evious declaration of `clock') 2003-09-02 19:29:10 -04:00
alloca.c Makefile.in (TEXIFILES): Add fnmatch.txh. 2001-10-15 22:50:13 -04:00
argv.c argv.c: Fix comments. 2003-04-15 20:36:33 +00:00
asprintf.c asprintf.c: Change comment to note that -1 is returned upon error. 2003-06-03 18:19:17 +00:00
atexit.c configure.in (MAKEINFO, PERL): Detect these. 2001-09-26 14:16:17 -04:00
basename.c configure.in (MAKEINFO, PERL): Detect these. 2001-09-26 14:16:17 -04:00
bcmp.c bcmp.c, setenv.c: Use "nonzero" instead of "non-zero". 2001-10-10 00:33:57 +01:00
bcopy.c configure.in (MAKEINFO, PERL): Detect these. 2001-09-26 14:16:17 -04:00
bsearch.c configure.in (MAKEINFO, PERL): Detect these. 2001-09-26 14:16:17 -04:00
bzero.c configure.in (MAKEINFO, PERL): Detect these. 2001-09-26 14:16:17 -04:00
calloc.c argv.c: Fix comments. 2003-04-15 20:36:33 +00:00
choose-temp.c argv.c, [...]: Improve manual formatting. 2001-10-17 17:15:41 -04:00
clock.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00
concat.c argv.c, [...]: Improve manual formatting. 2001-10-17 17:15:41 -04:00
config.h-vms Initial revision 1997-08-21 18:57:35 -04:00
config.in configure.in: Add check for malloc.h needed by m68k for function free(). 2003-06-19 15:04:03 -04:00
config.table * config.table: Accept i[345867]86 variant. 2003-05-19 22:49:26 -04:00
configure configure.in: Check if $MAKEINFO is missing. 2003-10-01 10:11:29 -07:00
configure.in configure.in: Check if $MAKEINFO is missing. 2003-10-01 10:11:29 -07:00
copying-lib.texi libiberty.texi: (Top level): Add syncodeindex pg. 2001-09-27 15:55:37 -04:00
copysign.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
cp-demangle.c cp-demangle.c (CP_DYNAMIC_ARRAYS): Define if compiler supports dynamic arrays. 2003-12-22 15:45:12 +00:00
cplus-dem.c cplus-dem.c (demangle_template): Register a new Btype only when needed. 2003-10-20 23:21:30 +00:00
dyn-string.c cp-demangle.c (__cxa_demangle): Also protect with IN_GLIBCPP_V3. 2002-04-01 21:55:12 +00:00
fdmatch.c Makefile.in (TEXIFILES): Add fnmatch.txh. 2001-10-15 22:50:13 -04:00
ffs.c argv.c, [...]: Improve manual formatting. 2001-10-17 17:15:41 -04:00
fibheap.c fibheap.c (fibheap_replace_key_data): Change type of OKEY to FIBHEAPKEY_T. 2003-09-06 05:28:03 +00:00
floatformat.c floatformat.c: Include "config.h" and <string.h> if available. 2003-12-03 18:36:50 +00:00
fnmatch.c fnmatch.c: Make the note about the origins of this file more accurate... 2000-12-29 14:37:03 -05:00
fnmatch.txh argv.c, [...]: Improve manual formatting. 2001-10-17 17:15:41 -04:00
functions.texi safe-ctype.h (HC_UNKNOWN, [...]): Rename to HOST_CHARSET_UNKNOWN... 2003-06-22 15:59:49 +00:00
gather-docs configure.in (MAKEINFO, PERL): Detect these. 2001-09-26 14:16:17 -04:00
getcwd.c argv.c: Fix comments. 2003-04-15 20:36:33 +00:00
getopt.c re PR target/10338 ([3.3 regression?] [Cygwin -> tic4x | avr] cross target compilation error) 2003-04-15 14:24:26 +00:00
getopt1.c fnmatch.c: Make the note about the origins of this file more accurate... 2000-12-29 14:37:03 -05:00
getpagesize.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00
getpwd.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00
getruntime.c configure.in (AC_TYPE_PID_T): Use it. 2002-05-07 18:50:53 +00:00
hashtab.c hashtab.c (htab_find_slot_with_hash): Decrease n_deleted instead of increasing n_elements when inserting to deleted slot. 2003-10-30 17:00:51 +00:00
hex.c safe-ctype.h (HC_UNKNOWN, [...]): Rename to HOST_CHARSET_UNKNOWN... 2003-06-22 15:59:49 +00:00
index.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00
insque.c Makefile.in (TEXIFILES): Add fnmatch.txh. 2001-10-15 22:50:13 -04:00
lbasename.c lbasename.c: Add 2002 to copyright. 2002-06-18 02:04:33 +00:00
libiberty.texi fastjar.texi: Update to GFDL 1.2. 2003-02-04 01:27:53 +00:00
lrealpath.c Makefile.in (CFILES): Add lrealpath.c. 2003-02-20 22:11:13 +00:00
maint-tool * maint-tool (deps): Scan for headers in $srcdir also. 2003-04-15 15:21:38 -04:00
make-relative-prefix.c Makefile.in (CFILES): Add lrealpath.c. 2003-02-20 22:11:13 +00:00
make-temp-file.c argv.c, [...]: Improve manual formatting. 2001-10-17 17:15:41 -04:00
makefile.vms xmemdup.c: New xmemdup function. 1999-09-08 02:19:52 -06:00
md5.c md5.c (md5_process_block): Avoid `function-like macro "F{G,H,I}" must be used with arguments in... 2002-11-16 13:38:43 +01:00
memchr.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
memcmp.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
memcpy.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
memmove.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
mempcpy.c mempcpy.c, [...]: New files. 2003-04-16 02:56:46 +00:00
memset.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
mkstemps.c mkstemps.c (mkstemps): On VMS, open temp file with option that causes it to be deleted when closed. 2002-01-15 09:34:56 -05:00
mpw-config.in Update from Cygnus libiberty. 1998-05-15 17:42:58 -06:00
mpw-make.sed Initial revision 1997-08-21 18:57:35 -04:00
mpw.c * mpw.c (mpw_access): Add missing parens. 1998-11-19 14:17:54 -07:00
msdos.c Initial revision 1997-08-21 18:57:35 -04:00
objalloc.c hashtab.c, [...]: Include string.h if HAVE_STRING_H. 2000-05-29 19:33:52 +00:00
obstack.c obstack.c (_): Honor the setting of ENABLE_NLS. 2001-11-12 22:46:00 -05:00
obstacks.texi configure.in (MAKEINFO, PERL): Detect these. 2001-09-26 14:16:17 -04:00
partition.c * partition.c: Fix misspelling of `implementation'. 2001-05-16 20:44:03 +00:00
pex-common.h Makefile.in (CFILES): Add pex-*.c. 2003-01-24 20:02:11 +00:00
pex-djgpp.c Makefile.in (CFILES): Add pex-*.c. 2003-01-24 20:02:11 +00:00
pex-mpw.c Makefile.in (CFILES): Add pex-*.c. 2003-01-24 20:02:11 +00:00
pex-msdos.c Makefile.in (CFILES): Add pex-*.c. 2003-01-24 20:02:11 +00:00
pex-os2.c Makefile.in (CFILES): Add pex-*.c. 2003-01-24 20:02:11 +00:00
pex-unix.c Makefile.in (CFILES): Add pex-*.c. 2003-01-24 20:02:11 +00:00
pex-win32.c pex-win32.c (pexecute): Mark parameters this_pname and temp_base as unused. 2003-07-05 00:52:07 +00:00
pexecute.txh Makefile.in (CFILES): Add pex-*.c. 2003-01-24 20:02:11 +00:00
physmem.c re PR bootstrap/10974 (Bootstrap failure) 2003-06-09 05:20:02 +00:00
putenv.c Makefile.in (TESTLIB): New. 2002-01-22 15:03:29 -05:00
random.c argv.c, [...]: Improve manual formatting. 2001-10-17 17:15:41 -04:00
regex.c re PR target/10338 ([3.3 regression?] [Cygwin -> tic4x | avr] cross target compilation error) 2003-04-15 14:24:26 +00:00
rename.c argv.c: Fix comments. 2003-04-15 20:36:33 +00:00
rindex.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00
safe-ctype.c safe-ctype.h (HC_UNKNOWN, [...]): Rename to HOST_CHARSET_UNKNOWN... 2003-06-22 15:59:49 +00:00
setenv.c Makefile.in (TESTLIB): New. 2002-01-22 15:03:29 -05:00
sigsetmask.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
snprintf.c configure.in (funcs, [...]): Add snprintf and vsnprintf. 2003-04-16 22:42:07 +00:00
sort.c configure.in (AC_CHECK_HEADERS): Add limits.h. 2000-07-23 13:13:46 -06:00
spaces.c Makefile.in (TEXIFILES): Add fnmatch.txh. 2001-10-15 22:50:13 -04:00
splay-tree.c splay-tree.c (splay_tree_predecessor): Fix comment. 2003-05-07 18:19:36 +00:00
stpcpy.c mempcpy.c, [...]: New files. 2003-04-16 02:56:46 +00:00
stpncpy.c Fix typo in last checkin. 2003-04-16 04:42:38 +00:00
strcasecmp.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
strchr.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00
strdup.c * strdup.c (strdup): Tweak implementation to use memcpy. 2003-04-15 02:11:43 +00:00
strerror.c strerror.c: Revert last change. 2003-10-02 19:06:29 +00:00
strncasecmp.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
strncmp.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
strrchr.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00
strsignal.c argv.c: Fix comments. 2003-04-15 20:36:33 +00:00
strstr.c argv.c: Fix comments. 2003-04-15 20:36:33 +00:00
strtod.c strtod.c (strtod): Increment 8 chars, not 7, when `infinity' seen. 2002-03-18 19:52:14 +00:00
strtol.c Makefile.in (TEXIFILES): Add fnmatch.txh. 2001-10-15 22:50:13 -04:00
strtoul.c * strtoul.c: Include safe-ctype.h, not ctype.h. 2000-12-13 12:44:01 -05:00
ternary.c cp-demangle.c (demangle_v3_with_details, [...]): Use K+R style function definition. 2001-05-08 06:13:58 +00:00
tmpnam.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00
vasprintf.c Jan Hubicka <jh@suse.cz> 2003-10-30 20:18:13 +00:00
vfork.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00
vfprintf.c argv.c: Fix comments. 2003-04-15 20:36:33 +00:00
vmsbuild.com xmemdup.c: New xmemdup function. 1999-09-08 02:19:52 -06:00
vprintf.c argv.c: Fix comments. 2003-04-15 20:36:33 +00:00
vsnprintf.c vsnprintf.c (vsnprintf): Don't pad string with extra nulls. 2003-04-22 19:58:57 +00:00
vsprintf.c argv.c: Fix comments. 2003-04-15 20:36:33 +00:00
waitpid.c configure.in (AC_TYPE_PID_T): Use it. 2002-05-07 18:50:53 +00:00
xatexit.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
xexit.c libiberty.texi: (Top level): Add syncodeindex pg. 2001-09-27 15:55:37 -04:00
xmalloc.c argv.c: Use ANSI_PROTOTYPES instead of __STDC__. 2003-04-15 03:35:47 +00:00
xmemdup.c configure.in (MAKEINFO, PERL): Detect these. 2001-09-26 14:16:17 -04:00
xstrdup.c configure.in (MAKEINFO, PERL): Detect these. 2001-09-26 14:16:17 -04:00
xstrerror.c alloca.c, [...]: Improve manual formatting. 2001-10-07 22:53:31 +01:00

README

This directory contains the -liberty library of free software.
It is a collection of subroutines used by various GNU programs.
Current members include:

	getopt -- get options from command line
	obstack -- stacks of arbitrarily-sized objects
	strerror -- error message strings corresponding to errno
	strtol -- string-to-long conversion
	strtoul -- string-to-unsigned-long conversion

We expect many of the GNU subroutines that are floating around to
eventually arrive here.

The library must be configured from the top source directory.  Don't
try to run configure in this directory.  Follow the configuration
instructions in ../README.

Please report bugs to "gcc-bugs@gcc.gnu.org" and send fixes to
"gcc-patches@gcc.gnu.org".  Thank you.

ADDING A NEW FILE
=================

There are two sets of files:  Those that are "required" will be
included in the library for all configurations, while those
that are "optional" will be included in the library only if "needed."

To add a new required file, edit Makefile to add the source file
name to CFILES and the object file to REQUIRED_OFILES.

To add a new optional file, it must provide a single function, and the
name of the function must be the same as the name of the file.

    * Add the source file name to CFILES.

    * Add the function to name to the funcs shell variable in
      configure.in.

    * Add the function to the AC_CHECK_FUNCS lists just after the
      setting of the funcs shell variable.  These AC_CHECK_FUNCS calls
      are never executed; they are there to make autoheader work
      better.

    * Consider the special cases of building libiberty; as of this
      writing, the special cases are newlib and VxWorks.  If a
      particular special case provides the function, you do not need
      to do anything.  If it does not provide the function, add the
      object file to LIBOBJS, and add the function name to the case
      controlling whether to define HAVE_func.

The optional file you've added (e.g. getcwd.c) should compile and work
on all hosts where it is needed.  It does not have to work or even
compile on hosts where it is not needed.

ADDING A NEW CONFIGURATION
==========================

On most hosts you should be able to use the scheme for automatically
figuring out which files are needed.  In that case, you probably
don't need a special Makefile stub for that configuration.

If the fully automatic scheme doesn't work, you may be able to get
by with defining EXTRA_OFILES in your Makefile stub.  This is
a list of object file names that should be treated as required
for this configuration - they will be included in libiberty.a,
regardless of whatever might be in the C library.