[BACK]Return to BUILDING CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src

Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.

Diff for /src/BUILDING between version 1.44 and 1.51

version 1.44, 2003/09/29 07:58:01 version 1.51, 2004/06/25 15:04:20
Line 30  REQUIREMENTS
Line 30  REQUIREMENTS
      toolchain (make is not required); all other tools are created as part of       toolchain (make is not required); all other tools are created as part of
      the NetBSD build process.       the NetBSD build process.
   
            Note: A couple of host toolchain components are not yet available  
            in the tools directory.  Also, some tools use non-POSIX, non-ANSI C  
            extensions and need to be standardized.  As a result, cross-compil-  
            ing from systems other than NetBSD is not currently supported.  
   
 FILES  FILES
    Source tree layout     Source tree layout
      doc/BUILDING.mdoc       doc/BUILDING.mdoc
Line 42  FILES
Line 37  FILES
   
      BUILDING       This document (in plaintext).       BUILDING       This document (in plaintext).
   
        tools/compat/README
                       Special notes for cross-hosting a NetBSD build on non-
                       NetBSD platforms.
   
      Makefile       The main Makefile for NetBSD; should only be run for       Makefile       The main Makefile for NetBSD; should only be run for
                     native builds with an appropriately up-to-date version of                      native builds with an appropriately up-to-date version of
                     NetBSD make(1).  (For building from out-of-date systems or                      NetBSD make(1).  (For building from out-of-date systems or
Line 83  FILES
Line 82  FILES
                     any of these directories are missing, they will be skipped                      any of these directories are missing, they will be skipped
                     during the build.                      during the build.
   
        x11/           ``Reachover'' build structure for X11R6; the source is in
                       X11SRCDIR.
   
    Build tree layout     Build tree layout
      The NetBSD build tree is described in hier(7), and the release layout is       The NetBSD build tree is described in hier(7), and the release layout is
      described in release(7).       described in release(7).
Line 141  CONFIGURATION
Line 143  CONFIGURATION
   
                  Default: ``/etc/mk.conf''                   Default: ``/etc/mk.conf''
   
        MAKEVERBOSE
                    Level of verbosity of status messages.  Supported values:
   
                    0    No descriptive messages are shown.
   
                    1    Descriptive messages are shown.
   
                    2    Descriptive messages (prefixed with a `#') and command
                         output is not suppressed.
   
                    Default: 2
   
      MKCATPAGES  Can be set to ``yes'' or ``no''.  Indicates whether prefor-       MKCATPAGES  Can be set to ``yes'' or ``no''.  Indicates whether prefor-
                  matted plaintext manual pages will be created during a build.                   matted plaintext manual pages will be created during a build.
   
Line 233  CONFIGURATION
Line 247  CONFIGURATION
   
                  Default: ``yes''                   Default: ``yes''
   
        MKTTINTERP  Can be set to ``yes'' or ``no''.  For X builds, decides if
                    the TrueType bytecode interpreter is turned on.  See
                    http://www.freetype.org/patents.html for details.
   
                    Default: ``no''
   
      MKUNPRIVED  Can be set to ``yes'' or ``no''.  Indicates whether an       MKUNPRIVED  Can be set to ``yes'' or ``no''.  Indicates whether an
                  unprivileged install will occur.  The user, group, permis-                   unprivileged install will occur.  The user, group, permis-
                  sions, and file flags, will not be set on the installed item;                   sions, and file flags, will not be set on the installed item;
Line 251  CONFIGURATION
Line 271  CONFIGURATION
   
                  Default: ``no''                   Default: ``no''
   
        MKX11       Can be set to ``yes'' or ``no''.  Indicates whether X11R6 is
                    built from X11SRCDIR.
   
                    Default: ``no''
   
      TOOLDIR     Directory to hold the host tools, once built.  This directory       TOOLDIR     Directory to hold the host tools, once built.  This directory
                  should be unique to a given host system and NetBSD source                   should be unique to a given host system and NetBSD source
                  tree.  (However, multiple targets may share the same TOOLDIR;                   tree.  (However, multiple targets may share the same TOOLDIR;
Line 283  CONFIGURATION
Line 308  CONFIGURATION
                  preserve traditional semantics of the <bsd.*.mk> make(1)                   preserve traditional semantics of the <bsd.*.mk> make(1)
                  include files).                   include files).
   
        X11SRCDIR   Directory containing the X11R6 source.  The main X11R6 source
                    is found in X11SRCDIR/xfree/xc.
   
                    Default: ``/usr/xsrc''
   
    "make" variables for full builds     "make" variables for full builds
      These variables only affect the top level ``Makefile'' and do not affect       These variables only affect the top level ``Makefile'' and do not affect
      manually building subtrees of the NetBSD source code.       manually building subtrees of the NetBSD source code.
Line 364  BUILDING
Line 394  BUILDING
                 actually execute them.  This will still cause recursion to                  actually execute them.  This will still cause recursion to
                 take place.                  take place.
   
      -v var     Print make(1)'s idea of the value of var.  Does not build any       -V var     Print make(1)'s idea of the value of var.  Does not build any
                 targets.                  targets.
   
      var=value  Set the variable var to value, overriding any setting speci-       var=value  Set the variable var to value, overriding any setting speci-
Line 383  BUILDING
Line 413  BUILDING
   
      cleandir   Same as clean, but also remove preformatted documentation,       cleandir   Same as clean, but also remove preformatted documentation,
                 dependency files generated by ``make depend'', and any other                  dependency files generated by ``make depend'', and any other
                 files known to be created at build time.  ``make distclean''                  files known to be created at build time.
                 may be used as a synonym, for familiarity with a similar well-  
                 known convention.  
   
      depend     Create dependency files (.depend) containing more detailed       depend     Create dependency files (.depend) containing more detailed
                 information about the dependencies of source code on header                  information about the dependencies of source code on header
Line 396  BUILDING
Line 424  BUILDING
                 This improves cache locality of the build since both passes                  This improves cache locality of the build since both passes
                 read the source files in their entirety.                  read the source files in their entirety.
   
        distclean  Synonym for cleandir.
   
      includes   Build and install system header files.  Typically needed       includes   Build and install system header files.  Typically needed
                 before any system libraries or programs can be built.                  before any system libraries or programs can be built.
   
Line 514  BUILDING
Line 544  BUILDING
   
      sourcesets    Perform ``make sourcesets''.       sourcesets    Perform ``make sourcesets''.
   
      The following command line options alter the behaviour of the above oper-       The following command line options alter the behaviour of the build.sh
      ations: The following command line options alter the behaviour of the       operations described above:
      build.sh operations described above:  
   
      -a arch   Set the value of MACHINE_ARCH to arch.       -a arch   Set the value of MACHINE_ARCH to arch.
   
Line 536  BUILDING
Line 565  BUILDING
                Note: It is highly recommended that you know what you are doing                 Note: It is highly recommended that you know what you are doing
                when you use this option.                 when you use this option.
   
        -h        Print a help message.
   
      -j njob   Passed through to make(1).  Makefiles should use .WAIT or have       -j njob   Passed through to make(1).  Makefiles should use .WAIT or have
                explicit dependancies as necessary to enforce build ordering.                 explicit dependancies as necessary to enforce build ordering.
                If you see build failures with -j, please save complete build                 If you see build failures with -j, please save complete build
Line 565  BUILDING
Line 596  BUILDING
                      sbmips-eb     sbmips     mipseb                       sbmips-eb     sbmips     mipseb
                      sbmips-el     sbmips     mipsel                       sbmips-el     sbmips     mipsel
   
        -N noiselevel
                  Set the ``noisyness'' level of the build, by setting
                  MAKEVERBOSE to noiselevel.
   
      -n        Show the commands that would be executed by build.sh, but do       -n        Show the commands that would be executed by build.sh, but do
                not make any changes.  This is similar in concept to ``make                 not make any changes.  This is similar in concept to ``make
                -n''.                 -n''.
Line 603  BUILDING
Line 638  BUILDING
                place the wrapper in PATH automatically.  Note that wrapper is                 place the wrapper in PATH automatically.  Note that wrapper is
                the full name of the file, not just a directory name.                 the full name of the file, not just a directory name.
   
        -X x11src
                  Set the value of X11SRCDIR to x11src.
   
        -x        Set MKX11=yes.
   
      -Z var    Unset ("zap") the environment variable var.  This is propagated       -Z var    Unset ("zap") the environment variable var.  This is propagated
                to the nbmake wrapper.                 to the nbmake wrapper.
   
Line 663  HISTORY
Line 703  HISTORY
 BUGS  BUGS
      A few platforms are not yet using this build system.       A few platforms are not yet using this build system.
   
 NetBSD                          August 7, 2003                          NetBSD  NetBSD                         February 6, 2003                         NetBSD

Legend:
Removed from v.1.44  
changed lines
  Added in v.1.51

CVSweb <webmaster@jp.NetBSD.org>