README - OpenGrok cross reference for /OK3568_Linux_fs/external/chromium/licenses/README

1                         README for newlib-2.0.0 release
2            (mostly cribbed from the README in the gdb-4.13 release)
17 Unpacking and Installation -- quick overview
20 When you unpack the newlib-2.0.0.tar.gz file, you'll find a directory
21 called `newlib-2.0.0', which contains:
23 COPYING          config/          install-sh*      mpw-configure
24 COPYING.LIB      config-ml.in     libgloss/        mpw-install
26 CYGNUS           config.sub*      move-if-change*  symlink-tree*
27 ChangeLog        configure*       mpw-README       texinfo/
28 Makefile.in      configure.in     mpw-build.in
29 README           etc/             mpw-config.in
48    All the documentation for NEWLIB comes as part of the machine-readable
51 on-line information and a printed manual.  You can use one of the Info
52 formatting commands to create the on-line version of the documentation
56 Info formatting programs, such as `texinfo-format-buffer' or `makeinfo'.
66 use depends on your system; `lpr -d' is common; another (for PostScript
74 `newlib-VERSION-NUMBER/texinfo' directory.
91 `--srcdir' option to specify where to find the source. (You also need
94 argument to `--srcdir', you can leave out the `--srcdir' option; it
98 directory for a Sun 4 cross m68k-aout environment like this:
100      cd newlib-2.0.0
101      mkdir ../newlib-m68k-aout
102      cd ../newlib-m68k-aout
103      ../newlib-2.0.0/configure --host=sun4 --target=m68k-aout
110 directory `newlib-m68k-aout/libiberty', and NEWLIB itself in
111 `newlib-m68k-aout/newlib'.
114 in a configured directory--whatever directory you were in when you
119 as `newlib-2.0.0' (or in a separate configured directory configured with
120 `--srcdir=PATH/newlib-2.0.0'), you will build all the required libraries.
124 they are NFS-mounted on each of the hosts); they will not interfere
132 script are based on a three-part naming scheme, but some short
136      ARCHITECTURE-VENDOR-OS
139 `--target=TARGET' option.  The equivalent full name is
140 `sparc-sun-sunos4'.
146 you can use it to test your guesses on abbreviations--for example:
149      sparc-sun-sunos4.1.1
151      m68k-sun-sunos4.1.1
153      mips-dec-ultrix4.2
155      m68k-hp-bsd
157      i386-pc-sysv
166 build: the platform on which gcc is built.
167 host: the platform on which gcc is run.
168 target: the platform for which gcc generates code.
171 build, host, and target options given to the top-level configure script must
176 gcc's build platform has no equivalent in newlib.
177 gcc's host platform is newlib's build platform.
178 gcc's target platform is newlib's host platform.
188      configure [--help]
189                [--prefix=DIR]
190                [--srcdir=PATH]
191                [--target=TARGET] HOST
193 You may introduce options with a single `-' rather than `--' if you
194 prefer; but you may abbreviate option names if you use `--'.
196 `--help'
199 `--prefix=DIR'
203 `--exec-prefix=DIR'
204      Configure the source to install host-dependent files in directory
207 `--srcdir=PATH'
219 `--norecursion'
220      Configure only the directory level where `configure' is executed;
223 `--target=TARGET'
240 One feature can be enabled by specifying `--enable-FEATURE=yes' or
241 `--enable-FEATURE'.  Or it can be disable by `--enable-FEATURE=no' or
242 `--disable-FEATURE'.
244 `--enable-newlib-io-pos-args'
245      Enable printf-family positional arg support.
248 `--enable-newlib-io-c99-formats'
252 `--enable-newlib-register-fini'
256 `--enable-newlib-io-long-long'
260 `--enable-newlib-io-long-double'
264 `--enable-newlib-mb'
268 `--enable-newlib-iconv-encodings'
269      Enable specific comma-separated list of bidirectional iconv
270      encodings to be built-in.
273 `--enable-newlib-iconv-from-encodings'
274      Enable specific comma-separated list of \"from\" iconv encodings
275      to be built-in.
278 `--enable-newlib-iconv-to-encodings'
279      Enable specific comma-separated list of \"to\" iconv encodings
280      to be built-in.
283 `--enable-newlib-iconv-external-ccs'
287 `--disable-newlib-atexit-dynamic-alloc'
291 `--enable-newlib-reent-small'
295 `--disable-newlib-fvwrite-in-streamio'
304 `--disable-newlib-fseek-optimization'
309 `--disable-newlib-wide-orient'
316 `--enable-newlib-nano-malloc'
318      `mallocr.c' and the other one in `nano-mallocr.c'.  This options
319      enables the nano-malloc implementation, which is for small systems
321      support `--enable-malloc-debugging' any more.
324 `--disable-newlib-unbuf-stream-opt'
331 `--enable-multilib'
335 `--enable-target-optspace'
339 `--enable-malloc-debugging'
343 `--enable-newlib-multithread'
347 `--enable-newlib-iconv'
351 `--enable-newlib-elix-level'
352      Supply desired elix library level (1-4).  Please refer to HOWTO for
354      Set to level 0 by default.
356 `--disable-newlib-io-float'
360 `--disable-newlib-supplied-syscalls'
364 `--enable-lite-exit'
365      Enable lite exit, a size-reduced implementation of exit that doesn't
366      invoke clean-up functions such as _fini or global destructors.
376 Before running make check-target-newlib, set the DEJAGNU environment
392     { "mips-*elf*" } {
393 	set target_list "mips-sim"
401 mips-sim refers to an exp file in the baseboards directory.  You'll
404 Now type make check-target-newlib in the top-level build directory to
411 --target=i[34567]86-pc-linux-gnu) on an i[34567]86-pc-linux-gnu
416 $(source_dir)/src/configure --with-newlib --prefix=$(install_dir)
419 i[34567]86-pc-linux-gnu, so it will tell newlib to compile itself using
424 target_install_dir = $(install_dir)/i[34567]86-pc-linux-gnu):
426 gcc -nostdlib $(target_install_dir)/lib/crt0.o progname.c -I $(target_install_dir)/include -L $(tar…
433 gcc -nostdlib -static $(target_install_dir)/lib/crt0.o progname.c -I $(target_install_dir)/include …
439 $(source_dir)/src/configure --with-newlib --prefix=$(install_dir) --disable-shared
448 At the top level of newlib is the file: acinclude.m4.  This file contains
452 generated by issuing: aclocal -I${relative_path_to_toplevel_newlib_dir}
453 -I${relative_path_to_toplevel_src_dir}
455 directory is to access libtool information in the top-level src directory.
459   aclocal -I ../../.. -I ../../../..
461 Note that if the top level acinclude.m4 is altered, every aclocal.m4 file
476 files in newlib (and libgloss) are generated using the --cygnus option
489    automake --cygnus stdio/Makefile stdlib/Makefile
496    automake --cygnus Makefile
501    aclocal -I ../../..
503    automake --cygnus Makefile
516 address.  Please include the NEWLIB version number (e.g., newlib-2.0.0),
517 and how you configured it (e.g., "sun4 host and m68k-aout target").
521 Archives of the newlib mailing list are on-line, see