README

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