| tutorial.ms (1591) | tutorial.ms (18730) |
|---|---|
| 1.\" Copyright (c) 1988, 1989 by Adam de Boor 2.\" Copyright (c) 1989 by Berkeley Softworks 3.\" Copyright (c) 1988, 1989, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" This code is derived from software contributed to Berkeley by 7.\" Adam de Boor. 8.\" --- 29 unchanged lines hidden (view full) --- 38.\" 39.EH 'PSD:12-%''PMake \*- A Tutorial' 40.OH 'PMake \*- A Tutorial''PSD:12-%' 41.\" xH is a macro to provide numbered headers that are automatically stuffed 42.\" into a table-of-contents, properly indented, etc. If the first argument 43.\" is numeric, it is taken as the depth for numbering (as for .NH), else 44.\" the default (1) is assumed. 45.\" | 1.\" Copyright (c) 1988, 1989 by Adam de Boor 2.\" Copyright (c) 1989 by Berkeley Softworks 3.\" Copyright (c) 1988, 1989, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" This code is derived from software contributed to Berkeley by 7.\" Adam de Boor. 8.\" --- 29 unchanged lines hidden (view full) --- 38.\" 39.EH 'PSD:12-%''PMake \*- A Tutorial' 40.OH 'PMake \*- A Tutorial''PSD:12-%' 41.\" xH is a macro to provide numbered headers that are automatically stuffed 42.\" into a table-of-contents, properly indented, etc. If the first argument 43.\" is numeric, it is taken as the depth for numbering (as for .NH), else 44.\" the default (1) is assumed. 45.\" |
| 46.\" $Id: tutorial.ms,v 1.4 89/01/08 20:20:22 adam Exp Locker: adam $ | 46.\" $Id: tutorial.ms,v 1.1.1.1 1994/05/27 12:32:16 rgrimes Exp $ |
| 47.\" 48.\" @P The initial paragraph distance. 49.\" @Q The piece of section number to increment (or 0 if none given) 50.\" @R Section header. 51.\" @S Indent for toc entry 52.\" @T Argument to NH (can't use @Q b/c giving 0 to NH resets the counter) 53.de xH 54.NH \\$1 --- 1212 unchanged lines hidden (view full) --- 1267is a Good Thing because two people doing the same thing in the same place 1268can be disastrous for the final product (too many cooks and all that). 1269Whether this locking is the default is up to your system 1270administrator. If locking is on, 1271.B \-l 1272will turn it off, and vice versa. Note that this locking will not 1273prevent \fIyou\fP from invoking PMake twice in the same place \*- if 1274you own the lock file, PMake will warn you about it but continue to execute. | 47.\" 48.\" @P The initial paragraph distance. 49.\" @Q The piece of section number to increment (or 0 if none given) 50.\" @R Section header. 51.\" @S Indent for toc entry 52.\" @T Argument to NH (can't use @Q b/c giving 0 to NH resets the counter) 53.de xH 54.NH \\$1 --- 1212 unchanged lines hidden (view full) --- 1267is a Good Thing because two people doing the same thing in the same place 1268can be disastrous for the final product (too many cooks and all that). 1269Whether this locking is the default is up to your system 1270administrator. If locking is on, 1271.B \-l 1272will turn it off, and vice versa. Note that this locking will not 1273prevent \fIyou\fP from invoking PMake twice in the same place \*- if 1274you own the lock file, PMake will warn you about it but continue to execute. |
| 1275.IP "\fB\-m\fP \fIdirectory\fP" 1276.Ix 0 def flags -m 1277Tells PMake another place to search for included makefiles via the <...> 1278style. Several 1279.B \-m 1280options can be given to form a search path. If this construct is used the 1281default system makefile search path is completely overridden. 1282To be explained in chapter 3, section 3.2. 1283.Rm 2 3.2 |
|
| 1275.IP \fB\-n\fP 1276.Ix 0 def flags -n 1277This flag tells PMake not to execute the commands needed to update the 1278out-of-date targets in the makefile. Rather, PMake will simply print 1279the commands it would have executed and exit. This is particularly 1280useful for checking the correctness of a makefile. If PMake doesn't do 1281what you expect it to, it's a good chance the makefile is wrong. 1282.IP "\fB\-p\fP \fInumber\fP" --- 624 unchanged lines hidden (view full) --- 1907#include <file> 1908.DE 1909or this 1910.DS 1911#include "file" 1912.DE 1913The difference between the two is where PMake searches for the file: 1914the first way, PMake will look for | 1284.IP \fB\-n\fP 1285.Ix 0 def flags -n 1286This flag tells PMake not to execute the commands needed to update the 1287out-of-date targets in the makefile. Rather, PMake will simply print 1288the commands it would have executed and exit. This is particularly 1289useful for checking the correctness of a makefile. If PMake doesn't do 1290what you expect it to, it's a good chance the makefile is wrong. 1291.IP "\fB\-p\fP \fInumber\fP" --- 624 unchanged lines hidden (view full) --- 1916#include <file> 1917.DE 1918or this 1919.DS 1920#include "file" 1921.DE 1922The difference between the two is where PMake searches for the file: 1923the first way, PMake will look for |
| 1915the file only in the system makefile directory (to find out what that 1916directory is, give PMake the | 1924the file only in the system makefile directory (or directories) 1925(to find out what that directory is, give PMake the |
| 1917.B \-h 1918flag). 1919.Ix 0 ref flags -h | 1926.B \-h 1927flag). 1928.Ix 0 ref flags -h |
| 1929The system makefile directory search path can be overridden via the 1930.B \-m 1931option. 1932.Ix 0 ref flags -m |
|
| 1920For files in double-quotes, the search is more complex: 1921.RS 1922.IP 1) 1923The directory of the makefile that's including the file. 1924.IP 2) 1925The current directory (the one in which you invoked PMake). 1926.IP 3) 1927The directories given by you using --- 1805 unchanged lines hidden --- | 1933For files in double-quotes, the search is more complex: 1934.RS 1935.IP 1) 1936The directory of the makefile that's including the file. 1937.IP 2) 1938The current directory (the one in which you invoked PMake). 1939.IP 3) 1940The directories given by you using --- 1805 unchanged lines hidden --- |