xref: /freebsd/share/man/man5/make.conf.5 (revision 6af83ee0d2941d18880b6aaa2b4facd1d30c6106)
1.\" Copyright (c) 2000
2.\"	Mike W. Meyer
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD$
26.\"
27.Dd February 6, 2005
28.Dt MAKE.CONF 5
29.Os
30.Sh NAME
31.Nm make.conf
32.Nd system build information
33.Sh DESCRIPTION
34The file
35.Nm
36contains settings that control the compilation of the
37.Fx
38sources
39and ported applications.
40The file
41.Nm
42is generally created by the system administrator when the values need
43to be changed from their defaults.
44.Pp
45The purpose of
46.Nm
47is not to run commands or perform compilation actions
48directly.
49Instead, it is included by the
50various makefiles in
51.Pa /usr/src ,
52.Pa /usr/ports
53and
54.Pa /usr/doc
55which conditionalize their
56internal actions according to the settings found there.
57.Pp
58The
59.Pa /etc/make.conf
60file is included from the appropriate
61.Pa Makefile
62which specifies the default settings for all the available options.
63Options need only be specified in
64.Pa /etc/make.conf
65when the system administrator wishes to override these defaults.
66.Pp
67The build procedures occur in four broad areas: the world, the kernel,
68documentations and ports.
69Variables set in
70.Nm
71may be applicable during builds in one, two, or all four of these
72areas.
73They may be specified for a particular build via the
74.Fl D
75option of
76.Xr make 1 .
77.Pp
78The following lists provide a name and short description for each
79variable you can use during the indicated builds.
80The values of
81variables flagged as
82.Vt bool
83are ignored; the variable being
84set at all (even to
85.Dq Li FALSE
86or
87.Dq Li NO )
88causes it to
89be treated as if it were set.
90.Pp
91The following list provides a name and short description for variables
92that are used for all builds, or are used by the
93.Pa makefiles
94for things other than builds.
95.Bl -tag -width Ar
96.It Va ALWAYS_CHECK_MAKE
97.Pq Vt bool
98Instructs the top-level makefile in the source tree (normally
99.Pa /usr/src )
100to always check if
101.Xr make 1
102is up-to-date.
103Normally this is only done for the world and buildworld targets to handle
104upgrades from older versions of
105.Fx .
106.It Va CFLAGS
107.Pq Vt str
108Controls the compiler setting when compiling C code.
109Optimization levels other than
110.Fl O
111and
112.Fl O2
113are not supported.
114.Va BDECFLAGS
115is provided as a set of
116.Xr gcc 1
117settings suggested by
118.An "Bruce Evans" Aq bde@FreeBSD.org
119for developing and testing changes.
120They can be used, if set, by:
121.Pp
122.Bd -literal -offset indent
123CFLAGS+=${BDECFLAGS}
124.Ed
125.It Va CPUTYPE
126.Pq Vt str
127Controls which processor should be targeted for generated
128code.
129This controls processor-specific optimizations in
130certain code (currently only OpenSSL) as well as modifying
131the value of
132.Va CFLAGS
133and
134.Va COPTFLAGS
135to contain the appropriate optimization directive to
136.Xr gcc 1 .
137The automatic setting of
138.Va CFLAGS
139and
140.Va COPTFLAGS
141may be overridden using the
142.Va NO_CPU_CFLAGS
143and
144.Va NO_CPU_COPTFLAGS
145variables, respectively.
146Refer to
147.Pa /usr/share/examples/etc/make.conf
148for a list of recognized
149.Va CPUTYPE
150options.
151.It Va NO_CPU_CFLAGS
152.Pq Vt str
153Setting this variable will prevent CPU specific compiler flags
154from being automatically added to
155.Va CFLAGS
156during compile time.
157.It Va NO_CPU_COPTFLAGS
158.Pq Vt str
159Setting this variable will prevent CPU specific compiler flags
160from being automatically added to
161.Va COPTFLAGS
162during compile time.
163.It Va CVS_UPDATE
164.Pq Vt bool
165Set this to use
166.Xr cvs 1
167to update your ports with
168.Dq Li "make update" .
169.It Va CXXFLAGS
170.Pq Vt str
171Controls the compiler settings when compiling C++ code.
172.Va CXXFLAGS
173is initially set to the value of
174.Va CFLAGS .
175If you want to
176add to the
177.Va CXXFLAGS
178value, use
179.Dq Li +=
180instead of
181.Dq Li = .
182.It Va INSTALL
183.Pq Vt str
184the default install command.
185To install only files for which the target differs or does not exist, use
186.Bd -literal -offset indent
187INSTALL="install -C"
188.Ed
189Note that some makefiles (including those in
190.Pa /usr/share/mk )
191may hardcode options for the supplied install command.
192.It Va LOCAL_DIRS
193.Pq Vt str
194List any directories that should be entered when doing
195make's in
196.Pa /usr/src
197in this variable.
198.It Va MAKE_SHELL
199.Pq Vt str
200Controls the shell used internally by
201.Xr make 1
202to process the command scripts in makefiles.
203.Xr sh 1 ,
204.Xr ksh 1 ,
205and
206.Xr csh 1
207all currently supported.
208.Pp
209.Dl "MAKE_SHELL?=sh"
210.It Va MTREE_FOLLOWS_SYMLINKS
211.Pq Vt str
212Set this to
213.Dq Fl L
214to cause
215.Xr mtree 8
216to follow symlinks.
217.It Va NO_DOCUPDATE
218.Pq Vt bool
219Set this to not update the doc tree during
220.Dq Li "make update" .
221.It Va NO_PORTSUPDATE
222.Pq Vt bool
223Set this to not update the ports tree during
224.Dq Li "make update" .
225.It Va SUP_UPDATE
226.Pq Vt bool
227Set this to use
228.Xr cvsup 1
229to update your ports with
230.Dq Li "make update" .
231.It Va SUP
232.Pq Vt str
233The location of the
234.Xr cvsup 1
235command for
236.Dq Li "make update" .
237.It Va SUPFLAGS
238.Pq Vt str
239The flag for the
240.Xr sup 1
241command when doing
242.Dq Li "make update" .
243This defaults to
244.Op Fl g L Ar 2 .
245.It Va SUPHOST
246.Pq Vt str
247The hostname of the sup server to use when doing
248.Dq Li "make update" .
249.It Va SUPFILE
250.Pq Vt str
251The first
252.Ar supfile
253to use when doing a
254.Dq Li "make update" .
255This defaults to
256.Pa /usr/share/examples/cvsup/standard\-supfile .
257.It Va SUPFILE1
258.Pq Vt str
259The second
260.Ar supfile
261to use when doing a
262.Dq Li "make update" .
263This defaults to
264.Pa /usr/share/examples/cvsup/secure\-supfile .
265.It Va SUPFILE2
266.Pq Vt str
267The third
268.Ar supfile
269to use when doing a
270.Dq Li "make update" .
271This defaults to
272.Pa /usr/share/examples/cvsup/secure\-supfile .
273.It Va PORTSSUPFILE
274.Pq Vt str
275The ports
276.Ar supfile
277to use when doing a
278.Dq Li "make update" .
279This defaults to
280.Pa /usr/share/examples/cvsup/ports\-supfile .
281.It Va DOCSUPFILE
282.Pq Vt str
283The documentation
284.Ar supfile
285to use when doing a
286.Dq Li "make update" .
287This defaults to
288.Pa /usr/share/examples/cvsup/doc\-supfile .
289.El
290.Pp
291The following list provides a name and short description for variables
292that are only used doing a kernel build:
293.Bl -tag -width Ar
294.It Va BOOT_COMCONSOLE_PORT
295.Pq Vt str
296The port address to use for the console if the boot blocks have
297been configured to use a serial console instead of the keyboard/video card.
298.It Va BOOT_COMCONSOLE_SPEED
299.Pq Vt int
300The baud rate to use for the console if the boot blocks have
301been configured to use a serial console instead of the keyboard/video card.
302.It Va BOOTWAIT
303.Pq Vt int
304Controls the amount of time the kernel waits for a console keypress
305before booting the default kernel.
306The value is approximately milliseconds.
307Keypresses are accepted by the BIOS before booting from disk,
308making it possible to give custom boot parameters even when this is
309set to 0.
310.It Va COPTFLAGS
311.Pq Vt str
312Controls the compiler settings when building the
313kernel.
314Optimization levels above
315.Oo Fl O ( O2 , No ...\& ) Oc
316are not guaranteed to work.
317.It Va KERNCONF
318.Pq Vt str
319Controls which kernel configurations will be
320built by
321.Dq Li "${MAKE} buildkernel"
322and installed by
323.Dq Li "${MAKE} installkernel" .
324For example,
325.Bd -literal -offset indent
326KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
327.Ed
328.Pp
329will build the kernels specified by the config files
330.Pa MINE , DEBUG , GENERIC ,
331and
332.Pa OTHERMACHINE ,
333and install the kernel specified by the config file
334.Pa MINE .
335It defaults to
336.Pa GENERIC .
337.It Va LOADER_TFTP_SUPPORT
338.Pq Vt bool
339While not a buildkernel-affected option, there is no better place for this.
340By default the
341.Xr pxeboot 8
342loader retrieves the kernel via NFS.
343Defining this and recompiling
344.Pa /usr/src/sys/boot
345will cause it to retrieve the kernel via TFTP.
346This allows
347.Xr pxeboot 8
348to load a custom BOOTP diskless kernel yet
349still mount the server's
350.Pa /
351rather than load the server's kernel.
352.It Va MODULES_OVERRIDE
353.Pq Vt str
354Set to a list of modules to build instead of all of them.
355.It Va WITHOUT_MODULES
356.Pq Vt str
357Set to a list of modules to exclude from the build.
358This provides a
359somewhat easier way to exclude modules you are certain you will never
360need than specifying
361.Va MODULES_OVERRIDE .
362This is applied
363.Em after
364.Va MODULES_OVERRIDE .
365.It Va PORTS_MODULES
366Set this to the list of ports you wish to rebuild every time the kernel
367is built.
368.It Va NO_KERNELCONFIG
369.Pq Vt bool
370Set this to skip running
371.Xr config 8
372during
373.Dq Li "${MAKE} buildkernel" .
374.It Va NO_KERNELDEPEND
375.Pq Vt bool
376Set this to skip running
377.Dq Li "${MAKE} depend"
378during
379.Dq Li "${MAKE} buildkernel" .
380.It Va NO_MODULES
381.Pq Vt bool
382Set to not build modules with the kernel.
383.El
384.Pp
385The following list provides a name and short description for variables
386that are used during the world build:
387.Bl -tag -width Ar
388.It Va MAKE_IDEA
389.Pq Vt bool
390Set to build the IDEA encryption code.
391This code is patented in the USA and many European countries.
392It is
393.Em "YOUR RESPONSIBILITY"
394to determine if you can legally use IDEA.
395.It Va NO_DYNAMICROOT
396.Pq Vt bool
397Set this if you do not want to link
398.Pa /bin
399and
400.Pa /sbin
401dynamically.
402.It Va NO_KERBEROS
403.Pq Vt bool
404Set this if you do not want to build Kerberos 5 (KTH Heimdal).
405.It Va ENABLE_SUID_K5SU
406.Pq Vt bool
407Set this if you wish to use the ksu utility.
408Otherwise, it will be
409installed without the set-user-ID bit set.
410.It Va ENABLE_SUID_NEWGRP
411.Pq Vt bool
412Set this to install
413.Xr newgrp 1
414with the set-user-ID bit set.
415Otherwise,
416.Xr newgrp 1
417will not be able to change users' groups.
418.It Va ENABLE_SUID_SSH
419.Pq Vt bool
420Set this to install
421.Xr ssh 1
422with the set-user-ID bit turned on.
423.It Va MODULES_WITH_WORLD
424.Pq Vt bool
425Set to build modules with the system instead of the kernel.
426.It Va NO_BLUETOOTH
427.Pq Vt bool
428Set to not build Bluetooth related kernel modules, programs and libraries.
429.It Va NO_BOOT
430.Pq Vt bool
431Set to not build the boot blocks and loader.
432.It Va NO_CVS
433.Pq Vt bool
434Set to not build CVS.
435.It Va NO_CXX
436.Pq Vt bool
437Set to not build
438.Xr g++ 1
439and related libraries.
440.It Va NO_FORTRAN
441.Pq Vt bool
442Set to not build
443.Xr g77 1
444and related libraries.
445.It Va NO_GDB
446.Pq Vt bool
447Set to not build
448.Xr gdb 1 .
449.It Va NO_GPIB
450.Pq Vt bool
451Set to not build GPIB bus support.
452.It Va NO_I4B
453.Pq Vt bool
454Set to not build isdn4bsd package.
455.It Va NO_IPFILTER
456.Pq Vt bool
457Set to not build IP Filter package.
458.It Va NO_PF
459.Pq Vt bool
460Set to not build PF firewall package.
461.It Va NO_AUTHPF
462.Pq Vt bool
463Set to not build
464.Xr authpf 8 .
465.It Va NO_TOOLCHAIN
466.Pq Vt bool
467Set to not build
468programs used for program development,
469compilers, debuggers etc.
470.It Va NO_INET6
471.Pq Vt bool
472Set to not build
473programs and libraries related to IPv6 networking.
474.It Va NO_ATM
475.Pq Vt bool
476Set to not build
477programs and libraries related to ATM networking.
478.It Va NO_USB
479.Pq Vt bool
480Set to not build
481.Xr usbd 8
482and related programs.
483.It Va NO_LPR
484.Pq Vt bool
485Set to not build
486.Xr lpr 1
487and related programs.
488.It Va NO_ACPI
489.Pq Vt bool
490Set to not build
491.Xr acpiconf 8 ,
492.Xr acpidump 8
493and related programs.
494.It Va NO_MAILWRAPPER
495.Pq Vt bool
496Set to not build the
497.Xr mailwrapper 8
498MTA selector.
499.It Va NO_MAN
500.Pq Vt bool
501Set to not build manual pages.
502.It Va NO_NETCAT
503.Pq Vt bool
504Set to not build
505.Xr nc 1
506utility.
507.It Va NO_NIS
508.Pq Vt bool
509Set to not build
510.Xr NIS 8
511support and related programs.
512.It Va NO_OBJC
513.Pq Vt bool
514Set to not build Objective C support.
515.It Va NO_OPENSSH
516.Pq Vt bool
517Set to not build OpenSSH.
518.It Va NO_OPENSSL
519.Pq Vt bool
520Set to not build OpenSSL (implies
521.Va NO_KERBEROS
522and
523.Va NO_OPENSSH ) .
524.It Va NO_SENDMAIL
525.Pq Vt bool
526Set to not build
527.Xr sendmail 8
528and related programs.
529.It Va NO_SHAREDOCS
530.Pq Vt bool
531Set to not build the
532.Bx 4.4
533legacy docs.
534.It Va NO_TCSH
535.Pq Vt bool
536Set to not build and install
537.Pa /bin/csh
538(which is
539.Xr tcsh 1 ) .
540.It Va NO_CLEAN
541.Pq Vt bool
542Set this to disable cleaning during
543.Dq Li "make buildworld" .
544This should not be set unless you know what you are doing.
545.It Va NO_CLEANDIR
546.Pq Vt bool
547Set this to run
548.Dq Li "${MAKE} clean"
549instead of
550.Dq Li "${MAKE} cleandir" .
551.It Va NO_CRYPT
552.Pq Vt bool
553Set to not build any crypto code.
554.It Va NO_GAMES
555.Pq Vt bool
556Set to not build games.
557.It Va NO_INFO
558.Pq Vt bool
559Set to not make or install
560.Xr info 5
561files.
562.It Va NO_LIBC_R
563.Pq Vt bool
564Set to not build
565.Nm libc_r
566(reentrant version of
567.Nm libc ) .
568.It Va NO_LIBPTHREAD
569.Pq Vt bool
570Set to not build the
571.Nm libpthread
572(M:N threading)
573library.
574.It Va NO_LIBTHR
575.Pq Vt bool
576Set to not build the
577.Nm libthr
578(1:1 threading)
579library.
580.It Va NO_MANCOMPRESS
581.Pq Vt bool
582Set to install man pages uncompressed.
583.It Va NO_PROFILE
584.Pq Vt bool
585Set to avoid compiling profiled libraries.
586.It Va NO_SHARE
587.Pq Vt bool
588Set to not build in the
589.Pa share
590subdir.
591.It Va NO_SHARED
592.Pq Vt bool
593Set to not build
594.Pa /bin
595and
596.Pa /sbin
597dynamically linked, this can be bad.
598.It Va NO_BIND
599.Pq Vt bool
600Setting this variable will prevent any part of BIND from being built,
601regardless of the presence of any of the other *_BIND_* variables below.
602.It Va NO_BIND_DNSSEC
603.Pq Vt bool
604Set to avoid building or installing the DNSSEC related binaries,
605.Xr dnssec-keygen 8
606and
607.Xr dnssec-signzone 8 .
608.It Va NO_BIND_ETC
609.Pq Vt bool
610Set to avoid installing the default files to
611.Pa /var/named/etc/namedb .
612.It Va NO_BIND_LIBS_LWRES
613.Pq Vt bool
614Set to avoid installing the lightweight resolver library in
615.Pa /usr/lib .
616The library that is private to the build system may still be built as needed.
617.It Va NO_BIND_MTREE
618.Pq Vt bool
619Set to avoid running
620.Xr mtree 8
621to create the chroot directory structure under
622.Pa /var/named ,
623and avoid creating an
624.Pa /etc/namedb
625symlink to the chroot directory.
626This option should typically be used together with
627.Vt NO_BIND_ETC .
628.It Va NO_BIND_NAMED
629.Pq Vt bool
630Set to avoid building or installing
631.Xr named 8 ,
632.Xr named.reload 8 ,
633.Xr named-checkconf 8 ,
634.Xr named-checkzone 8 ,
635.Xr rndc 8 ,
636and
637.Xr rndc-confgen 8 .
638.It Va NO_BIND_UTILS
639.Pq Vt bool
640Set to avoid building or installing the BIND userland utilities,
641.Xr dig 1 ,
642.Xr host 1 ,
643.Xr nslookup 1 ,
644and
645.Xr nsupdate 8 .
646.It Va WITH_BIND_LIBS
647.Pq Vt bool
648Set to install BIND libraries and include files.
649.It Va PPP_NO_NAT
650.Pq Vt bool
651Build
652.Xr ppp 8
653without support for network address translation (NAT).
654.It Va PPP_NO_NETGRAPH
655.Pq Vt bool
656Set to build
657.Xr ppp 8
658without support for Netgraph.
659.It Va PPP_NO_RADIUS
660.Pq Vt bool
661Set to build
662.Xr ppp 8
663without support for RADIUS.
664.It Va PPP_NO_SUID
665.Pq Vt bool
666Set to disable the installation of
667.Xr ppp 8
668as a set-user-ID root program.
669.It Va SENDMAIL_MC
670.Pq Vt str
671The default
672.Xr m4 1
673configuration file to use at install time.
674The value should include the full path to the
675.Pa .mc
676file, e.g.,
677.Pa /etc/mail/myconfig.mc .
678Use with caution as a make install will overwrite any existing
679.Pa /etc/mail/sendmail.cf .
680Note that
681.Va SENDMAIL_CF
682is now deprecated.
683.It Va SENDMAIL_SUBMIT_MC
684.Pq Vt str
685The default
686.Xr m4 1
687configuration file for mail submission
688to use at install time.
689The value should include the full path to the
690.Pa .mc
691file, e.g.,
692.Pa /etc/mail/mysubmit.mc .
693Use with caution as a make install will overwrite any existing
694.Pa /etc/mail/submit.cf .
695.It Va SENDMAIL_ADDITIONAL_MC
696.Pq Vt str
697Additional
698.Pa .mc
699files which should be built into
700.Pa .cf
701files at build time.
702The value should include the full path to the
703.Pa .mc
704file(s), e.g.,
705.Pa /etc/mail/foo.mc
706.Pa /etc/mail/bar.mc .
707.It Va SENDMAIL_CF_DIR
708.Pq Vt str
709Override the default location for the
710.Xr m4 1
711configuration files used to build a
712.Pa .cf
713file from a
714.Pa .mc
715file.
716.It Va SENDMAIL_M4_FLAGS
717.Pq Vt str
718Flags passed to
719.Xr m4 1
720when building a
721.Pa .cf
722file from a
723.Pa .mc
724file.
725.It Va SENDMAIL_CFLAGS
726.Pq Vt str
727Flags to pass to the compile command when building
728.Xr sendmail 8 .
729The
730.Va SENDMAIL_*
731flags can be used to provide SASL support with setting such as:
732.Bd -literal -offset indent
733SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
734SENDMAIL_LDFLAGS=-L/usr/local/lib
735SENDMAIL_LDADD=-lsasl
736.Ed
737.It Va SENDMAIL_LDFLAGS
738.Pq Vt str
739Flags to pass to the
740.Xr ld 1
741command when building
742.Xr sendmail 8 .
743.It Va SENDMAIL_LDADD
744.Pq Vt str
745Flags to add to the end of the
746.Xr ld 1
747command when building
748.Xr sendmail 8 .
749.It Va SENDMAIL_DPADD
750.Pq Vt str
751Extra dependencies to add when building
752.Xr sendmail 8 .
753.It Va SENDMAIL_SET_USER_ID
754.Pq Vt bool
755If set, install
756.Xr sendmail 8
757as a set-user-ID root binary instead of a set-group-ID binary
758and do not install
759.Pa /etc/mail/submit.{cf,mc} .
760Use of this flag is not recommended and the alternative advice in
761.Pa /etc/mail/README
762should be followed instead if at all possible.
763.It Va SENDMAIL_MAP_PERMS
764.Pq Vt str
765Mode to use when generating alias and map database files using
766.Pa /etc/mail/Makefile .
767The default value is 0640.
768.It Va TOP_TABLE_SIZE
769.Pq Vt int
770.Xr top 1
771uses a hash table for the user names.
772The size of this hash can be tuned to match the number of local users.
773The table size should be a prime number
774approximately twice as large as the number of lines in
775.Pa /etc/passwd .
776The default number is 20011.
777.It Va WANT_FORCE_OPTIMIZATION_DOWNGRADE
778.Pq Vt int
779Causes the system compiler to be built such that it forces high optimization
780levels to a lower one.
781.Xr gcc 1
782.Fl O2
783and above is known to trigger known optimizer bugs at various
784times \(em this is worse on the Alpha platform.
785The value assigned is the highest optimization value used.
786.El
787.Pp
788The following list provides a name and short description for variables
789that are used when building documentation.
790.Bl -tag -width Ar
791.It Va DISTDIR
792.Pq Vt str
793Where distfiles are kept.
794Normally, this is
795.Pa distfiles
796in
797.Va PORTSDIR .
798.It Va DOC_LANG
799.Pq Vt str
800The list of languages and encodings to build and install.
801.It Va PRINTERDEVICE
802.Pq Vt str
803The default format for system documentation, depends on your
804printer.
805This can be set to
806.Dq Li ascii
807for simple printers, or
808.Dq Li ps
809for postscript or graphics printers with a ghostscript
810filter, or both.
811.El
812.Sh FILES
813.Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact
814.It Pa /etc/make.conf
815.It Pa /usr/doc/Makefile
816.It Pa /usr/share/examples/etc/make.conf
817.It Pa /usr/src/Makefile
818.It Pa /usr/src/Makefile.inc1
819.El
820.Sh SEE ALSO
821.Xr gcc 1 ,
822.Xr install 1 ,
823.Xr make 1 ,
824.Xr ports 7 ,
825.Xr lpd 8 ,
826.Xr sendmail 8
827.Sh HISTORY
828The
829.Nm
830file appeared sometime before
831.Fx 4.0 .
832.Sh AUTHORS
833This
834manual page was written by
835.An Mike W. Meyer Aq mwm@mired.org .
836.Sh BUGS
837This manual page may occasionally be out of date with respect to
838the options currently available for use in
839.Nm .
840Please check the
841.Pa /usr/share/examples/etc/make.conf
842file for the latest options which are available.
843.Sh CAVEATS
844Note, that
845.Ev MAKEOBJDIRPREFIX
846and
847.Ev MAKEOBJDIR
848are environment variables and should not be set in
849.Nm
850but in make's environment.
851