share/man/man5/make.conf.5

   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 January 21, 2013
  28 .Dt MAKE.CONF 5
  29 .Os
  30 .Sh NAME
  31 .Nm make.conf
  32 .Nd system build information
  33 .Sh DESCRIPTION
  34 The file
  35 .Nm
  36 contains system-wide settings that will apply to every build using
  37 .Xr make 1
  38 and the standard
  39 .Pa sys.mk
  40 file.
  41 This is achieved as follows:
  42 .Xr make 1
  43 processes the system makefile
  44 .Pa sys.mk
  45 before any other file by default, and
  46 .Pa sys.mk
  47 includes
  48 .Nm .
  49 .Pp
  50 The file
  51 .Nm
  52 uses the standard makefile syntax.
  53 However,
  54 .Nm
  55 should not specify any dependencies to
  56 .Xr make 1 .
  57 Instead,
  58 .Nm
  59 is to set
  60 .Xr make 1
  61 variables that control the actions of other makefiles.
  62 .Pp
  63 The default location of
  64 .Nm
  65 is
  66 .Pa /etc/make.conf ,
  67 though an alternative location can be specified in the
  68 .Xr make 1
  69 variable
  70 .Va __MAKE_CONF .
  71 You may need to override the location of
  72 .Nm
  73 if the system-wide settings are not suitable for a particular build.
  74 For instance, setting
  75 .Va __MAKE_CONF
  76 to
  77 .Pa /dev/null
  78 effectively resets all build controls to their defaults.
  79 .Pp
  80 The primary purpose of
  81 .Nm
  82 is to control the compilation of the
  83 .Fx
  84 sources, documentation, and ported applications,
  85 which are usually found in
  86 .Pa /usr/src ,
  87 .Pa /usr/doc ,
  88 and
  89 .Pa /usr/ports .
  90 As a rule, the system administrator creates
  91 .Nm
  92 when the values of certain control variables need to be changed
  93 from their defaults.
  94 .Pp
  95 The system build procedures occur in four broad areas:
  96 the world, the kernel, documentation and ports.
  97 Variables set in
  98 .Nm
  99 may be applicable in one, two, or all four of these areas.
 100 In addition, control variables can be specified
 101 for a particular build via the
 102 .Fl D
 103 option of
 104 .Xr make 1
 105 or in
 106 .Xr environ 7 .
 107 .Pp
 108 The following lists provide a name and short description for each
 109 variable you can use during the indicated builds.
 110 The values of
 111 variables flagged as
 112 .Vt bool
 113 are ignored; the variable being
 114 set at all (even to
 115 .Dq Li FALSE
 116 or
 117 .Dq Li NO )
 118 causes it to
 119 be treated as if it were set.
 120 .Pp
 121 The following list provides a name and short description for variables
 122 that are used for all builds, or are used by the
 123 .Pa makefiles
 124 for things other than builds.
 125 .Bl -tag -width Ar
 126 .It Va ALWAYS_CHECK_MAKE
 127 .Pq Vt bool
 128 Instructs the top-level makefile in the source tree (normally
 129 .Pa /usr/src )
 130 to always check if
 131 .Xr make 1
 132 is up-to-date.
 133 Normally this is only done for the world and buildworld targets to handle
 134 upgrades from older versions of
 135 .Fx .
 136 .It Va CFLAGS
 137 .Pq Vt str
 138 Controls the compiler setting when compiling C code.
 139 Optimization levels other than
 140 .Fl O
 141 and
 142 .Fl O2
 143 are not supported.
 144 .Va BDECFLAGS
 145 is provided as a set of
 146 .Xr gcc 1
 147 settings suggested by
 148 .An "Bruce Evans" Aq bde@FreeBSD.org
 149 for developing and testing changes.
 150 They can be used, if set, by:
 151 .Bd -literal -offset indent
 152 CFLAGS+=${BDECFLAGS}
 153 .Ed
 154 .It Va CPUTYPE
 155 .Pq Vt str
 156 Controls which processor should be targeted for generated
 157 code.
 158 This controls processor-specific optimizations in
 159 certain code (currently only OpenSSL) as well as modifying
 160 the value of
 161 .Va CFLAGS
 162 and
 163 .Va COPTFLAGS
 164 to contain the appropriate optimization directive to
 165 .Xr gcc 1 .
 166 The automatic setting of
 167 .Va CFLAGS
 168 and
 169 .Va COPTFLAGS
 170 may be overridden using the
 171 .Va NO_CPU_CFLAGS
 172 and
 173 .Va NO_CPU_COPTFLAGS
 174 variables, respectively.
 175 Refer to
 176 .Pa /usr/share/examples/etc/make.conf
 177 for a list of recognized
 178 .Va CPUTYPE
 179 options.
 180 .It Va CVS_UPDATE
 181 .Pq Vt bool
 182 Set this to use
 183 .Xr cvs 1
 184 to update your
 185 .Pa src , ports
 186 and
 187 .Pa doc
 188 trees with
 189 .Dq Li "make update" .
 190 .It Va CXXFLAGS
 191 .Pq Vt str
 192 Controls the compiler settings when compiling C++ code.
 193 .Va CXXFLAGS
 194 is initially set to the value of
 195 .Va CFLAGS .
 196 If you want to
 197 add to the
 198 .Va CXXFLAGS
 199 value, use
 200 .Dq Li +=
 201 instead of
 202 .Dq Li = .
 203 .It Va INSTALL
 204 .Pq Vt str
 205 the default install command.
 206 To install only files for which the target differs or does not exist, use
 207 .Bd -literal -offset indent
 208 INSTALL="install -C"
 209 .Ed
 210 Note that some makefiles (including those in
 211 .Pa /usr/share/mk )
 212 may hardcode options for the supplied install command.
 213 .It Va LOCAL_DIRS
 214 .Pq Vt str
 215 List any directories that should be entered when doing
 216 make's in
 217 .Pa /usr/src
 218 in this variable.
 219 .It Va MAKE_SHELL
 220 .Pq Vt str
 221 Controls the shell used internally by
 222 .Xr make 1
 223 to process the command scripts in makefiles.
 224 .Xr sh 1 ,
 225 .Xr ksh 1 ,
 226 and
 227 .Xr csh 1
 228 all currently supported.
 229 .Pp
 230 .Dl "MAKE_SHELL?=sh"
 231 .It Va MTREE_FOLLOWS_SYMLINKS
 232 .Pq Vt str
 233 Set this to
 234 .Dq Fl L
 235 to cause
 236 .Xr mtree 8
 237 to follow symlinks.
 238 .It Va NO_CPU_CFLAGS
 239 .Pq Vt str
 240 Setting this variable will prevent CPU specific compiler flags
 241 from being automatically added to
 242 .Va CFLAGS
 243 during compile time.
 244 .It Va NO_CPU_COPTFLAGS
 245 .Pq Vt str
 246 Setting this variable will prevent CPU specific compiler flags
 247 from being automatically added to
 248 .Va COPTFLAGS
 249 during compile time.
 250 .It Va NO_DOCUPDATE
 251 .Pq Vt bool
 252 Set this to not update the doc tree during
 253 .Dq Li "make update" .
 254 .It Va NO_PORTSUPDATE
 255 .Pq Vt bool
 256 Set this to not update the ports tree during
 257 .Dq Li "make update" .
 258 .It Va SUP
 259 .Pq Vt str
 260 The location of the
 261 .Xr csup 1
 262 or
 263 .Xr cvsup 1
 264 command for
 265 .Dq Li "make update" .
 266 .It Va SUPFILE
 267 .Pq Vt str
 268 The first
 269 .Ar supfile
 270 to use when doing a
 271 .Dq Li "make update" .
 272 For example,
 273 .Pa /usr/share/examples/cvsup/standard-supfile .
 274 .It Va SUPFILE1
 275 .Pq Vt str
 276 The second
 277 .Ar supfile
 278 to use when doing a
 279 .Dq Li "make update" .
 280 .It Va SUPFILE2
 281 .Pq Vt str
 282 The third
 283 .Ar supfile
 284 to use when doing a
 285 .Dq Li "make update" .
 286 .It Va SUPFLAGS
 287 .Pq Vt str
 288 The flag for the
 289 .Xr sup 1
 290 command when doing
 291 .Dq Li "make update" .
 292 This defaults to
 293 .Op Fl g L Ar 2 .
 294 .It Va SUPHOST
 295 .Pq Vt str
 296 The hostname of the sup server to use when doing
 297 .Dq Li "make update" .
 298 .It Va SUP_UPDATE
 299 .Pq Vt bool
 300 Set this to use
 301 .Xr csup 1
 302 to update your
 303 .Pa src ,
 304 and
 305 .Pa ports
 306 trees with
 307 .Dq Li "make update" .
 308 This option is deprecated.
 309 Please use
 310 .Va SVN_UPDATE
 311 or
 312 .Xr freebsd-update 8 .
 313 .It Va SVN_UPDATE
 314 .Pq Vt bool
 315 Set this to use
 316 .Xr svn 1
 317 to update your
 318 .Pa src
 319 tree with
 320 .Dq Li "make update" .
 321 Note that since a subversion client is not included in the base system,
 322 you will need to set
 323 .Va SVN
 324 to the full path of a
 325 .Xr svn 1
 326 binary.
 327 .El
 328 .Ss "BUILDING THE KERNEL"
 329 The following list provides a name and short description for variables
 330 that are only used doing a kernel build:
 331 .Bl -tag -width Ar
 332 .It Va BOOTWAIT
 333 .Pq Vt int
 334 Controls the amount of time the kernel waits for a console keypress
 335 before booting the default kernel.
 336 The value is approximately milliseconds.
 337 Keypresses are accepted by the BIOS before booting from disk,
 338 making it possible to give custom boot parameters even when this is
 339 set to 0.
 340 .It Va COPTFLAGS
 341 .Pq Vt str
 342 Controls the compiler settings when building the
 343 kernel.
 344 Optimization levels above
 345 .Oo Fl O ( O2 , No ...\& ) Oc
 346 are not guaranteed to work.
 347 .It Va KERNCONF
 348 .Pq Vt str
 349 Controls which kernel configurations will be
 350 built by
 351 .Dq Li "${MAKE} buildkernel"
 352 and installed by
 353 .Dq Li "${MAKE} installkernel" .
 354 For example,
 355 .Bd -literal -offset indent
 356 KERNCONF=MINE DEBUG GENERIC OTHERMACHINE
 357 .Ed
 358 .Pp
 359 will build the kernels specified by the config files
 360 .Pa MINE , DEBUG , GENERIC ,
 361 and
 362 .Pa OTHERMACHINE ,
 363 and install the kernel specified by the config file
 364 .Pa MINE .
 365 It defaults to
 366 .Pa GENERIC .
 367 .It Va MODULES_OVERRIDE
 368 .Pq Vt str
 369 Set to a list of modules to build instead of all of them.
 370 .It Va NO_KERNELCLEAN
 371 .Pq Vt bool
 372 Set this to skip running
 373 .Dq Li "${MAKE} clean"
 374 during
 375 .Dq Li "${MAKE} buildkernel" .
 376 .It Va NO_KERNELCONFIG
 377 .Pq Vt bool
 378 Set this to skip running
 379 .Xr config 8
 380 during
 381 .Dq Li "${MAKE} buildkernel" .
 382 .It Va NO_KERNELDEPEND
 383 .Pq Vt bool
 384 Set this to skip running
 385 .Dq Li "${MAKE} depend"
 386 during
 387 .Dq Li "${MAKE} buildkernel" .
 388 .It Va NO_KERNELOBJ
 389 .Pq Vt bool
 390 Set this to skip running
 391 .Dq Li "${MAKE} obj"
 392 during
 393 .Dq Li "${MAKE} buildkernel" .
 394 .It Va NO_MODULES
 395 .Pq Vt bool
 396 Set to not build modules with the kernel.
 397 .It Va PORTS_MODULES
 398 Set this to the list of ports you wish to rebuild every time the kernel
 399 is built.
 400 .It Va WITHOUT_MODULES
 401 .Pq Vt str
 402 Set to a list of modules to exclude from the build.
 403 This provides a
 404 somewhat easier way to exclude modules you are certain you will never
 405 need than specifying
 406 .Va MODULES_OVERRIDE .
 407 This is applied
 408 .Em after
 409 .Va MODULES_OVERRIDE .
 410 .El
 411 .Ss "BUILDING THE WORLD"
 412 The following list provides a name and short description for variables
 413 that are used during the world build:
 414 .Bl -tag -width Ar
 415 .It Va BOOT_COMCONSOLE_PORT
 416 .Pq Vt str
 417 The port address to use for the console if the boot blocks have
 418 been configured to use a serial console instead of the keyboard/video card.
 419 .It Va BOOT_COMCONSOLE_SPEED
 420 .Pq Vt int
 421 The baud rate to use for the console if the boot blocks have
 422 been configured to use a serial console instead of the keyboard/video card.
 423 .It Va BOOT_PXELDR_ALWAYS_SERIAL
 424 .Pq Vt bool
 425 Compile in the code into
 426 .Xr pxeboot 8
 427 that forces the use of a serial console.
 428 This is analogous to the
 429 .Fl h
 430 option in
 431 .Xr boot 8
 432 blocks.
 433 .It Va BOOT_PXELDR_PROBE_KEYBOARD
 434 .Pq Vt bool
 435 Compile in the code into
 436 .Xr pxeboot 8
 437 that probes the keyboard.
 438 If no keyboard is found, boot with the dual console configuration.
 439 This is analogous to the
 440 .Fl D
 441 option in
 442 .Xr boot 8
 443 blocks.
 444 .It Va ENABLE_SUID_K5SU
 445 .Pq Vt bool
 446 Set this if you wish to use the ksu utility.
 447 Otherwise, it will be
 448 installed without the set-user-ID bit set.
 449 .It Va ENABLE_SUID_NEWGRP
 450 .Pq Vt bool
 451 Set this to install
 452 .Xr newgrp 1
 453 with the set-user-ID bit set.
 454 Otherwise,
 455 .Xr newgrp 1
 456 will not be able to change users' groups.
 457 .It Va ENABLE_SUID_SSH
 458 .Pq Vt bool
 459 Set this to install
 460 .Xr ssh 1
 461 with the set-user-ID bit turned on.
 462 .It Va LOADER_TFTP_SUPPORT
 463 .Pq Vt bool
 464 By default the
 465 .Xr pxeboot 8
 466 loader retrieves the kernel via NFS.
 467 Defining this and recompiling
 468 .Pa /usr/src/sys/boot
 469 will cause it to retrieve the kernel via TFTP.
 470 This allows
 471 .Xr pxeboot 8
 472 to load a custom BOOTP diskless kernel yet
 473 still mount the server's
 474 .Pa /
 475 rather than load the server's kernel.
 476 .It Va LOADER_FIREWIRE_SUPPORT
 477 .Pq Vt bool
 478 Defining this and recompiling
 479 .Pa /usr/src/sys/boot/i386
 480 will add
 481 .Xr dcons 4
 482 console driver to
 483 .Xr loader 8
 484 and allow access over FireWire(IEEE1394) using
 485 .Xr dconschat 8 .
 486 Currently, only i386 and amd64 are supported.
 487 .It Va MALLOC_PRODUCTION
 488 .Pq Vt bool
 489 Set this to disable assertions and statistics gathering in
 490 .Xr malloc 3 .
 491 It also defaults the A and J runtime options to off.
 492 Disabled by default on -CURRENT.
 493 .It Va MODULES_WITH_WORLD
 494 .Pq Vt bool
 495 Set to build modules with the system instead of the kernel.
 496 .It Va NO_CLEAN
 497 .Pq Vt bool
 498 Set this to disable cleaning during
 499 .Dq Li "make buildworld" .
 500 This should not be set unless you know what you are doing.
 501 .It Va NO_CLEANDIR
 502 .Pq Vt bool
 503 Set this to run
 504 .Dq Li "${MAKE} clean"
 505 instead of
 506 .Dq Li "${MAKE} cleandir" .
 507 .It Va NO_MANCOMPRESS
 508 .Pq Vt bool
 509 Set to install manual pages uncompressed.
 510 .It Va NO_SHARE
 511 .Pq Vt bool
 512 Set to not build in the
 513 .Pa share
 514 subdir.
 515 .It Va NO_SHARED
 516 .Pq Vt bool
 517 Set to build
 518 .Pa /bin
 519 and
 520 .Pa /sbin
 521 statically linked, this can be bad.
 522 If set, every utility that uses
 523 .Pa bsd.prog.mk
 524 will be linked statically.
 525 .It Va PPP_NO_NAT
 526 .Pq Vt bool
 527 Build
 528 .Xr ppp 8
 529 without support for network address translation (NAT).
 530 .It Va PPP_NO_NETGRAPH
 531 .Pq Vt bool
 532 Set to build
 533 .Xr ppp 8
 534 without support for Netgraph.
 535 .It Va PPP_NO_RADIUS
 536 .Pq Vt bool
 537 Set to build
 538 .Xr ppp 8
 539 without support for RADIUS.
 540 .It Va PPP_NO_SUID
 541 .Pq Vt bool
 542 Set to disable the installation of
 543 .Xr ppp 8
 544 as a set-user-ID root program.
 545 .It Va SENDMAIL_ADDITIONAL_MC
 546 .Pq Vt str
 547 Additional
 548 .Pa .mc
 549 files which should be built into
 550 .Pa .cf
 551 files at build time.
 552 The value should include the full path to the
 553 .Pa .mc
 554 file(s), e.g.,
 555 .Pa /etc/mail/foo.mc ,
 556 .Pa /etc/mail/bar.mc .
 557 .It Va SENDMAIL_ALIASES
 558 .Pq Vt str
 559 List of
 560 .Xr aliases 5
 561 files to rebuild when using
 562 .Pa /etc/mail/Makefile .
 563 The default value is
 564 .Pa /etc/mail/aliases .
 565 .It Va SENDMAIL_CFLAGS
 566 .Pq Vt str
 567 Flags to pass to the compile command when building
 568 .Xr sendmail 8 .
 569 The
 570 .Va SENDMAIL_*
 571 flags can be used to provide SASL support with setting such as:
 572 .Bd -literal -offset indent
 573 SENDMAIL_CFLAGS=-I/usr/local/include -DSASL
 574 SENDMAIL_LDFLAGS=-L/usr/local/lib
 575 SENDMAIL_LDADD=-lsasl
 576 .Ed
 577 .It Va SENDMAIL_CF_DIR
 578 .Pq Vt str
 579 Override the default location for the
 580 .Xr m4 1
 581 configuration files used to build a
 582 .Pa .cf
 583 file from a
 584 .Pa .mc
 585 file.
 586 .It Va SENDMAIL_DPADD
 587 .Pq Vt str
 588 Extra dependencies to add when building
 589 .Xr sendmail 8 .
 590 .It Va SENDMAIL_LDADD
 591 .Pq Vt str
 592 Flags to add to the end of the
 593 .Xr ld 1
 594 command when building
 595 .Xr sendmail 8 .
 596 .It Va SENDMAIL_LDFLAGS
 597 .Pq Vt str
 598 Flags to pass to the
 599 .Xr ld 1
 600 command when building
 601 .Xr sendmail 8 .
 602 .It Va SENDMAIL_M4_FLAGS
 603 .Pq Vt str
 604 Flags passed to
 605 .Xr m4 1
 606 when building a
 607 .Pa .cf
 608 file from a
 609 .Pa .mc
 610 file.
 611 .It Va SENDMAIL_MAP_PERMS
 612 .Pq Vt str
 613 Mode to use when generating alias and map database files using
 614 .Pa /etc/mail/Makefile .
 615 The default value is 0640.
 616 .It Va SENDMAIL_MAP_SRC
 617 .Pq Vt str
 618 Additional maps to rebuild when using
 619 .Pa /etc/mail/Makefile .
 620 The
 621 .Pa access ,
 622 .Pa bitdomain ,
 623 .Pa domaintable ,
 624 .Pa genericstable ,
 625 .Pa mailertable ,
 626 .Pa uucpdomain ,
 627 and
 628 .Pa virtusertable
 629 maps are always rebuilt if they exist.
 630 .It Va SENDMAIL_MAP_TYPE
 631 .Pq Vt str
 632 Database map type to use when generating map database files using
 633 .Pa /etc/mail/Makefile .
 634 The default value is hash.
 635 The alternative is btree.
 636 .It Va SENDMAIL_MC
 637 .Pq Vt str
 638 The default
 639 .Xr m4 1
 640 configuration file to use at install time.
 641 The value should include the full path to the
 642 .Pa .mc
 643 file, e.g.,
 644 .Pa /etc/mail/myconfig.mc .
 645 Use with caution as a make install will overwrite any existing
 646 .Pa /etc/mail/sendmail.cf .
 647 Note that
 648 .Va SENDMAIL_CF
 649 is now deprecated.
 650 .It Va SENDMAIL_SET_USER_ID
 651 .Pq Vt bool
 652 If set, install
 653 .Xr sendmail 8
 654 as a set-user-ID root binary instead of a set-group-ID binary
 655 and do not install
 656 .Pa /etc/mail/submit.{cf,mc} .
 657 Use of this flag is not recommended and the alternative advice in
 658 .Pa /etc/mail/README
 659 should be followed instead if at all possible.
 660 .It Va SENDMAIL_START_SCRIPT
 661 .Pq Vt str
 662 The script used by
 663 .Pa /etc/mail/Makefile
 664 to start, stop, and restart
 665 .Xr sendmail 8 .
 666 The default value is
 667 .Pa /etc/rc.sendmail .
 668 This value should match the
 669 .Dq Li mta_start_script
 670 setting in
 671 .Xr rc.conf 5 .
 672 .It Va SENDMAIL_SUBMIT_MC
 673 .Pq Vt str
 674 The default
 675 .Xr m4 1
 676 configuration file for mail submission
 677 to use at install time.
 678 The value should include the full path to the
 679 .Pa .mc
 680 file, e.g.,
 681 .Pa /etc/mail/mysubmit.mc .
 682 Use with caution as a make install will overwrite any existing
 683 .Pa /etc/mail/submit.cf .
 684 .It Va TOP_TABLE_SIZE
 685 .Pq Vt int
 686 .Xr top 1
 687 uses a hash table for the user names.
 688 The size of this hash can be tuned to match the number of local users.
 689 The table size should be a prime number
 690 approximately twice as large as the number of lines in
 691 .Pa /etc/passwd .
 692 The default number is 20011.
 693 .It Va WANT_FORCE_OPTIMIZATION_DOWNGRADE
 694 .Pq Vt int
 695 Causes the system compiler to be built such that it forces high optimization
 696 levels to a lower one.
 697 .Xr gcc 1
 698 .Fl O2
 699 and above is known to trigger known optimizer bugs at various
 700 times.
 701 The value assigned is the highest optimization value used.
 702 .El
 703 .Ss "BUILDING DOCUMENTATION"
 704 The following list provides a name and short description for variables
 705 that are used when building documentation.
 706 .Bl -tag -width ".Va PRINTERDEVICE"
 707 .It Va DISTDIR
 708 .Pq Vt str
 709 Where distfiles are kept.
 710 Normally, this is
 711 .Pa distfiles
 712 in
 713 .Va PORTSDIR .
 714 .It Va DOC_LANG
 715 .Pq Vt str
 716 The list of languages and encodings to build and install.
 717 .It Va PRINTERDEVICE
 718 .Pq Vt str
 719 The default format for system documentation, depends on your
 720 printer.
 721 This can be set to
 722 .Dq Li ascii
 723 for simple printers, or
 724 .Dq Li ps
 725 for postscript or graphics printers with a ghostscript
 726 filter, or both.
 727 .El
 728 .Sh FILES
 729 .Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact
 730 .It Pa /etc/make.conf
 731 .It Pa /usr/doc/Makefile
 732 .It Pa /usr/ports/Makefile
 733 .It Pa /usr/share/examples/etc/make.conf
 734 .It Pa /usr/share/mk/sys.mk
 735 .It Pa /usr/src/Makefile
 736 .It Pa /usr/src/Makefile.inc1
 737 .El
 738 .Sh SEE ALSO
 739 .Xr gcc 1 ,
 740 .Xr install 1 ,
 741 .Xr make 1 ,
 742 .Xr src.conf 5 ,
 743 .Xr environ 7 ,
 744 .Xr ports 7 ,
 745 .Xr sendmail 8
 746 .Sh HISTORY
 747 The
 748 .Nm
 749 file appeared sometime before
 750 .Fx 4.0 .
 751 .Sh AUTHORS
 752 This
 753 manual page was written by
 754 .An Mike W. Meyer Aq mwm@mired.org .
 755 .Sh CAVEATS
 756 Note, that
 757 .Ev MAKEOBJDIRPREFIX
 758 and
 759 .Ev MAKEOBJDIR
 760 are environment variables and should not be set in
 761 .Nm
 762 but in make's environment.
 763 .Sh BUGS
 764 This manual page may occasionally be out of date with respect to
 765 the options currently available for use in
 766 .Nm .
 767 Please check the
 768 .Pa /usr/share/examples/etc/make.conf
 769 file for the latest options which are available.