xref: /netbsd-src/share/man/man5/mk.conf.5 (revision 481fca6e59249d8ffcf24fef7cfbe7b131bfb080)
1.\"	$NetBSD: mk.conf.5,v 1.7 2000/03/28 01:21:36 enami Exp $
2.\"
3.\"  Copyright (c) 1999 The NetBSD Foundation, Inc.
4.\"  All rights reserved.
5.\"
6.\"  This code is derived from software contributed to The NetBSD Foundation
7.\"  by Luke Mewburn.
8.\"
9.\"  Redistribution and use in source and binary forms, with or without
10.\"  modification, are permitted provided that the following conditions
11.\"  are met:
12.\"  1. Redistributions of source code must retain the above copyright
13.\"     notice, this list of conditions and the following disclaimer.
14.\"  2. Redistributions in binary form must reproduce the above copyright
15.\"     notice, this list of conditions and the following disclaimer in the
16.\"     documentation and/or other materials provided with the distribution.
17.\"  3. All advertising materials mentioning features or use of this software
18.\"     must display the following acknowledgement:
19.\"  	This product includes software developed by Luke Mewburn.
20.\"  4. The name of the author may not be used to endorse or promote products
21.\"     derived from this software without specific prior written permission.
22.\"
23.\"  THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
24.\"  IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
25.\"  OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
26.\"  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
27.\"  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
28.\"  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
29.\"  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
30.\"  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
31.\"  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
32.\"  USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33.\"
34.Dd February 17, 1999
35.Dt MK.CONF 5
36.Os
37.\" turn off hyphenation
38.hym 999
39.Sh NAME
40.Nm mk.conf
41.Nd make configuration file
42.Sh DESCRIPTION
43The
44.Nm
45file overrides various parameters used during the build of the system.
46.Pp
47Listed below are the
48.Nm
49variables that may be set, the values to which each may be set,
50a brief description of what each variable does, and a reference to
51relevant manual pages.
52.Pp
53.Ss NetBSD System variables
54.Bl -tag -width OBJMACHINE
55.It Sy BSDOBJDIR
56The real path to the system
57.Sq obj
58tree, so that
59.Sq "make obj"
60will work correctly.
61Default:
62.Pa /usr/obj .
63.It Sy BSDSRCDIR
64The real path to the system sources, so that
65.Sq "make obj"
66will work correctly.
67Default:
68.Pa /usr/src .
69.It Sy BUILD
70If defined,
71.Sq "make install"
72checks that the targets in the source directories are up-to-date and
73remakes them if they are out of date, instead of blindly trying to install
74out of date or non-existant targets.
75.It Sy COPTS
76Extra options for the C compiler.
77Should be appended to (e.g.,
78.Sy COPTS+=-g ) ,
79rather than explicitly set.
80.It Sy MANZ
81Install manual pages compressed with
82.Xr gzip 1 .
83.It Sy MKCATPAGES
84If
85.Sq no ,
86don't build or install the formatted manual pages.
87.It Sy MKDOC
88If
89.Sq no ,
90don't build or install the miscellaneous documentation.
91.It Sy MKINFO
92If
93.Sq no ,
94don't build or install the TeXinfo Info documentation.
95.It Sy MKLINT
96If
97.Sq no ,
98don't build or install the lint libraries.
99.It Sy MKMAN
100If
101.Sq no ,
102don't build or install the manual pages.
103Sets
104.Sy MKCATPAGES=no .
105.It Sy MKNLS
106If
107.Sq no ,
108don't build or install the NLS files.
109.It Sy MKOBJ
110If
111.Sq no ,
112don't create objdirs.
113.It Sy MKPIC
114If
115.Sq no ,
116don't build or install shared libraries.
117.It Sy MKPICINSTALL
118If
119.Sq no ,
120don't install the
121.Sq *_pic.a
122libraries.
123.It Sy MKPROFILE
124If
125.Sq no ,
126don't build or install the
127.Sq *_p.a
128profiling libraries.
129.It Sy MKSHARE
130If
131.Sq no ,
132set
133.Sy MKCATPAGES=no ,
134.Sy MKDOC=no ,
135.Sy MKINFO=no ,
136.Sy MKMAN=no ,
137.Sy MKNLS=no .
138.It Sy OBJMACHINE
139If defined, creates objdirs of the form
140.Pa obj.<arch> ,
141where
142.Sq <arch>
143is the current architecture (as per
144.Sq "uname -m" ) .
145.It Sy UPDATE
146If defined,
147.Sq "make install"
148only installs targets that are more recently modified in the source
149directories that their installed counterparts.
150.El
151.Pp
152.Ss Pkgsrc system variables
153
154Please see
155.Xr packages 7
156for more variables used internally by the package system and
157.Pa /usr/pkgsrc/mk/mk.conf.example
158for package-specific examples.
159.Sh FILES
160.Bl -tag -width /etc/mk.conf
161.It Pa /etc/mk.conf
162This file.
163.It Pa /usr/pkgsrc/mk/mk.conf.example
164Examples for settings regarding the pkgsrc collection.
165.El
166.Sh SEE ALSO
167.Xr make 1 ,
168.Xr packages 7
169.Sh HISTORY
170The
171.Nm
172file appeared in
173.Nx 1.2 .
174