%!PS
%%Version: 3.3.2
%%DocumentFonts: (atend)
%%Pages: (atend)
%%EndComments
%
% Version 3.3.2 prologue for troff files.
%

/#copies 1 store
/aspectratio 1 def
/formsperpage 1 def
/landscape false def
/linewidth .3 def
/magnification 1 def
/margin 0 def
/orientation 0 def
/resolution 720 def
/rotation 1 def
/xoffset 0 def
/yoffset 0 def

/roundpage true def
/useclippath true def
/pagebbox [0 0 612 792] def

/R  /Times-Roman def
/I  /Times-Italic def
/B  /Times-Bold def
/BI /Times-BoldItalic def
/H  /Helvetica def
/HI /Helvetica-Oblique def
/HB /Helvetica-Bold def
/HX /Helvetica-BoldOblique def
/CW /Courier def
/CO /Courier def
/CI /Courier-Oblique def
/CB /Courier-Bold def
/CX /Courier-BoldOblique def
/PA /Palatino-Roman def
/PI /Palatino-Italic def
/PB /Palatino-Bold def
/PX /Palatino-BoldItalic def
/Hr /Helvetica-Narrow def
/Hi /Helvetica-Narrow-Oblique def
/Hb /Helvetica-Narrow-Bold def
/Hx /Helvetica-Narrow-BoldOblique def
/KR /Bookman-Light def
/KI /Bookman-LightItalic def
/KB /Bookman-Demi def
/KX /Bookman-DemiItalic def
/AR /AvantGarde-Book def
/AI /AvantGarde-BookOblique def
/AB /AvantGarde-Demi def
/AX /AvantGarde-DemiOblique def
/NR /NewCenturySchlbk-Roman def
/NI /NewCenturySchlbk-Italic def
/NB /NewCenturySchlbk-Bold def
/NX /NewCenturySchlbk-BoldItalic def
/ZD /ZapfDingbats def
/ZI /ZapfChancery-MediumItalic def
/S  /S def
/S1 /S1 def
/GR /Symbol def

/inch {72 mul} bind def
/min {2 copy gt {exch} if pop} bind def

/show {show} bind def		% so later references don't bind
/widthshow {widthshow} bind def
/stringwidth {stringwidth} bind def

/setup {
	counttomark 2 idiv {def} repeat pop

	landscape {/orientation 90 orientation add def} if
	/scaling 72 resolution div def
	linewidth setlinewidth
	1 setlinecap

	pagedimensions
	xcenter ycenter translate
	orientation rotation mul rotate
	width 2 div neg height 2 div translate
	xoffset inch yoffset inch neg translate
	margin 2 div dup neg translate
	magnification dup aspectratio mul scale
	scaling scaling scale

	addmetrics
	0 0 moveto
} def

/pagedimensions {
	useclippath userdict /gotpagebbox known not and {
		/pagebbox [clippath pathbbox newpath] def
		roundpage currentdict /roundpagebbox known and {roundpagebbox} if
	} if
	pagebbox aload pop
	4 -1 roll exch 4 1 roll 4 copy
	landscape {4 2 roll} if
	sub /width exch def
	sub /height exch def
	add 2 div /xcenter exch def
	add 2 div /ycenter exch def
	userdict /gotpagebbox true put
} def

/addmetrics {
	/Symbol /S null Sdefs cf
	/Times-Roman /S1 StandardEncoding dup length array copy S1defs cf
} def

/pagesetup {
	/page exch def
	currentdict /pagedict known currentdict page known and {
		page load pagedict exch get cvx exec
	} if
} def

/decodingdefs [
	{counttomark 2 idiv {y moveto show} repeat}
	{neg /y exch def counttomark 2 idiv {y moveto show} repeat}
	{neg moveto {2 index stringwidth pop sub exch div 0 32 4 -1 roll widthshow} repeat}
	{neg moveto {spacewidth sub 0.0 32 4 -1 roll widthshow} repeat}
	{counttomark 2 idiv {y moveto show} repeat}
	{neg setfunnytext}
] def

/setdecoding {/t decodingdefs 3 -1 roll get bind def} bind def

/w {neg moveto show} bind def
/m {neg dup /y exch def moveto} bind def
/done {/lastpage where {pop lastpage} if} def

/f {
	dup /font exch def findfont exch
	dup /ptsize exch def scaling div dup /size exch def scalefont setfont
	linewidth ptsize mul scaling 10 mul div setlinewidth
	/spacewidth ( ) stringwidth pop def
} bind def

/changefont {
	/fontheight exch def
	/fontslant exch def
	currentfont [
		1 0
		fontheight ptsize div fontslant sin mul fontslant cos div
		fontheight ptsize div
		0 0
	] makefont setfont
} bind def

/sf {f} bind def

/cf {
	dup length 2 idiv
	/entries exch def
	/chtab exch def
	/newencoding exch def
	/newfont exch def

	findfont dup length 1 add dict
	/newdict exch def
	{1 index /FID ne {newdict 3 1 roll put}{pop pop} ifelse} forall

	newencoding type /arraytype eq {newdict /Encoding newencoding put} if

	newdict /Metrics entries dict put
	newdict /Metrics get
	begin
		chtab aload pop
		1 1 entries {pop def} for
		newfont newdict definefont pop
	end
} bind def

%
% A few arrays used to adjust reference points and character widths in some
% of the printer resident fonts. If square roots are too high try changing
% the lines describing /radical and /radicalex to,
%
%	/radical	[0 -75 550 0]
%	/radicalex	[-50 -75 500 0]
%
% Move braceleftbt a bit - default PostScript character is off a bit.
%

/Sdefs [
	/bracketlefttp		[201 500]
	/bracketleftbt		[201 500]
	/bracketrighttp		[-81 380]
	/bracketrightbt		[-83 380]
	/braceleftbt		[203 490]
	/bracketrightex		[220 -125 500 0]
	/radical		[0 0 550 0]
	/radicalex		[-50 0 500 0]
	/parenleftex		[-20 -170 0 0]
	/integral		[100 -50 500 0]
	/infinity		[10 -75 730 0]
] def

