diff options
author | Rüdiger Timm <rt@openoffice.org> | 2004-09-08 15:08:09 +0000 |
---|---|---|
committer | Rüdiger Timm <rt@openoffice.org> | 2004-09-08 15:08:09 +0000 |
commit | 7f267ed9fed66a8fb57840c1682f487d98b5d074 (patch) | |
tree | c3e4279cc146724faa21e6973ee563050708003a /dmake | |
parent | e2c8c66d6b23ce6cf971d66311c65473e33bc5e1 (diff) |
INTEGRATION: CWS ooo20040704 (1.3.22); FILE MERGED
2004/07/11 15:15:17 vq 1.3.22.1: #i31255#, #i17992# Update the documentation of dmake to the new features.
Diffstat (limited to 'dmake')
-rw-r--r-- | dmake/man/dmake.tf | 34 |
1 files changed, 28 insertions, 6 deletions
diff --git a/dmake/man/dmake.tf b/dmake/man/dmake.tf index 85bf9ec4ed34..859a1de5cfdd 100644 --- a/dmake/man/dmake.tf +++ b/dmake/man/dmake.tf @@ -19,14 +19,14 @@ .IP "\\$1" \\n[dmake-indent]u .it 1 PD .. -.TH DMAKE 1 "UW" "Version 4.01 PL0" +.TH DMAKE 1 "UW" "Version 4.10" .SH NAME \fBdmake\fR \- maintain program groups, or interdependent files .SH SYNOPSIS .B dmake [\-P#] [\-{f|C|K} file] [\-{w|W} target ...] [macro[[!][*][+][:]]=\fIvalue\fP ...] -[\-v{cdfimtw}] [\-ABcdeEghiknpqrsStTuVxX] [target ...] +[\-v{cdfimrtw}] [\-ABcdeEghiknpqrsStTuVxX] [target ...] .SH DESCRIPTION .PP .B dmake @@ -176,9 +176,9 @@ Tells \fBdmake\fP to not perform transitive closure on the inference graph. .IP "\fB\-u\fR" Force an unconditional update. (ie. do everything that would be done if everything that a target depended on was out of date) -.IP "\fB\-v[dfimtw]\fR" +.IP "\fB\-v[cdfimrtw]\fR" Verbose flag, when making targets print to stdout what we are going to make -and what we think its time stamp is. The optional flags \fB[dfimt]\fP can be +and what we think its time stamp is. The optional flags \fB[cdfimrtw]\fP can be used to restrict the information that is displayed. In the absence of any optional flags all are assumed to be given (ie. \fB\-v\fP is equivalent to \fB\-vdfimt\fP). The meanings of the optional flags are: @@ -193,6 +193,10 @@ Notify of file I/O operations only. Notify of inference algorithm operation only. .IP "\fBm\fP" Notify of target update operations only. +.IP "\fBr\fP" +Force output of recipe lines and warnings. This switch is usefull when +debugging makefiles that disable the output using the @ sign for recipe +lines or the .SILENT target/attribute. It also overrides the -s flag. .IP "\fBt\fP" Keep any temporary files created; normally they are automatically deleted. .IP "\fBw\fP" @@ -409,6 +413,11 @@ are text or names representing text supplied by the user. .Ip "expression" "\(-> \fBLINE\fR" \(-> \fBSTRING == LINE\fR \(-> \fBSTRING != LINE\fR +\(-> \fBSTRING <= LINE\fR +\(-> \fBSTRING >= LINE\fR +\(-> \fB(\fR expression \fB)\fR +\(-> expression \fB||\fR expression +\(-> expression \fB&&\fR expression .Ip "Rule-Definition \(-> " "target-definition" [ recipe ] .PP @@ -2872,13 +2881,26 @@ nested (ie. the text may contain another conditional). may appear anywhere in the makefile, but a single conditional expression may not span multiple makefiles. .PP -\fIexpression\fR can be one of the following three forms: +\fIexpression\fR can be one of the following forms: .sp +String evaluation +.br \t<text> | <text> == <text> | <text> != <text> .sp +Numeric evaluation +.br +\t<text> <= <text> | <text> >= <text> +.sp +Boolean evaluation +.br +\t( <text> ) | <text> || <text> | <text> && <text> +.sp where \fItext\fR is either text or a macro expression. In any case, before the comparison is made, the expression is expanded. The text -portions are then selected and compared. White space at the start and +portions are then selected and compared. In the case of the numeric +comparisons the expanded expressions are converted to an integer number. +Expressions can be nested with () and the use of || or &&. +White space at the start and end of the text portion is discarded before the comparison. This means that a macro that evaluates to nothing but white space is considered a NULL value for the purpose of the comparison. |