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 toeventually arrive here. The library must be configured from the top source directory.  Don'ttry to run configure in this directory.  Follow the configurationinstructions in ../README. Please report bugs to https://gcc.gnu.org/bugzilla/ 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 beincluded in the library for all configurations, while thosethat are "optional" will be included in the library only if "needed." To add a new required file, edit Makefile.in to add the source filename to CFILES and the object file to REQUIRED_OFILES. To add a new optional file, it must provide a single function, and thename of the function must be the same as the name of the file.     * Add the source file name to CFILES in Makefile.in and the object      file to CONFIGURED_OFILES.     * 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. Finally, in the build directory of libiberty, configure with"--enable-maintainer-mode", run "make maint-deps" to updateMakefile.in, and run 'make stamp-functions' to regeneratefunctions.texi. The optional file you've added (e.g. getcwd.c) should compile and workon all hosts where it is needed.  It does not have to work or evencompile on hosts where it is not needed. ADDING A NEW CONFIGURATION========================== On most hosts you should be able to use the scheme for automaticallyfiguring out which files are needed.  In that case, you probablydon't need a special Makefile stub for that configuration. If the fully automatic scheme doesn't work, you may be able to getby with defining EXTRA_OFILES in your Makefile stub.  This isa list of object file names that should be treated as requiredfor this configuration - they will be included in libiberty.a,regardless of whatever might be in the C library.