This directory is an add-on for the GNU C Library (glibc). It provides additional ports to machines and/or operating systems that are not maintained in the official glibc source tree. The scripts in the top level of this directory provide the infrastructure necessary for a glibc add-on. You can make a new add-on containing one or more ports by copying configure, configure.in, and Makeconfig into your own add-on directory, which you can give any name (it doesn't have to be `ports'). You may want to include a README and Banner of your own talking about your port's code in particular, rather than the generic ones here. The real source code for any ports is found in the sysdeps/ subdirectories. These should be exactly what would go into the main libc source tree if you were to incorporate it directly. The only exceptions are the files sysdeps/*/preconfigure and sysdeps/*/preconfigure.in; these are fragments used by this add-on's configure fragment. The purpose of these is to set $base_machine et al when the main libc configure's defaults are not right for some machine. Everything else can and should be done from a normal sysdeps/.../configure fragment that is used only when the configuration selects that sysdeps subdirectory. Each port that requires some special treatment before the sysdeps directory list is calculated, should add a sysdeps/CPU/preconfigure file; this can either be written by hand or generated by Autoconf from sysdeps/CPU/preconfigure.in, and follow the rules for glibc add-on configure fragments. No preconfigure file should do anything on an unrelated configuration, so that disparate ports can be put into a single add-on without interfering with each other. Like all glibc add-ons, the only way to use this is to place this directory (just a symlink won't do) inside the top-level glibc source directory. Then include the name of this directory (e.g. `ports') when you specify `--enable-add-ons=...' to glibc's configure (or use just --enable-add-ons to have it try every add-on directory sitting in your source tree). If you find problems with the top-level scripts in this add-on, please go to http://sources.redhat.com/bugzilla/ and file a report for the glibc under the "admin" component. $Id$