are a collection of programs like cdrecord, cdda2wav, mkisofs, star and much more. In memoriam of the author Jörg Schilling, who passed away in October 2021.
| make.1s (schily-2021-08-14.tar.bz2) | : | make.1s (schily-2021-09-18.tar.bz2) |
|---|
| '\" te | | '\" te |
|
| . \" @(#)make.1s 1.63 21/08/13 Copyr 2012-2021 J. Schilling | | . \" @(#)make.1s 1.75 21/09/09 Copyr 2012-2021 J. Schilling |
| .\" Copyright 1989 AT&T | | .\" Copyright 1989 AT&T |
| .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved | | .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved |
| .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved | | .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved |
| .\" Copyright (c) 2012-2021, J. Schilling | | .\" Copyright (c) 2012-2021, J. Schilling |
| .\" Copyright (c) 2013, Andreas Roehler | | .\" Copyright (c) 2013, Andreas Roehler |
| .\" | | .\" |
| .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for | | .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for |
| .\" permission to reproduce portions of its copyrighted documentation. | | .\" permission to reproduce portions of its copyrighted documentation. |
| .\" Original documentation from The Open Group can be obtained online | | .\" Original documentation from The Open Group can be obtained online |
| .\" at http://www.opengroup.org/bookstore/. | | .\" at http://www.opengroup.org/bookstore/. |
| | |
| skipping to change at line 64 | | skipping to change at line 64 |
|---|
| .if t .ds u \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'u | | .if t .ds u \v'-0.55m'\h'0.00n'\z.\h'0.40n'\z.\v'0.55m'\h'-0.40n'u |
| .if t .ds A \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'A | | .if t .ds A \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'A |
| .if t .ds O \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'O | | .if t .ds O \v'-0.77m'\h'0.25n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.70n'O |
| .if t .ds U \v'-0.77m'\h'0.30n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.75n'U | | .if t .ds U \v'-0.77m'\h'0.30n'\z.\h'0.45n'\z.\v'0.77m'\h'-0.75n'U |
| .if t .ds s \\(*b | | .if t .ds s \\(*b |
| .if t .ds S SS | | .if t .ds S SS |
| .if n .ds a ae | | .if n .ds a ae |
| .if n .ds o oe | | .if n .ds o oe |
| .if n .ds u ue | | .if n .ds u ue |
| .if n .ds s sz | | .if n .ds s sz |
|
| .TH make 1S "2021/08/13" "SunOS 5.11" "SunOS Specific Commands" | | .TH make 1S "2021/09/09" "SunOS 5.11" "SunOS Specific Commands" |
| .SH NAME | | .SH NAME |
| make \- maintain, update, and regenerate related programs and files | | make \- maintain, update, and regenerate related programs and files |
| .SH SYNOPSIS | | .SH SYNOPSIS |
| .LP | | .LP |
| .nf | | .nf |
| \fB/usr/bin/make\fR [\fB-C\fR \fIdirectory\fR] [\fB-a\fR] [\fB-d\fR] [\fB-dd\fR]
[\fB-D\fR] [\fB-DD\fR] [\fB-e\fR] [\fB-i\fR] | | \fB/usr/bin/make\fR [\fB-C\fR \fIdirectory\fR] [\fB-a\fR] [\fB-d\fR] [\fB-dd\fR]
[\fB-D\fR] [\fB-DD\fR] [\fB-e\fR] [\fB-i\fR] |
| [\fB-k\fR] [\fB-n\fR] [\fB-p\fR] [\fB-P\fR] [\fB-q\fR] [\fB-r\fR] [\fB-s\fR
] [\fB-S\fR] [\fB-t\fR] [\fB-V\fR] | | [\fB-k\fR] [\fB-n\fR] [\fB-p\fR] [\fB-P\fR] [\fB-q\fR] [\fB-r\fR] [\fB-s\fR
] [\fB-S\fR] [\fB-t\fR] [\fB-V\fR] |
| [\fB-f\fR \fImakefile\fR].\|.\|. [\fB-K\fR \fIstatefile\fR].\|.\|. [\fItarg
et\fR].\|.\|. | | [\fB-f\fR \fImakefile\fR].\|.\|. [\fB-K\fR \fIstatefile\fR].\|.\|. [\fItarg
et\fR].\|.\|. |
| [\fImacro\fR = \fIvalue\fR.\|.\|.] | | [\fImacro\fR = \fIvalue\fR.\|.\|.] |
| .fi | | .fi |
| | |
| skipping to change at line 717 | | skipping to change at line 717 |
|---|
| .SS "Reading Makefiles and the Environment" | | .SS "Reading Makefiles and the Environment" |
| .sp | | .sp |
| .LP | | .LP |
| When | | When |
| .B make | | .B make |
| first starts, it reads the | | first starts, it reads the |
| .B MAKEFLAGS | | .B MAKEFLAGS |
| environment | | environment |
| variable to obtain any of the following options specified present in its | | variable to obtain any of the following options specified present in its |
| value: | | value: |
|
| | .BR -a , |
| .BR -d , | | .BR -d , |
| .BR -D , | | .BR -D , |
| .BR -e , | | .BR -e , |
| .BR -i , | | .BR -i , |
| .BR -k , | | .BR -k , |
| .BR -n , | | .BR -n , |
| .BR -N , | | .BR -N , |
| .BR -p , | | .BR -p , |
| .BR -q , | | .BR -q , |
| .BR -r , | | .BR -r , |
| | |
| skipping to change at line 1105 | | skipping to change at line 1106 |
|---|
| .B make | | .B make |
| did not support the | | did not support the |
| .B unexport | | .B unexport |
| directive. | | directive. |
| With an empty | | With an empty |
| .B SUN_MAKE_COMPAT_MODE | | .B SUN_MAKE_COMPAT_MODE |
| environment, | | environment, |
| .B make | | .B make |
| does not support this feature. | | does not support this feature. |
| | |
|
| | .SS "Automake Features |
| | .PP |
| | .B Make |
| | implements |
| | .B automake |
| | features that help to write highly portable makefile systems. The |
| | .B automake |
| | features are implemented with a set of special purpose macros and by special |
| | rules that help to extend the functionality and automated adaptivity of |
| | .BR make . |
| | .TP |
| | .B "Automake special purpose macros |
| | .RS +4n |
| | The special purpose macros that have names that match |
| | .B "MAKE_* |
| | (see section |
| | .BR "Special-Purpose Macros" ) |
| | are part of the |
| | .B automake |
| | features of make. |
| | The related special macros are set up by |
| | .B make |
| | to contain values that have been retrieved from the results of the |
| | .BR uname (2), |
| | .BR sysinfo (2) |
| | or |
| | .BR sysctl (2) |
| | system calls. |
| | The values for these macros may however be overwritten from a makefile |
| | or from a command line macro definition. |
| | .RE |
| | .TP |
| | .B "Automake special targets |
| | .RS +4n |
| | The special target |
| | .B \&.INCLUDE_FAILED |
| | allows to define a rule that is evaluated in case that an include |
| | file does not exist and could not be made from other rules. |
| | As the associated command for this target is typically a shell script, |
| | the shell script can be written to create fall back rules in a platform |
| | independent way. |
| | .RE |
| | |
| .SS "Targets and Dependencies" | | .SS "Targets and Dependencies" |
| .sp | | .sp |
| .ne 2 | | .ne 2 |
| .mk | | .mk |
| .na | | .na |
| .B : | | .B : |
| .ad | | .ad |
| .sp .6 | | .sp .6 |
| .RS 4n | | .RS 4n |
| Target list terminator. Words following the colon are added to the | | Target list terminator. Words following the colon are added to the |
| | |
| skipping to change at line 1674 | | skipping to change at line 1718 |
|---|
| .rt | | .rt |
| If it has an entry in the makefile, the rule for this target is used to | | If it has an entry in the makefile, the rule for this target is used to |
| process a target when there is no other entry for it, no rule for building | | process a target when there is no other entry for it, no rule for building |
| it, and no | | it, and no |
| .B SCCS | | .B SCCS |
| history file from which to retrieve a current version. | | history file from which to retrieve a current version. |
| .B make | | .B make |
| ignores any dependencies for this target. | | ignores any dependencies for this target. |
| .RE | | .RE |
| | |
|
| | .\".sp |
| | .\".ne 2 |
| | .\".mk |
| | .\".na |
| | .\"\fB\&.DERIVED_SRC:\fR XXX NSE only |
| | .\".ad |
| | .\".RS 23n |
| | .\".rt |
| | .\"bla |
| | .\".RE |
| | .\" |
| .sp | | .sp |
| .ne 2 | | .ne 2 |
| .mk | | .mk |
| .na | | .na |
| \fB\&.DONE:\fR | | \fB\&.DONE:\fR |
| .ad | | .ad |
| .RS 23n | | .RS 23n |
| .rt | | .rt |
| If defined in the makefile, | | If defined in the makefile, |
| .B make | | .B make |
| | |
| skipping to change at line 1744 | | skipping to change at line 1799 |
|---|
| ignores non-zero error codes returned from commands. When used in | | ignores non-zero error codes returned from commands. When used in |
| .B POSIX | | .B POSIX |
| mode, \fB\&.IGNORE\fR could be followed by target names only, for which the | | mode, \fB\&.IGNORE\fR could be followed by target names only, for which the |
| errors is ignored. | | errors is ignored. |
| .RE | | .RE |
| | |
| .sp | | .sp |
| .ne 2 | | .ne 2 |
| .mk | | .mk |
| .na | | .na |
|
| | .B \&.INCLUDE_FAILED: |
| | .ad |
| | .RS 23n |
| | .rt |
| | This special target implements |
| | .B automake |
| | features for object oriented layered makefiles. |
| | If this target is present and defines commands, |
| | .B make |
| | executes the commands for this target |
| | in case that a makefile could not be included and there |
| | was no other explicit or implicit rule that did create the the missing |
| | make include file. |
| | .sp |
| | The |
| | .B \&.INCLUDE_FAILED |
| | target may not have a dependency list. |
| | When the |
| | .B commands |
| | for the target |
| | .B \&.INCLUDE_FAILED |
| | are called, the dependency list of the special target is set up to |
| | the include filename that caused the failure. |
| | It is therefore recommended to define the |
| | .B commands |
| | for the |
| | .B \&.INCLUDE_FAILED |
| | target to include |
| | .B $^ |
| | as parameter. |
| | The commands for the target |
| | .B \&.INCLUDE_FAILED |
| | are called only for the |
| | .B include |
| | and not for the |
| | .B \-include |
| | directive. If the commands for the |
| | .B \&.INCLUDE_FAILED |
| | target cannot create a file that is going to be included, |
| | .B make |
| | fails. |
| | .sp |
| | With an empty |
| | .B SUN_MAKE_COMPAT_MODE |
| | environment, or when in |
| | .B SysV |
| | mode, |
| | .B make |
| | ignores the |
| | .B \&.INCLUDE_FAILED |
| | target in order to achieve compatibility to previous versions of the |
| | .B SunPro make |
| | program. |
| | .RE |
| | |
| | .sp |
| | .ne 2 |
| | .mk |
| | .na |
| \fB\&.INIT:\fR | | \fB\&.INIT:\fR |
| .ad | | .ad |
| .RS 23n | | .RS 23n |
| .rt | | .rt |
| If defined in the makefile, this target and its dependencies are built | | If defined in the makefile, this target and its dependencies are built |
| before any other targets are processed. | | before any other targets are processed. |
| .RE | | .RE |
| | |
| .sp | | .sp |
| .ne 2 | | .ne 2 |
| | |
| skipping to change at line 1856 | | skipping to change at line 1970 |
|---|
| .mk | | .mk |
| .na | | .na |
| \fB\&.NO_PARALLEL:\fR | | \fB\&.NO_PARALLEL:\fR |
| .ad | | .ad |
| .RS 23n | | .RS 23n |
| .rt | | .rt |
| When running in | | When running in |
| .B serial | | .B serial |
| mode, this target has no effect. It is used when in | | mode, this target has no effect. It is used when in |
| .B parallel | | .B parallel |
|
| mode. See | | mode. |
| | Add targets to the dependency list of this target to control |
| | which targets are to be processed serially. |
| | See |
| .BR dmake (1) | | .BR dmake (1) |
| for more information. | | for more information. |
| .RE | | .RE |
| | |
| .sp | | .sp |
| .ne 2 | | .ne 2 |
| .mk | | .mk |
| .na | | .na |
| \fB\&.NOTPARALLEL:\fR | | \fB\&.NOTPARALLEL:\fR |
| .ad | | .ad |
| .RS 23n | | .RS 23n |
| .rt | | .rt |
| When running in | | When running in |
| .B serial | | .B serial |
|
| mode, this target has no effect. It is used when in | | mode, this target has no effect. |
| | When in |
| .B parallel | | .B parallel |
|
| mode. See | | mode and this special target is seen in a makefile, all targets in this |
| | .B make |
| | instance are processed serially. |
| | Sub-makes may still run in parallel mode. |
| | See |
| .BR dmake (1) | | .BR dmake (1) |
| for more information. | | for more information. |
| .sp | | .sp |
| With an empty | | With an empty |
| .B SUN_MAKE_COMPAT_MODE | | .B SUN_MAKE_COMPAT_MODE |
| environment, or when in | | environment, or when in |
| .B SysV | | .B SysV |
| mode, | | mode, |
| .B make | | .B make |
| ignores the | | ignores the |
| .B .NOTPARALLEL | | .B .NOTPARALLEL |
| target in order to achieve compatibility to previous versions of the | | target in order to achieve compatibility to previous versions of the |
| .B SunPro make | | .B SunPro make |
| program. | | program. |
| .RE | | .RE |
| | |
|
| | .\".sp |
| | .\".ne 2 |
| | .\".mk |
| | .\".na |
| | .\"\fB\&.NOT_AUTO:\fR XXX Vermutlich .make.state |
| | .\".ad |
| | .\".RS 23n |
| | .\".rt |
| | .\"bla |
| | .\".RE |
| | .\" |
| .sp | | .sp |
| .ne 2 | | .ne 2 |
| .mk | | .mk |
| .na | | .na |
| \fB\&.PARALLEL:\fR | | \fB\&.PARALLEL:\fR |
| .ad | | .ad |
| .RS 23n | | .RS 23n |
| .rt | | .rt |
| When running in | | When running in |
| .B serial | | .B serial |
| mode, this target has no effect. It is used when in | | mode, this target has no effect. It is used when in |
| .B parallel | | .B parallel |
|
| mode. See | | mode. |
| | Add targets to the dependency list of this target to control |
| | which targets are to be processed in parallel. |
| | See |
| .BR dmake (1) | | .BR dmake (1) |
| for more information. | | for more information. |
| .RE | | .RE |
| | |
| .sp | | .sp |
| .ne 2 | | .ne 2 |
| .mk | | .mk |
| .na | | .na |
| \fB\&.PHONY:\fR | | \fB\&.PHONY:\fR |
| .ad | | .ad |
| | |
| skipping to change at line 2002 | | skipping to change at line 2138 |
|---|
| does not remove any of the files | | does not remove any of the files |
| listed as dependencies for this target when interrupted. | | listed as dependencies for this target when interrupted. |
| .B make | | .B make |
| normally | | normally |
| removes the current target when it receives an interrupt. When used in | | removes the current target when it receives an interrupt. When used in |
| .B POSIX | | .B POSIX |
| mode, if the target is not followed by a list of files, all the file are | | mode, if the target is not followed by a list of files, all the file are |
| assumed precious. | | assumed precious. |
| .RE | | .RE |
| | |
|
| | .\".sp |
| | .\".ne 2 |
| | .\".mk |
| | .\".na |
| | .\"\fB\&.RECURSIVE:\fR XXX Noch voellig unklar |
| | .\".ad |
| | .\".RS 23n |
| | .\".rt |
| | .\"bla |
| | .\".RE |
| | .\" |
| .sp | | .sp |
| .ne 2 | | .ne 2 |
| .mk | | .mk |
| .na | | .na |
| \fB\&.SCCS_GET:\fR | | \fB\&.SCCS_GET:\fR |
| .ad | | .ad |
| .RS 23n | | .RS 23n |
| .rt | | .rt |
| This target contains the rule for retrieving the current version of an | | This target contains the rule for retrieving the current version of an |
| .B SCCS | | .B SCCS |
| | |
| skipping to change at line 2244 | | skipping to change at line 2391 |
|---|
| characters), is carried forward from the value being replaced. For | | characters), is carried forward from the value being replaced. For |
| example: | | example: |
| .sp | | .sp |
| .in +2 | | .in +2 |
| .nf | | .nf |
| \fBPROGRAM=fabricate | | \fBPROGRAM=fabricate |
| DEBUG= $(PROGRAM:%=tmp/%\(mig)\fR | | DEBUG= $(PROGRAM:%=tmp/%\(mig)\fR |
| .fi | | .fi |
| .in -2 | | .in -2 |
| .sp | | .sp |
|
| | | |
| .sp | | .sp |
| .LP | | .LP |
| sets the value of | | sets the value of |
| .B DEBUG | | .B DEBUG |
| to | | to |
| .BR tmp/fabricate\(mig . | | .BR tmp/fabricate\(mig . |
| .sp | | .sp |
| .LP | | .LP |
|
| | The replacement is done on a word by word base and the white space between words |
| | is literally retained. If there is no match, the result is unmodified. |
| | .LP |
| Notice that pattern replacement macro references cannot be used in the | | Notice that pattern replacement macro references cannot be used in the |
| dependency list of a pattern matching rule; the | | dependency list of a pattern matching rule; the |
| .B % | | .B % |
| characters are not | | characters are not |
| evaluated independently. Also, any number of | | evaluated independently. Also, any number of |
| .B % | | .B % |
| metacharacters can | | metacharacters can |
| appear after the equal-sign, including no | | appear after the equal-sign, including no |
| .B % | | .B % |
| metacharacter after the equal-sign. | | metacharacter after the equal-sign. |
| | |
| skipping to change at line 2892 | | skipping to change at line 3041 |
|---|
| The name of the current target. This is the only dynamic macro whose value | | The name of the current target. This is the only dynamic macro whose value |
| is strictly determined when used in a dependency list. (In which case it | | is strictly determined when used in a dependency list. (In which case it |
| takes the form | | takes the form |
| .BR $$@ .) | | .BR $$@ .) |
| .RE | | .RE |
| | |
| .sp | | .sp |
| .ne 2 | | .ne 2 |
| .mk | | .mk |
| .na | | .na |
|
| | .B $^ |
| | .ad |
| | .RS 6n |
| | .rt |
| | The list of all dependencies of the current target. |
| | Since the list main contain |
| | .B .WAIT |
| | pseudo targets, it is recommended to use |
| | .B $(^:.WAIT=) |
| | if |
| | .B .WAIT |
| | is part of the dependency list. |
| | .RE |
| | |
| | .sp |
| | .ne 2 |
| | .mk |
| | .na |
| .B $? | | .B $? |
| .ad | | .ad |
| .RS 6n | | .RS 6n |
| .rt | | .rt |
| The list of dependencies that are newer than the target. Command-dependency | | The list of dependencies that are newer than the target. Command-dependency |
| checking is automatically suppressed for lines that contain this macro, just | | checking is automatically suppressed for lines that contain this macro, just |
| as if the command had been prefixed with a | | as if the command had been prefixed with a |
| .BR ? . | | .BR ? . |
| See the description of | | See the description of |
| .BR ? , | | .BR ? , |
| | |
| skipping to change at line 4481 | | skipping to change at line 4648 |
|---|
| .B make | | .B make |
| programs. | | programs. |
| .TP | | .TP |
| .B POSIX | | .B POSIX |
| Switch | | Switch |
| .B make | | .B make |
| into | | into |
| .B POSIX | | .B POSIX |
| mode. | | mode. |
| .TP | | .TP |
|
| | .B SUN |
| | Switch |
| | .B make |
| | into |
| | .BR Sun |
| | compatibility mode. |
| | This is a mode that is compatible to the SunPro Make source as published |
| | by Sun on December 19 2006. |
| | .TP |
| | .B SVR4 |
| | Switch |
| | .B make |
| | into |
| | .BR SysV " (" SVR4 ) |
| | mode. |
| | |
| | .TP |
| other | | other |
| Implement 100% compatibility to the version of the SunPro make program | | Implement 100% compatibility to the version of the SunPro make program |
|
| as published by Sun/Oracle. | | as published by Sun. |
| This results in disabling to forward command line | | This results in disabling to forward command line |
| macro definitions specified to the current | | macro definitions specified to the current |
| .B make | | .B make |
| program to recursively | | program to recursively |
| called | | called |
| .B make | | .B make |
| programs. | | programs. |
| It disables the special macro | | It disables the special macro |
| .B MAKE_NAME | | .B MAKE_NAME |
| and disables to evaluate the | | and disables to evaluate the |
| | | |
| End of changes. 17 change blocks. |
|---|
| 8 lines changed or deleted | | 192 lines changed or added |
|---|
"Fossies" - the Fresh Open Source Software Archive 