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