gcc/libiberty
Tom Tromey 48492bdf79 pexecute.txh (pex_free): Document process killing.
libiberty:
	* pexecute.txh (pex_free): Document process killing.
include:
	* libiberty.h (pex_free): Document process killing.

From-SVN: r128192
2007-09-06 16:58:57 +00:00
..
config
testsuite Index: libiberty/ChangeLog 2007-05-06 00:01:36 +00:00
_doprnt.c
aclocal.m4 acinclude.m4 (gcc_AC_CHECK_PROG_VER): Remove. 2007-06-14 08:10:41 +00:00
alloca.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
argv.c argv.c (writeargv): Fix typo in inline documentation. 2007-07-23 13:29:17 -04:00
asprintf.c
at-file.texi * at-file.texi: Fix typo. 2005-10-07 14:21:47 +00:00
atexit.c
basename.c
bcmp.c
bcopy.c pex-win32.c (argv_to_cmdline): Replace xmalloc with XNEWVEC. 2006-10-26 03:16:11 +00:00
bsearch.c
bzero.c
calloc.c
ChangeLog pexecute.txh (pex_free): Document process killing. 2007-09-06 16:58:57 +00:00
choose-temp.c hex.c: Fix typo. 2007-01-31 15:05:50 -05:00
clock.c
concat.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
config.h-vms
config.in configure.ac: Check for a getopt(3) declaration. 2005-07-22 13:14:38 +10:00
configure configure.ac (target_header_dir, msdosdjgpp): Remove duplicate gettimeofday entry. 2007-07-17 13:52:28 -04:00
configure.ac configure.ac (target_header_dir, msdosdjgpp): Remove duplicate gettimeofday entry. 2007-07-17 13:52:28 -04:00
copying-lib.texi
COPYING.LIB
copysign.c
cp-demangle.c mangle.c (write_type): Change mangling of rvalue reference from RR' to O'. 2007-08-31 19:15:26 +00:00
cp-demangle.h demangle.h: New cplus_demangle_print_callback... 2007-01-29 20:07:49 +00:00
cp-demint.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
cplus-dem.c cplus-dem.c (demangle_fund_type): Ensure buf is large enough to hold "int%u_t". 2006-05-12 15:44:29 -04:00
dyn-string.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
fdmatch.c
ffs.c
fibheap.c
filename_cmp.c filename_cmp.c: Replace include of ctype.h by include of safe-ctype.h. 2007-05-03 23:39:35 +00:00
floatformat.c floatformat.c (get_field): Fix segfault with little-endian word order on 64-bit hosts. 2006-11-07 15:16:07 +00:00
fnmatch.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
fnmatch.txh
fopen_unlocked.c fopen_unlocked.c: Enclose multi-word data types in @deftypefn in braces. 2005-05-15 18:36:40 +02:00
functions.texi argv.c (writeargv): Fix typo in inline documentation. 2007-07-23 13:29:17 -04:00
gather-docs
getcwd.c
getopt1.c getpwd.c: Remove unneeded prototype getcwd and move getwd so that it's only declared if... 2005-05-16 15:52:39 +02:00
getopt.c * getopt.c: Include ansidecl.h before system headers. 2005-07-23 14:57:03 +00:00
getpagesize.c
getpwd.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
getruntime.c
gettimeofday.c
hashtab.c re PR middle-end/28071 (A file that can not be compiled in reasonable time/space) 2006-07-27 17:10:07 +00:00
hex.c hex.c: Fix typo. 2007-01-31 15:05:50 -05:00
index.c
insque.c
lbasename.c
libiberty.texi
lrealpath.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
maint-tool maint-tool (deps): Output stamp-h instead of config.h. 2007-07-12 02:23:52 +00:00
make-relative-prefix.c make-relative-prefix.c (make_relative_prefix_1): Resource leaks. 2007-08-17 15:28:22 -04:00
make-temp-file.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
Makefile.in ternary.h: Remove. 2007-07-25 16:26:45 +10:00
makefile.vms
md5.c re PR other/13906 (genmodes.c:964: internal compiler error: Bus error in md5_process_block) 2005-07-03 15:40:29 +00:00
memchr.c
memcmp.c
memcpy.c Recover patch lost in the sourceware repository: 2005-07-22 13:21:19 +10:00
memmove.c Recover patch lost in the sourceware repository: 2005-07-22 13:21:19 +10:00
mempcpy.c
memset.c
mkstemps.c Open temporary files in binary mode when using mkstemps. 2006-05-28 08:48:00 +00:00
msdos.c
objalloc.c Recover patch lost in the sourceware repository: 2005-07-22 13:21:19 +10:00
obstack.c
obstacks.texi
partition.c pexecute.c (pwait): Free vector pointer. 2006-02-20 20:21:49 -05:00
pex-common.c libiberty.h (PEX_STDERR_TO_PIPE): New define. 2007-01-31 18:40:34 +00:00
pex-common.h [patch]: libiberty pex for _WIN64. 2007-08-24 09:40:35 +02:00
pex-djgpp.c [patch]: libiberty pex for _WIN64. 2007-08-24 09:40:35 +02:00
pex-msdos.c [patch]: libiberty pex for _WIN64. 2007-08-24 09:40:35 +02:00
pex-one.c
pex-unix.c [patch]: libiberty pex for _WIN64. 2007-08-24 09:40:35 +02:00
pex-win32.c [patch]: libiberty pex for _WIN64. 2007-08-24 09:40:35 +02:00
pexecute.c * pexecute.c (pwait): Syntax fix for previous change. 2006-02-21 13:21:44 +11:00
pexecute.txh pexecute.txh (pex_free): Document process killing. 2007-09-06 16:58:57 +00:00
physmem.c
putenv.c
random.c
README
regex.c * regex.c (regcomp): Change type of `i' from unsigned to int. 2005-07-22 13:55:44 +10:00
rename.c
rindex.c
safe-ctype.c
setenv.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
sigsetmask.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
snprintf.c
sort.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
spaces.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
splay-tree.c splay-tree.c (rotate_left): New function. 2005-11-07 07:45:35 +00:00
stpcpy.c
stpncpy.c
strcasecmp.c
strchr.c
strdup.c
strerror.c
strncasecmp.c
strncmp.c
strndup.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
strrchr.c
strsignal.c strsignal.c (psignal): Change type of signo to int. 2007-01-31 10:12:29 +11:00
strstr.c
strtod.c
strtol.c
strtoul.c
strverscmp.c strverscmp.c: Update FSF address. 2005-08-17 03:31:04 +00:00
tmpnam.c
unlink-if-ordinary.c
vasprintf.c
vfork.c
vfprintf.c
vmsbuild.com
vprintf.c
vsnprintf.c
vsprintf.c
waitpid.c
xatexit.c
xexit.c
xmalloc.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
xmemdup.c
xstrdup.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
xstrerror.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00
xstrndup.c libiberty.h (ACONCAT): Properly cast value of alloca(). 2005-05-24 20:48:25 +00:00

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.ac.

    * 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.