/S1defs [
	/underscore		[0 80 500 0]
	/endash			[7 90 650 0]
] def
%
% Tries to round clipping path dimensions, as stored in array pagebbox, so they
% match one of the known sizes in the papersizes array. Lower left coordinates
% are always set to 0.
%

/roundpagebbox {
    7 dict begin
	/papersizes [8.5 inch 11 inch 14 inch 17 inch] def

	/mappapersize {
		/val exch def
		/slop .5 inch def
		/diff slop def
		/j 0 def
		0 1 papersizes length 1 sub {
			/i exch def
			papersizes i get val sub abs
			dup diff le {/diff exch def /j i def} {pop} ifelse
		} for
		diff slop lt {papersizes j get} {val} ifelse
	} def

	pagebbox 0 0 put
	pagebbox 1 0 put
	pagebbox dup 2 get mappapersize 2 exch put
	pagebbox dup 3 get mappapersize 3 exch put
    end
} bind def

%%EndProlog
%%BeginSetup
mark
/linewidth 0.5 def
/#copies 1 store
/landscape false def
/resolution 720 def
%
% Encoding vector and redefinition of findfont for the ISO Latin1 standard.
% The 18 characters missing from ROM based fonts on older printers are noted
% below.
%

/ISOLatin1Encoding [
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/space
	/exclam
	/quotedbl
	/numbersign
	/dollar
	/percent
	/ampersand
	/quoteright
	/parenleft
	/parenright
	/asterisk
	/plus
	/comma
	/minus
	/period
	/slash
	/zero
	/one
	/two
	/three
	/four
	/five
	/six
	/seven
	/eight
	/nine
	/colon
	/semicolon
	/less
	/equal
	/greater
	/question
	/at
	/A
	/B
	/C
	/D
	/E
	/F
	/G
	/H
	/I
	/J
	/K
	/L
	/M
	/N
	/O
	/P
	/Q
	/R
	/S
	/T
	/U
	/V
	/W
	/X
	/Y
	/Z
	/bracketleft
	/backslash
	/bracketright
	/asciicircum
	/underscore
	/quoteleft
	/a
	/b
	/c
	/d
	/e
	/f
	/g
	/h
	/i
	/j
	/k
	/l
	/m
	/n
	/o
	/p
	/q
	/r
	/s
	/t
	/u
	/v
	/w
	/x
	/y
	/z
	/braceleft
	/bar
	/braceright
	/asciitilde
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/.notdef
	/dotlessi
	/grave
	/acute
	/circumflex
	/tilde
	/macron
	/breve
	/dotaccent
	/dieresis
	/.notdef
	/ring
	/cedilla
	/.notdef
	/hungarumlaut
	/ogonek
	/caron
	/space
	/exclamdown
	/cent
	/sterling
	/currency
	/yen
	/brokenbar		% missing
	/section
	/dieresis
	/copyright
	/ordfeminine
	/guillemotleft
	/logicalnot
	/hyphen
	/registered
	/macron
	/degree			% missing
	/plusminus		% missing
	/twosuperior		% missing
	/threesuperior		% missing
	/acute
	/mu			% missing
	/paragraph
	/periodcentered
	/cedilla
	/onesuperior		% missing
	/ordmasculine
	/guillemotright
	/onequarter		% missing
	/onehalf		% missing
	/threequarters		% missing
	/questiondown
	/Agrave
	/Aacute
	/Acircumflex
	/Atilde
	/Adieresis
	/Aring
	/AE
	/Ccedilla
	/Egrave
	/Eacute
	/Ecircumflex
	/Edieresis
	/Igrave
	/Iacute
	/Icircumflex
	/Idieresis
	/Eth			% missing
	/Ntilde
	/Ograve
	/Oacute
	/Ocircumflex
	/Otilde
	/Odieresis
	/multiply		% missing
	/Oslash
	/Ugrave
	/Uacute
	/Ucircumflex
	/Udieresis
	/Yacute			% missing
	/Thorn			% missing
	/germandbls
	/agrave
	/aacute
	/acircumflex
	/atilde
	/adieresis
	/aring
	/ae
	/ccedilla
	/egrave
	/eacute
	/ecircumflex
	/edieresis
	/igrave
	/iacute
	/icircumflex
	/idieresis
	/eth			% missing
	/ntilde
	/ograve
	/oacute
	/ocircumflex
	/otilde
	/odieresis
	/divide			% missing
	/oslash
	/ugrave
	/uacute
	/ucircumflex
	/udieresis
	/yacute			% missing
	/thorn			% missing
	/ydieresis
] def

/NewFontDirectory FontDirectory maxlength dict def

%
% Apparently no guarantee findfont is defined in systemdict so the obvious
%
%	systemdict /findfont get exec
%
% can generate an error. So far the only exception is a VT600 (version 48.0).
%

userdict /@RealFindfont known not {
	userdict begin
		/@RealFindfont systemdict begin /findfont load end def
	end
} if

/findfont {
	dup NewFontDirectory exch known not {
		dup
		%dup systemdict /findfont get exec	% not always in systemdict
		dup userdict /@RealFindfont get exec
		dup /Encoding get StandardEncoding eq {
			dup length dict begin
				{1 index /FID ne {def}{pop pop} ifelse} forall
				/Encoding ISOLatin1Encoding def
				currentdict
			end
			/DummyFontName exch definefont
		} if
		NewFontDirectory 3 1 roll put
	} if
	NewFontDirectory exch get
} bind def

