"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "sunpro/Make/bin/make/common/make.1s" between
schily-2021-08-14.tar.bz2 and schily-2021-09-18.tar.bz2

About: Schily Tools 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

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)