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
35 If `configure' can't determine your host system type, specify one as its
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
97    For example, with version 2.0.0, you can build NEWLIB in a separate
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.
123 directories, you can run `make' on them in parallel (for example, if
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
138    For example, you can use the alias `sun4' as a HOST argument or in a
139 `--target=TARGET' option.  The equivalent full name is
140 `sparc-sun-sunos4'.
145 abbreviations to full names; you can read the script, if you wish, or
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
171 build, host, and target options given to the top-level configure script must
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'
211      from the NEWLIB source directories.  Among other things, you can use
219 `--norecursion'
223 `--target=TARGET'
237 options so that library features can be turned on/off according to
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'
288      Disable dynamic allocation of atexit entries.
291 `--enable-newlib-reent-small'
295 `--disable-newlib-fvwrite-in-streamio'
304 `--disable-newlib-fseek-optimization'
305      Disable fseek optimization.  It can decrease code size of application
309 `--disable-newlib-wide-orient'
312      byte input/output operations on stream.  It can decrease code size
313      by disable the feature.
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
356 `--disable-newlib-io-float'
357      Disable printf/scanf family float support.
360 `--disable-newlib-supplied-syscalls'
361      Disable newlib from supplying 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 …
435 libtool can be instructed to produce only static libraries. To build
439 $(source_dir)/src/configure --with-newlib --prefix=$(install_dir) --disable-shared
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 ../../../..
476 files in newlib (and libgloss) are generated using the --cygnus option
489    automake --cygnus stdio/Makefile stdlib/Makefile
491 Note how multiple Makefile.in files can be created in the same step.  You
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