Deleted Added
full compact
bsd.README (313223) bsd.README (313790)
1# @(#)bsd.README 8.2 (Berkeley) 4/2/94
1# @(#)bsd.README 8.2 (Berkeley) 4/2/94
2# $FreeBSD: stable/10/share/mk/bsd.README 313223 2017-02-04 16:40:28Z ngie $
2# $FreeBSD: stable/10/share/mk/bsd.README 313790 2017-02-16 05:14:07Z ngie $
3
4This is the README file for the "include" files for the FreeBSD
5source tree. The files are installed in /usr/share/mk, and are by
6convention, named with the suffix ".mk". These files store several
7build options and should be handled with caution.
8
9Note, this file is not intended to replace reading through the .mk
10files for anything tricky.

--- 476 unchanged lines hidden (view full) ---

487
488The include file <bsd.test.mk> handles building one or more test programs
489intended to be used in the FreeBSD Test Suite under /usr/tests/.
490
491It has seven targets:
492
493 all:
494 build the test programs.
3
4This is the README file for the "include" files for the FreeBSD
5source tree. The files are installed in /usr/share/mk, and are by
6convention, named with the suffix ".mk". These files store several
7build options and should be handled with caution.
8
9Note, this file is not intended to replace reading through the .mk
10files for anything tricky.

--- 476 unchanged lines hidden (view full) ---

487
488The include file <bsd.test.mk> handles building one or more test programs
489intended to be used in the FreeBSD Test Suite under /usr/tests/.
490
491It has seven targets:
492
493 all:
494 build the test programs.
495 check:
496 runs the test programs from CHECKDIR with kyua test.
497
498 The beforecheck and aftercheck targets will be invoked, if
499 defined, to execute commands before and after the realcheck
500 target has been executed, respectively.
501
502 The devel/kyua package must be installed before invoking this
503 target.
504
505 See CHECKDIR for more details.
495 clean:
496 remove the test programs and any object files.
497 cleandir:
498 remove all of the files removed by the target clean, as
499 well as .depend and tags.
500 depend:
501 make the dependencies for the source files, and store
502 them in the file .depend.
503 install:
504 install the test programs and their data files; if the
505 Makefile does not itself define the target install, the
506 targets beforeinstall and afterinstall may also be used
507 to cause actions immediately before and after the
508 install target is executed.
509 lint:
510 run lint on the source files.
511 tags:
512 create a tags file for the source files.
506 clean:
507 remove the test programs and any object files.
508 cleandir:
509 remove all of the files removed by the target clean, as
510 well as .depend and tags.
511 depend:
512 make the dependencies for the source files, and store
513 them in the file .depend.
514 install:
515 install the test programs and their data files; if the
516 Makefile does not itself define the target install, the
517 targets beforeinstall and afterinstall may also be used
518 to cause actions immediately before and after the
519 install target is executed.
520 lint:
521 run lint on the source files.
522 tags:
523 create a tags file for the source files.
513 test:
514 runs the test programs from the object directory; if the
515 Makefile does not itself define the target test, the
516 targets beforetest and aftertest may also be used to
517 cause actions immediately before and after the test
518 target is executed.
519
520It sets/uses the following variables, among many others:
521
522TESTSBASE Installation prefix for tests. Defaults to /usr/tests
523
524TESTSDIR Path to the installed tests. Must be a subdirectory of
525 TESTSBASE and the subpath should match the relative
526 location of the tests within the src tree.
527
528 The value of TESTSDIR defaults to
529 ${TESTSBASE}/${RELDIR:H} , e.g. /usr/tests/bin/ls when
530 included from bin/ls/tests .
531
524
525It sets/uses the following variables, among many others:
526
527TESTSBASE Installation prefix for tests. Defaults to /usr/tests
528
529TESTSDIR Path to the installed tests. Must be a subdirectory of
530 TESTSBASE and the subpath should match the relative
531 location of the tests within the src tree.
532
533 The value of TESTSDIR defaults to
534 ${TESTSBASE}/${RELDIR:H} , e.g. /usr/tests/bin/ls when
535 included from bin/ls/tests .
536
537CHECKDIR The directory that 'make check' executes tests from.
538
539 The value of CHECKDIR defaults to .OBJDIR.
540
532KYUAFILE If 'auto' (the default), generate a Kyuafile out of the
533 test programs defined in the Makefile. If 'yes', then a
534 manually-crafted Kyuafile must be supplied with the
535 sources. If 'no', no Kyuafile is installed (useful for
536 subdirectories providing helper programs or data files
537 only).
538
539LOCALBASE The --prefix for the kyua package.

--- 49 unchanged lines hidden ---
541KYUAFILE If 'auto' (the default), generate a Kyuafile out of the
542 test programs defined in the Makefile. If 'yes', then a
543 manually-crafted Kyuafile must be supplied with the
544 sources. If 'no', no Kyuafile is installed (useful for
545 subdirectories providing helper programs or data files
546 only).
547
548LOCALBASE The --prefix for the kyua package.

--- 49 unchanged lines hidden ---