setup
2 setdecoding
%%EndSetup
%%Page: 1 1
/saveobj save def
mark
1 pagesetup
12 B f
(Plan 9 Mkfiles)2 742 1 2509 1220 t
10 I f
(R. Flandrena)1 533 1 2613 1480 t
10 B f
(Introduction)720 2140 w
10 R f
( called)1 276(Every Plan 9 source directory contains a file,)7 1880 2 720 2296 t
10 CW f
(mkfile)2914 2296 w
10 R f
(, specifying the rules for building the exe\255)7 1766 1 3274 2296 t
( is the product of the directory.)6 1288(cutable or library that)3 892 2 720 2416 t
10 I f
(Mk)2959 2416 w
10 R f
(\(1\) interprets the rules in the file, calculates the)8 1954 1 3086 2416 t
(dependencies and executes an)3 1217 1 720 2536 t
10 I f
(rc)1970 2536 w
10 R f
( are supplied)2 528( necessary components)2 936( If)1 124(\(1\) script to construct the product.)5 1399 4 2053 2536 t
( first executed to build the)5 1116(by subtending or neighboring directories, the mkfiles in those directories are)10 3204 2 720 2656 t
(components before the local construction proceeds.)5 2051 1 720 2776 t
( one of four types of product: a single executable, several exe\255)11 2548(Most application source directories produce)4 1772 2 720 2932 t
( for building each)3 710( generic mkfiles define the normal rules)6 1603( Four)1 241(cutables, a local library, or a system library.)7 1766 4 720 3052 t
( need only list the components and include the appropriate generic)10 2751( simplest mkfiles)2 702( The)1 214(type of product.)2 653 4 720 3172 t
( augment, modify or override)4 1185( complex mkfiles may supply additional rules to)7 1958( More)1 270(mkfile to do the work.)4 907 4 720 3292 t
(the generic rules.)2 684 1 720 3412 t
10 B f
(Using a Mkfile)2 628 1 720 3652 t
10 R f
(To build a product, change to the directory containing its source and invoke)12 3074 1 720 3808 t
10 I f
(mk)3823 3808 w
10 R f
(with the appropriate target)3 1071 1 3969 3808 t
( mkfiles provide the following standard targets:)6 1898( All)1 178(as an argument.)2 629 3 720 3928 t
10 CW f
(all)720 4108 w
10 R f
( If)1 125(Build a local version of the product or products for the current architecture.)12 3115 2 1590 4108 t
( program, the result is stored in file)7 1411(the product is a single)4 885 2 1590 4228 t
10 CW f
($O.out.)3912 4228 w
10 R f
(If the direc\255)2 472 1 4358 4228 t
(tory produces multiple executables, they are stored in the files named)10 3240 1 1590 4348 t
10 CW f
($O.)1590 4468 w
10 I f
(progname)1770 4468 w
10 CW f
(,)2175 4468 w
10 R f
(where)2278 4468 w
10 I f
(progname)2564 4468 w
10 R f
( product)1 347( A)1 139( name of each executable.)4 1100(is the)1 232 4 3012 4468 t
( built for a different architecture by prefacing the)8 2107(may be)1 309 2 1590 4588 t
10 CW f
(mk)4050 4588 w
10 R f
(command with)1 616 1 4214 4588 t
10 CW f
(objtype=)1590 4708 w
10 I f
(architecture)2070 4708 w
10 R f
(, where)1 305 1 2558 4708 t
10 I f
(architecture)2900 4708 w
10 R f
( target architec\255)2 647(is the name of the)4 758 2 3425 4708 t
( producing system libraries always operate directly on the)8 2539(ture. Directories)1 701 2 1590 4828 t
(installed version of the library; in this case the target)9 2199 1 1590 4948 t
10 CW f
(all)3825 4948 w
10 R f
( to the)2 270(is equivalent)1 519 2 4041 4948 t
(target)1590 5068 w
10 CW f
(install)1842 5068 w
10 R f
(.)2262 5068 w
10 CW f
(install)720 5188 w
10 R f
(Build and install the product or products for the current architecture.)10 2731 1 1590 5188 t
10 CW f
(installall)720 5308 w
10 R f
(Build and install the product or products for all architectures.)9 2441 1 1590 5308 t
10 CW f
(clean)720 5428 w
10 R f
( process.)1 358(Rid the directory and its subdirectories of the by\255products of the build)11 2882 2 1590 5428 t
( easily reproduced \(e.g., object files,)5 1479(Intermediate files that are)3 1043 2 1590 5548 t
10 CW f
(yacc)4143 5548 w
10 R f
(intermedi\255)4414 5548 w
( such)1 219( intermediates,)1 598( Complicated)1 571(ates, target executables\) are always removed.)5 1852 4 1590 5668 t
(as local libraries, are usually preserved.)5 1576 1 1590 5788 t
10 CW f
(nuke)720 5908 w
10 R f
( target)1 256( This)1 232(Remove all intermediates from the directory and any subdirectories.)8 2752 3 1590 5908 t
(guarantees that a subsequent build is performed from scratch.)8 2453 1 1590 6028 t
(If no target is specified on the)6 1216 1 720 6244 t
10 CW f
(mk)1965 6244 w
10 R f
(command line, the)2 749 1 2114 6244 t
10 CW f
(all)2892 6244 w
10 R f
( a directory produc\255)3 804( In)1 138( default.)1 332(target is built by)3 665 4 3101 6244 t
(ing multiple executables, there is no default target.)7 2022 1 720 6364 t
( be supplied by each generic mkfile or by the)9 1835(In addition to the five standard targets, additional targets may)9 2485 2 720 6520 t
(directory's mkfile.)1 743 1 720 6640 t
cleartomark
showpage
saveobj restore
%%EndPage: 1 1
%%Page: 2 2
/saveobj save def
mark
2 pagesetup
10 R f
(\255 2 \255)2 166 1 2797 480 t
10 B f
(Creating a Mkfile)2 760 1 720 840 t
10 R f
( Failing)1 340( to build a new mkfile is to copy and modify an existing mkfile of the same type.)17 3333(The easiest way)2 647 3 720 996 t
( mkfile)1 291(that, it is usually possible to create a new mkfile with minimal effort, since the appropriate generic)16 4029 2 720 1116 t
( and most common cases, the new mkfile need only)9 2073( the simplest)2 506( In)1 133(predefines the rules that do all the work.)7 1608 4 720 1236 t
(set a couple of variables and include the appropriate architecture\255specific and generic mkfiles.)12 3753 1 720 1356 t
( containing commonly used rules for building a product:)8 2310(There are four generic mkfiles)4 1236 2 720 1632 t
10 CW f
(mkone)4298 1632 w
10 R f
(,)4598 1632 w
10 CW f
(mkmany)4655 1632 w
10 R f
(,)5015 1632 w
10 CW f
(mklib)720 1752 w
10 R f
(, and)1 208 1 1020 1752 t
10 CW f
(mksyslib)1267 1752 w
10 R f
( object)1 282( rules perform such actions as compiling C source files, loading)10 2684(. These)1 327 3 1747 1752 t
( and installing executables in the)5 1382(files, archiving libraries,)2 1004 2 720 1872 t
10 CW f
(bin)3146 1872 w
10 R f
(directory of the appropriate architecture.)4 1674 1 3366 1872 t
(The generic mkfiles are stored in directory)6 1755 1 720 1992 t
10 CW f
(/sys/src/cmd.)2509 1992 w
10 R f
(Mkfile)3323 1992 w
10 CW f
(mkone)3629 1992 w
10 R f
(builds a single executable,)3 1078 1 3962 1992 t
10 CW f
(mkmany)720 2112 w
10 R f
(builds several executables from the source in a single directory, and)10 2828 1 1117 2112 t
10 CW f
(mklib)3982 2112 w
10 R f
(and)4319 2112 w
10 CW f
(mksyslib)4535 2112 w
10 R f
(,)5015 2112 w
( are driven by the values)5 998( rules in the generic mkfiles)5 1137( The)1 210(maintain local and system libraries, respectively.)5 1975 4 720 2232 t
( are supplied by the gen\255)5 1009(of variables, some of which must be set by the product mkfile and some of which)15 3311 2 720 2352 t
( in the latter class include:)5 1046( Variables)1 432(eric mkfile.)1 460 3 720 2472 t
10 I f
(Variable Default Meaning)2 1365 1 1840 2652 t
10 CW f
(CFLAGS \255w)1 750 1 1830 2832 t
10 R f
(C compiler flags)2 666 1 2850 2832 t
10 CW f
(LDFLAGS)1770 2952 w
10 R f
(Loader flags)1 501 1 2850 2952 t
10 CW f
(YFLAGS \255d)1 750 1 1830 3072 t
10 R f
(Yacc flags)1 423 1 2850 3072 t
10 CW f
(AFLAGS)1830 3192 w
10 R f
(Assembler flags)1 646 1 2850 3192 t
( may be empty)3 609( Any)1 228( set by the product mkfile and used by the generic mkfile.)11 2368(The following variables are)3 1115 4 720 3408 t
(depending on the specific product being made.)6 1866 1 720 3528 t
10 CW f
(TARG)1545 3708 w
10 R f
(Name\(s\) of the executable\(s\) to be built)6 1585 1 2415 3708 t
10 CW f
(LIB)1545 3828 w
10 R f
(Library name\(s\))1 645 1 2415 3828 t
10 CW f
(OFILES)1545 3948 w
10 R f
(Object files used in build)4 1005 1 2415 3948 t
10 CW f
(HFILES)1545 4068 w
10 R f
(Common header files)2 860 1 2415 4068 t
10 CW f
(YFILES Yacc)1 1110 1 1545 4188 t
10 R f
(input files)1 403 1 2680 4188 t
10 CW f
(BIN)1545 4308 w
10 R f
(Directory where executables are installed)4 1650 1 2415 4308 t
10 B f
(Mkfile Organization)1 875 1 720 4608 t
10 R f
(All mkfiles share the following common structure:)6 2026 1 720 4764 t
9 CW f
( definitions)1 648(</$objtype/mkfile #architecture\255dependent)1 2538 2 1008 4934 t
9 I f
(variable definitions)1 703 1 1008 5154 t
9 CW f
(#TARG, OFILES, HFILES, etc.)3 1458 1 2304 5154 t
(</sys/src/cmd/)1008 5374 w
9 I f
(generic)1764 5374 w
9 CW f
(#mkone, mkmany, mklib, or mksyslib)4 1836 1 2304 5374 t
9 I f
(extra rules)1 388 1 1008 5594 t
9 CW f
(#overrides, augmented rules, additional targets)4 2538 1 2304 5594 t
10 R f
( as they are)3 463(The variables driving the expansion of the generic mkfile may be specified in any order as long)16 3857 2 720 5774 t
( value of a variable may be changed by assigning a)10 2074( The)1 210(defined before the inclusion of the generic mkfile.)7 2036 3 720 5894 t
( are sometimes counter\255intuitive.)3 1354(new value following the inclusion of the generic mkfile, but the effects)11 2966 2 720 6014 t
( do not apply to the target and prerequisite portions of any previously defined)13 3236(Such variable assignments)2 1084 2 720 6134 t
( to all recipes and to all parts of any rules following the assignment in the)15 3173(rules; the new values apply)4 1147 2 720 6254 t
( assigning a new value to a variable following the inclusion of the generic mkfile results in)16 3751(mkfile. Thus,)1 569 2 720 6374 t
(the new value applying to the recipes in the generic file, but not to the dependency specifications.)16 3893 1 720 6494 t
( speci\255)1 271( new rules must be)4 777( The)1 212(The rules supplied by the generic mkfile may be overridden or augmented.)11 3060 4 720 6650 t
( the target and prerequisite portion of the rule exactly match)10 2405( If)1 117( mkfile.)1 312(fied after the inclusion of the generic)6 1486 4 720 6770 t
( a recipe, the new)4 724(the target and prerequisite portion of a previously defined rule and the new rule contains)14 3596 2 720 6890 t
( or)1 108( the target of a new rule exactly matches the target of a previous rule and one)16 3091( If)1 117(rule replaces the old one.)4 1004 4 720 7010 t
( rule contains no recipe, the new prerequisites are added to)10 2351(more new prerequisites are specified and the new)7 1969 2 720 7130 t
(the prerequisites of the old rule.)5 1270 1 720 7250 t
cleartomark
showpage
saveobj restore
%%EndPage: 2 2
%%Page: 3 3
/saveobj save def
mark
3 pagesetup
10 R f
(\255 3 \255)2 166 1 2797 480 t
(Following sections discuss each generic mkfile in detail.)7 2259 1 720 840 t
10 B f
(Mkone)720 1080 w
10 R f
(The)720 1236 w
10 CW f
(mkone)901 1236 w
10 R f
( more files in a direc\255)5 866(generic mkfile contains rules for building a single executable from one or)11 2947 2 1227 1236 t
( variable)1 349(tory. The)1 394 2 720 1356 t
10 CW f
(TARG)1491 1356 w
10 R f
(specifies the name of the executable and variables)7 2018 1 1759 1356 t
10 CW f
(OFILES)3805 1356 w
10 R f
(and)4193 1356 w
10 CW f
(YFILES)4365 1356 w
10 R f
(specify)4752 1356 w
(the object files and)3 757 1 720 1476 t
10 CW f
(yacc)1502 1476 w
10 R f
( to build it.)3 443(source files used)2 665 2 1767 1476 t
10 CW f
(HFILES)2926 1476 w
10 R f
(contains the names of the local header files)7 1728 1 3312 1476 t
(included in all source files.)4 1107 1 720 1596 t
10 CW f
(BIN)1883 1596 w
10 R f
(is the name of the directory where the executable is installed.)10 2502 1 2094 1596 t
10 CW f
(LIB)4652 1596 w
10 R f
(con\255)4863 1596 w
( libraries referenced by)3 924( variable is rarely needed as)5 1110( This)1 228(tains the names of local libraries used by the linker.)9 2058 4 720 1716 t
(a)720 1836 w
10 CW f
(#pragma)792 1836 w
10 R f
( an associated header file, including all system libraries, are automatically searched)11 3345(directive in)1 455 2 1240 1836 t
(by the loader.)2 546 1 720 1956 t
(If no command line target is specified, the)7 1693 1 720 2112 t
10 CW f
(all)2440 2112 w
10 R f
(target is built; it produces an executable in)7 1709 1 2647 2112 t
10 CW f
($O.out.)4383 2112 w
10 R f
(Vari\255)4830 2112 w
(able)720 2232 w
10 CW f
(HFILES)914 2232 w
10 R f
( Occasionally,)1 598( are included in all or most or the C source files.)11 1947(identifies the header files that)4 1193 3 1302 2232 t
( be added to the pre\255)5 837( header can)2 459( A)1 125(a program has other header files that are only used in some source files.)13 2899 4 720 2352 t
( files by adding a rule of the following form following the inclusion of generic)14 3261(requisites for those object)3 1059 2 720 2472 t
(mkfile)720 2592 w
10 CW f
(mkone)1006 2592 w
10 R f
(:)1306 2592 w
9 CW f
(file.$O: header.h)1 1296 1 1008 2762 t
10 R f
( using the normal set of rules is trivial: a list of)11 1990(The mkfile for a directory producing a single executable)8 2330 2 720 2978 t
(some files followed by the inclusion of)6 1560 1 720 3098 t
10 I f
(mkone.)2305 3098 w
10 R f
(For example,)1 527 1 2640 3098 t
10 CW f
(/sys/src/cmd/scat/mkfile)3192 3098 w
10 R f
(contains:)4657 3098 w
9 CW f
(</$objtype/mkfile)1008 3268 w
(TARG=scat)1008 3488 w
(OFILES=scat.$O\\)1008 3598 w
(desc.$O\\)1440 3708 w
(patch.$O\\)1440 3818 w
(prose.$O\\)1440 3928 w
(util.$O\\)1440 4038 w
(HFILES=sky.h)1008 4258 w
(BIN=/$objtype/bin)1008 4478 w
(</sys/src/cmd/mkone)1008 4588 w
10 R f
(The more complex mkfile in)4 1155 1 720 4768 t
10 CW f
(/sys/src/cmd/samterm)1903 4768 w
10 R f
( between the)2 512(specifies an additional dependence)3 1397 2 3131 4768 t
(specialized header)1 738 1 720 4888 t
10 CW f
(../sam/mesg.h)1488 4888 w
10 R f
(and the object file)3 733 1 2298 4888 t
10 CW f
(mesg.$O)3061 4888 w
10 R f
( as providing an extra target to)6 1244(as well)1 285 2 3511 4888 t
(generate a)1 406 1 720 5008 t
10 I f
(db)1151 5008 w
10 R f
(\(1\) script to dump a named structure:)6 1481 1 1251 5008 t
9 CW f
(</$objtype/mkfile)1008 5178 w
(TARG=samterm)1008 5398 w
(OFILES=main.$O icons.$O menu.$O mesg.$O\\)3 2160 1 1008 5508 t
(rasp.$O scroll.$O flayer.$O io.$O plan9.$O)4 2268 1 1440 5618 t
(HFILES=samterm.h\\)1008 5838 w
(flayer.h\\)1440 5948 w
(BIN=/$objtype/bin/aux)1008 6168 w
(</sys/src/cmd/mkone)1008 6278 w
(mesg.$O: ../sam/mesg.h)1 1566 1 1008 6498 t
(%.db:)1008 6718 w
($CC \255s$stem main.c | dbfmt > $stem.db)6 1998 1 1440 6828 t
cleartomark
showpage
saveobj restore
%%EndPage: 3 3
%%Page: 4 4
/saveobj save def
mark
4 pagesetup
10 R f
(\255 4 \255)2 166 1 2797 480 t
10 B f
(Mkmany)720 840 w
10 R f
(The)720 996 w
10 CW f
(mkmany)912 996 w
10 R f
( differs from the)3 690( It)1 124( from the files in a directory.)6 1223(generic mkfile builds several executables)4 1694 4 1309 996 t
(operation of)1 501 1 720 1116 t
10 CW f
(mkone)1262 1116 w
10 R f
(in three respects:)2 708 1 1603 1116 t
10 CW f
(TARG)2352 1116 w
10 R f
( there is no default)4 803(specifies the names of all executables,)5 1604 2 2633 1116 t
(command\255line target, and additional rules allow a single executable to be built or installed.)13 3626 1 720 1236 t
(The)720 1392 w
10 CW f
(TARG)910 1392 w
10 R f
( the)1 158( rules assume)2 558( The)1 215(variable specifies the names of all executables produced by the mkfile.)10 2924 4 1185 1392 t
(name of each executable is also the name of the file containing its)12 2676 1 720 1512 t
10 CW f
(main)3424 1512 w
10 R f
(function.)3692 1512 w
10 CW f
(OFILES)4103 1512 w
10 R f
(specifies files)1 549 1 4491 1512 t
( the mkfile:)2 461( Consider)1 411(containing common subroutines loaded with all executables.)6 2417 3 720 1632 t
9 CW f
(</$objtype/mkfile)1008 1802 w
(TARG=alpha beta)1 810 1 1008 2022 t
(OFILES=common.$O)1008 2132 w
(BIN=/$objtype/bin)1008 2242 w
(</sys/src/cmd/mkmany)1008 2352 w
10 R f
(It assumes the main functions for executables)6 1879 1 720 2532 t
10 CW f
(alpha)2634 2532 w
10 R f
(and)2969 2532 w
10 CW f
(beta)3148 2532 w
10 R f
(are in files)2 441 1 3423 2532 t
10 CW f
(alpha.$O)3899 2532 w
10 R f
(and)4415 2532 w
10 CW f
(beta.$O)4595 2532 w
10 R f
(,)5015 2532 w
( programs use the subroutines in file)6 1472(respectively and that both)3 1041 2 720 2652 t
10 I f
(common.)3261 2652 w
10 CW f
($O)3624 2652 w
10 R f
(. The)1 233 1 3744 2652 t
10 CW f
(all)4005 2652 w
10 R f
(target builds all exe\255)3 827 1 4213 2652 t
(cutables, leaving each in a file with a name of the form)11 2239 1 720 2772 t
10 CW f
($O.)2988 2772 w
10 I f
(progname)3168 2772 w
10 R f
(where)3602 2772 w
10 I f
(progname)3875 2772 w
10 R f
(is the name of the)4 730 1 4310 2772 t
( this example the)3 680(executable. In)1 584 2 720 2892 t
10 CW f
(all)2009 2892 w
10 R f
(target produces executables)2 1102 1 2214 2892 t
10 CW f
($O.alpha)3341 2892 w
10 R f
(and)3846 2892 w
10 CW f
($O.beta)4015 2892 w
10 R f
(.)4435 2892 w
(The)720 3048 w
10 CW f
(mkmany)900 3048 w
10 R f
(rules provide additional targets for building a single executable:)8 2552 1 1285 3048 t
10 CW f
($O.progname)720 3228 w
10 R f
(Builds executable)1 738 1 2010 3228 t
10 CW f
($O.)2833 3228 w
10 I f
(progname)3013 3228 w
10 R f
( the target)2 451( When)1 314(in the current directory.)3 1017 3 3468 3228 t
( architecture the)2 672(architecture is not the current)4 1233 2 2010 3348 t
10 CW f
(mk)3955 3348 w
10 R f
(command must be prefixed)3 1135 1 4115 3348 t
(with the customary)2 820 1 2010 3468 t
10 CW f
(objtype=)2882 3468 w
10 I f
(architecture)3362 3468 w
10 R f
( select the proper)3 768(assignment to)1 580 2 3902 3468 t
(compilers and loaders.)2 901 1 2010 3588 t
10 CW f
(progname.install)720 3708 w
10 R f
(Installs executable)1 740 1 2010 3708 t
10 I f
(progname)2775 3708 w
10 R f
(for the target architecture.)3 1035 1 3205 3708 t
10 CW f
(progname.installall)720 3828 w
10 R f
(Installs executable)1 740 1 2010 3828 t
10 I f
(progname)2775 3828 w
10 R f
(for all architectures.)2 800 1 3205 3828 t
10 B f
(Mklib)720 4128 w
10 R f
(The)720 4284 w
10 CW f
(mklib)908 4284 w
10 R f
( the)1 156( this form of mkfile constructs no executable,)7 1870( Since)1 280(generic mkfile builds a local library.)5 1493 4 1241 4284 t
10 CW f
(TARG)720 4404 w
10 R f
(and)1002 4404 w
10 CW f
(BIN)1188 4404 w
10 R f
( the)1 163( Instead,)1 379(variables are not needed.)3 1042 3 1410 4404 t
10 CW f
(LIB)3035 4404 w
10 R f
(variable specifies the library to be built or)7 1784 1 3256 4404 t
(updated. Variable)1 737 1 720 4524 t
10 CW f
(OFILES)1485 4524 w
10 R f
( use of)2 274( The)1 209( names of the object files to be archived in the library.)11 2201(contains the)1 483 4 1873 4524 t
(variables)720 4644 w
10 CW f
(YFILES)1120 4644 w
10 R f
(and)1520 4644 w
10 CW f
(HFILES)1703 4644 w
10 R f
( possible, only the out\255of\255date members of the)7 1940( When)1 302(does not change.)2 696 3 2102 4644 t
(library are updated.)2 778 1 720 4764 t
(The variable)1 503 1 720 4920 t
10 CW f
(LIBDIR)1250 4920 w
10 R f
(, contains the name of the directory where the library is installed; by default it selects)15 3430 1 1610 4920 t
( point where)2 533( can be overridden by assigning the new directory name after the)11 2783( It)1 129(the current directory.)2 875 4 720 5040 t
10 CW f
(mklib)720 5160 w
10 R f
(is included.)1 461 1 1045 5160 t
(The)720 5316 w
10 CW f
(clean)914 5316 w
10 R f
(target removes object files and)4 1281 1 1253 5316 t
10 I f
(yacc)2573 5316 w
10 R f
( The)1 220(intermediate files but does not touch the library.)7 2025 2 2795 5316 t
10 CW f
(nuke)720 5436 w
10 R f
(target, removes the library as well as the files removed by the)11 2456 1 985 5436 t
10 CW f
(clean)3466 5436 w
10 R f
( command)1 419(target. The)1 457 2 3791 5436 t
10 CW f
(mk \255s clean all)3 900 1 970 5556 t
10 R f
( command)1 419( The)1 205(causes the existing library to be updated, or created if it doesn't already exist.)13 3091 3 720 5676 t
10 CW f
(mk \255s nuke all)3 840 1 970 5796 t
10 R f
(forces the library to be rebuilt from scratch.)7 1740 1 720 5916 t
cleartomark
showpage
saveobj restore
%%EndPage: 4 4
%%Page: 5 5
/saveobj save def
mark
5 pagesetup
10 R f
(\255 5 \255)2 166 1 2797 480 t
(The mkfile from)2 668 1 720 840 t
10 CW f
(/sys/src/cmd/upas/libString)1417 840 w
10 R f
( the)1 152(contains the following specifications to build)5 1822 2 3066 840 t
(local library)1 485 1 720 960 t
10 CW f
(libString.a$O)1230 960 w
10 R f
(for the object architecture referenced by)5 1596 1 2035 960 t
10 CW f
($O)3656 960 w
10 R f
(:)3776 960 w
9 CW f
(</$objtype/mkfile)1008 1130 w
(LIB=libString.a$O)1008 1350 w
(OFILES= s_alloc.$O\\)1 1026 1 1008 1460 t
(s_append.$O\\)1440 1570 w
(s_array.$O\\)1440 1680 w
(s_copy.$O\\)1440 1790 w
(s_getline.$O\\)1440 1900 w
(s_grow.$O\\)1440 2010 w
(s_nappend.$O\\)1440 2120 w
(s_parse.$O\\)1440 2230 w
(s_read.$O\\)1440 2340 w
(s_read_line.$O\\)1440 2450 w
(s_tolower.$O\\)1440 2560 w
(</sys/src/cmd/mklib)1008 2780 w
(nuke:V:)1008 3000 w
(mk clean)1 432 1 1440 3110 t
(rm \255f libcommon.a[$OS])2 1188 1 1440 3220 t
10 R f
( of the rule for target)5 838(The override)1 513 2 720 3400 t
10 CW f
(nuke)2098 3400 w
10 R f
(removes the libraries for all architectures as opposed to the default)10 2675 1 2365 3400 t
(recipe for this target which removes the library for the current architecture.)11 2991 1 720 3520 t
10 B f
(Mksyslib)720 3760 w
10 R f
(The)720 3916 w
10 CW f
(mksyslib)905 3916 w
10 R f
(generic mkfile is similar to the)5 1249 1 1415 3916 t
10 CW f
(mklib)2694 3916 w
10 R f
( operates directly on a system library)6 1511(mkfile but it)2 505 2 3024 3916 t
( The)1 210(instead of a local library.)4 1015 2 720 4036 t
10 CW f
(install)1975 4036 w
10 R f
(and)2425 4036 w
10 CW f
(all)2599 4036 w
10 R f
( no local copy of the)5 838(targets are the same; since there is)6 1393 2 2809 4036 t
( rule for the)3 486( The)1 211( updates are performed on the installed library.)7 1910(library, all)1 421 4 720 4156 t
10 CW f
(nuke)3779 4156 w
10 R f
(target is identical to that)4 990 1 4050 4156 t
(of the)1 230 1 720 4276 t
10 CW f
(clean)975 4276 w
10 R f
(target; unlike the)2 677 1 1300 4276 t
10 CW f
(nuke)2002 4276 w
10 R f
(target for local libraries, the library is never removed.)8 2139 1 2267 4276 t
( up\255to\255date; all members of a library are)7 1628(No attempt is made to determine if individual library members are)10 2692 2 720 4432 t
( the target)2 411( targets support manipulation of a single object file;)8 2121( Special)1 351(always updated.)1 650 4 720 4552 t
10 CW f
(objfile)4284 4552 w
10 R f
(updates)4735 4552 w
(file)720 4672 w
10 CW f
(objfile.$O)907 4672 w
10 R f
( the target)2 459(in the library of the current architecture and)7 1945 2 1561 4672 t
10 CW f
(objfile.all)4020 4672 w
10 R f
(updates)4735 4672 w
10 CW f
(objfile.$O)720 4792 w
10 R f
(in the libraries of all architectures.)5 1369 1 1345 4792 t
10 B f
(Overrides)720 5032 w
10 R f
( those rules may be)4 783(The rules provided by a generic mkfile or the variables used to control the evaluation of)15 3537 2 720 5188 t
( must be specified in the product mkfile after the point where)11 2487( Overrides)1 448(overridden in most circumstances.)3 1385 3 720 5308 t
(the generic mkfile is included; in general, variable and rule overrides occupy the end of a product mkfile.)17 4199 1 720 5428 t
( variable overrides)2 766( Most)1 268(The value of a variable is overridden by assigning a new value to the variable.)14 3286 3 720 5584 t
( example, the default value)4 1098( For)1 194( in recipes.)2 445(modify the values of flags or the names of commands executed)10 2583 4 720 5704 t
(of)720 5824 w
10 CW f
(CFLAGS)834 5824 w
10 R f
( the ANSI/Posix Computing Environment is selected by)7 2291(is often overridden or augmented and)5 1524 2 1225 5824 t
(setting the)1 414 1 720 5944 t
10 CW f
(CC)1159 5944 w
10 R f
(and)1304 5944 w
10 CW f
(LD)1473 5944 w
10 R f
(variables to)1 463 1 1618 5944 t
10 CW f
(pcc.)2106 5944 w
10 R f
( constraints can be added to a rule simply)8 1701( Additional)1 484( trickier than modifying variables.)4 1386(Modifying rules is)2 749 4 720 6100 t
( example,)1 388( For)1 189(by specifying the target and the new prerequisite.)7 1968 3 720 6220 t
9 CW f
(%.$O: header.h)1 864 1 1008 6390 t
10 R f
(adds file)1 354 1 720 6570 t
10 CW f
(header.h)1112 6570 w
10 R f
( is no mechanism for adding)5 1205( There)1 296(the the set of prerequisites for all object files.)8 1909 3 1630 6570 t
( a recipe is unsatisfactory, the rule and its recipe must be com\255)12 2504(additional commands to an existing recipe; if)6 1816 2 720 6690 t
( prerequisite)1 498( rule is overridden only when the replacement rule matches the target and)12 2944( A)1 123(pletely overridden.)1 755 4 720 6810 t
( recipe associated with the new rule then replaces the recipe of the)12 2666( The)1 207(portions of the original rule exactly.)5 1447 3 720 6930 t
( example,)1 405( For)1 206(original rule.)1 533 3 720 7050 t
10 CW f
(/sys/src/cmd/movie/mkfile)1906 7050 w
10 R f
(overrides the)1 536 1 3448 7050 t
10 CW f
(installall)4027 7050 w
10 R f
(target by)1 370 1 4670 7050 t
(performing the usual action before copying the)6 1874 1 720 7170 t
10 CW f
(rc)2619 7170 w
10 R f
(script entitled)1 547 1 2764 7170 t
10 CW f
(movie)3336 7170 w
10 R f
(to directory)1 463 1 3661 7170 t
10 CW f
(/rc/bin:)4149 7170 w
cleartomark
showpage
saveobj restore
%%EndPage: 5 5
%%Page: 6 6
/saveobj save def
mark
6 pagesetup
10 R f
(\255 6 \255)2 166 1 2797 480 t
9 CW f
(< /$objtype/mkfile)1 972 1 1008 830 t
(TARG=anim\\)1008 1050 w
(fdevelop\\)1440 1160 w
(BIN=/sys/lib/movie/$objtype)1008 1380 w
(</sys/src/cmd/mkmany)1008 1490 w
(CC=pcc)1008 1600 w
(LD=pcc)1008 1710 w
(CFLAGS=\255c)1008 1820 w
(installall:V:)1008 2040 w
(for\(objtype in $CPUS\))2 1134 1 1440 2150 t
(mk $MKFLAGS install)2 1026 1 1872 2260 t
(cp movie /rc/bin/movie)2 1188 1 1440 2370 t
10 B f
(Special Tricks)1 609 1 720 2780 t
10 R f
(Two special cases require an extra dollop of deviousness.)8 2292 1 720 2936 t
( to build an executable is generated by a program that in turn, is built from a source)17 3345(In the first, a file needed)5 975 2 720 3092 t
( built for the target architecture, but)6 1446( this case, the executable must be)6 1358( In)1 138(file that is not part of the product.)7 1378 4 720 3212 t
(the intermediate executable must be built for the architecture)8 2516 1 720 3332 t
10 CW f
(mk)3272 3332 w
10 R f
( intermediate exe\255)2 744( The)1 216(is executing on.)2 652 3 3428 3332 t
( invoking)1 384(cutable is built by recursively)4 1198 2 720 3452 t
10 CW f
(mk)2330 3452 w
10 R f
(with the appropriate target and the executing architecture as the)9 2562 1 2478 3452 t
( that)1 189( When)1 302(target architecture.)1 761 3 720 3572 t
10 CW f
(mk)2011 3572 w
10 R f
(completes, the intermediate is executed to generate the source file to)10 2870 1 2170 3572 t
( example of this build procedure can be found in the)10 2235( An)1 187( target architecture.)2 802(complete the build for the)4 1096 4 720 3692 t
10 CW f
(/sys/src/cmd/awk/mkfile.)720 3812 w
10 R f
( to build an executable as well as source)8 1610(Another awkward situation occurs when a directory contains source)8 2710 2 720 3968 t
( case the)2 349( this)1 174( In)1 137(for auxiliary executables that are not to be installed.)8 2103 4 720 4088 t
10 CW f
(mkmany)3511 4088 w
10 R f
(generic rules are inappropri\255)3 1141 1 3899 4088 t
( to used the)3 467( good way to handle this situation is)7 1456( A)1 124(ate, because all executables would be built and installed.)8 2273 4 720 4208 t
10 CW f
(mkone)720 4328 w
10 R f
( to build the primary executable and provide extra targets to build the auxiliary executa\255)14 3538(generic file)1 454 2 1048 4328 t
( approach is also useful when the auxiliary files are not executables;)11 3808(bles. This)1 512 2 720 4448 t
10 CW f
(/sys/src/cmd/spell/mkfile)720 4568 w
10 R f
(augments to default rules that build and install the)8 2015 1 2247 4568 t
10 CW f
(spell)4288 4568 w
10 R f
(executable)4614 4568 w
(with elaborate rules to generate and maintain the auxiliary spelling lists.)10 2877 1 720 4688 t
cleartomark
showpage
saveobj restore
%%EndPage: 6 6
%%Trailer
done
%%Pages: 6
%%DocumentFonts: Times-Bold Times-Italic Times-Roman Courier