cvs commit: ports/java/jdk14 Makefile

[Harti Brandt]

On Wed, 18 Aug 2004, Ruslan Ermilov wrote:

RE>On Wed, Aug 18, 2004 at 10:25:32AM +0200, Harti Brandt wrote:
RE>> On Wed, 18 Aug 2004, Ruslan Ermilov wrote:
RE>[...]
RE>> RE>2. Makefile can modify this global as necessary, either by
RE>> RE>modifying the variable directly (including adding to it,
RE>> RE>overriding it, or even undefining it with .undef), or thru
RE>> RE>the special .MAKEFLAGS macro.
RE>>                           ^^^^^ target (see commented out line in Makefile 
RE>> below)
RE>> 
RE>Also, "submakes" here and there should actually read "all programs
RE>that make executes".
RE>
RE>[...]
RE>
RE>> This is an excellent explanation. Perhaps we can put part of it into 
RE>> make(1)?
RE>> 
RE>You mean documenting the difference between .MAKEFLAGS macro
RE>and .MAKEFLAGS target?
RE>
RE>%%%
RE>Index: make.1
RE>===================================================================
RE>RCS file: /home/ncvs/src/usr.bin/make/make.1,v
RE>retrieving revision 1.78
RE>diff -u -r1.78 make.1
RE>--- make.1	9 Aug 2004 16:13:54 -0000	1.78
RE>+++ make.1	18 Aug 2004 09:02:15 -0000
RE>@@ -581,6 +581,15 @@
RE> for all programs which
RE> .Nm
RE> executes.
RE>+By modifying the contents of the
RE>+.Va .MAKEFLAGS
RE>+variable, makefile can alter the contents of the
RE>+.Va MAKEFLAGS
RE>+environment variable made available for all programs which
RE>+.Nm
RE>+executes; compare with the
RE>+.Ic .MAKEFLAGS
RE>+special target below.
RE> .It Va MFLAGS
RE> is provided for backward compatibility and
RE> contains all the options from the
RE>@@ -1146,6 +1155,20 @@
RE> .Fl f
RE> option will have
RE> no effect.
RE>+Flags (except for
RE>+.Fl f )
RE>+and variable assignments specified as the source
RE>+for this target are also appended to the
RE>+.Va .MAKEFLAGS
RE>+internal variable.
RE>+Please note the difference between this target and the
RE>+.Va .MAKEFLAGS
RE>+internal variable: specifying an option or variable
RE>+assignment as the source for this target will affect
RE>+.Em both
RE>+the current makefile and all processes that
RE>+.Nm
RE>+executes.
RE> .It Ic .MFLAGS
RE> Same as above, for backward compatibility.
RE> .\" XXX: NOT YET!!!!
RE>%%%

Sounds fine.

harti