1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
|
$Xorg: README,v 1.4 2000/08/18 04:03:58 coskrey Exp $
$XFree86: xc/config/cf/README,v 1.20 2003/04/14 20:35:50 herrb Exp $
The easiest way to write an Imakefile is to find another one that does
something similar and copy/modify it!
To change any of these variables, edit the site.def file.
Imake.tmpl provides defaults for the following variables:
AlternateIncRoot compiler needs -I to find project includes
AlternateUsrLibDir linker needs -L to find project libraries
ArCmd command used to create libraries
ArCmdBase program name part of ArCmd
ArAddCmd flags to have ArCmdBase add files to a library
ArExtCmd flags to have ArCmdBase extract files
AsCmd command used to run assembler
BootstrapCFlags missing cpp symbols needed to get started
BourneShell command used to run Bourne Shell
CCsuf suffix that C++ source files have
CURDIR current directory relative to top of sources
CcCmd command to run C compiler
CompressCmd command to run compress program
ConstructMFLAGS System V option to set MFLAGS make variable
CpCmd command to copy one file to another
CplusplusCmd command to run C++ compiler
CplusplusFilt command to run C++ name demangler
CplusplusYaccCmd command to produce C++ source from yacc source
CppCmd command to run C preprocessor
CrossCompiling cross compiling? (not fully supported)
DebuggableCDebugFlags C compiler -I's and -D's to turn on debug info
DefaultCCOptions default special C compiler options
DefaultCDebugFlags debug/optimize flags for programs
DefaultUsrBin program directory used even if PATH not set
DependFlags extra makedepend flags
DoRanlibCmd boolean for system uses ranlib
EqnCmd command used for eqn
ExecableScripts boolean for systems that can exec() #!/bin/sh
ExpandManNames boolean to expand man pages names to long form
ExtraFilesToClean extra files to remove on make clean
ExtraLibraries system-specific libraries need to link
ExtraLoadFlags system-specific loader flags
FileManSuffix man suffix for file format pages
FilesToClean files to delete in make clean
FortranCmd command to run Fortran compiler
FortranDebugFlags flags for Fortran debug info
FortranFlags Fortran compiler flags
GzipCmd command to run gzip program
HasBSD44Sockets boolean for system has BSD4.4 sockets
HasBsdMake use the 4.4BSD variant of the make program?
HasBsearch boolean for libc has bsearch()
HasBrokenCCForLink boolean for brain damaged cc driver
HasCenterLineC boolean for system has CenterLine C compiler
HasCenterLineCplusplus boolean for system has CenterLine C++ compiler
HasClearmake use Clearcase's clearmake make program?
HasCodeCenter boolean for system has CodeCenter
HasCookieMaker boolean for system has xauth cookie generator
HasCplusplus system has a C++ compiler?
HasDECnet system has DECnet?
HasFortran boolean for system has Fortran compiler
HasGcc boolean for system has GNU gcc compiler
HasGcc2 boolean for system has GNU gcc 2.x compiler
HasGcc2ForCplusplus use gcc 2 for C++ programs?
HasGnuMake use the GNU make program?
HasGhostPCL boolean for system has GhostPCL
HasGhostScript boolean for system has GhostScript
HasKrbIV system has Kerberos version IV support?
HasKrb5 system has Kerberos version 5 support?
HasLargeTmp boolean for system has /tmp space
HasLatex system has LaTeX document preparation software
HasLibCrypt boolean for system has libcrypt
HasMotif boolean for system has Motif
HasMotif2 boolean for system has Motif2 or OpenMotif
HasNdbm boolean for system has ndbm routines
HasPoll use poll() syscall?
HasPurify boolean for system has Purify
HasPutenv boolean for libc has putenv()
HasSecureRPC boolean for Sun Secure RPC
HasSetProcTitle boolean for setproctitle()
HasSetUserContext boolean for setusercontext()
HasSentinel boolean for system has Sentinel available
HasSharedLibraries boolean for system has shared libraries
HasShm boolean for System V shared memory
HasSockets boolean for system has BSD sockets
HasStrcasecmp boolean for system implements str[n]casecmp
HasStreams use STREAMS I/O interface?
HasSymLinks boolean for system has symbolic links
HasTestCenter boolean for system has TestCenter
HasVarDirectory boolean for system has /var
HasVFork boolean for system has vfork()
HasVoidSignalReturn boolean for POSIX signal() procs
IncludeSharedObjectInNormalLib define for static libs to include
-fPIC objects on relevant archs
IncRoot parent of X11 include directory
InstBinFlags install flags for binaries
InstDatFlags install flags for data files
InstIncFlags install flags for header files
InstKmemFlags install flags for xload to get at /dev/kmem
InstLibFlags install flags for libraries
InstManFlags install flags for manual pages
InstPgmFlags install flags for normal programs
InstUidFlags install flags for xterm to chown /dev/ptys
InstallCmd command to install files
KrbIVIncludes where to include KerberosIV header files from
KrbIVLibraries where to load KerberosIV libraries from
Krb5Includes where to include Kerberos header files from
Krb5Libraries where to load Kerberos libraries from
LdCmd command to run loader
LdCombineFlags flags for incremental loading
LexCmd command to run lex
LexLib library for programs using lex output
LintCmd command to run lint
LintLibFlag flags to generate lint libraries
LintOpts lint options to control strictness
LnCmd command to link two files
LoaderLibPrefix loader flags before libraries
LocalRulesFile site-specific file with additional imake rules
LocalTmplFile file with additional imake variables
MacroFile name of machine-dependent config params file
MacroIncludeFile <MacroFile>
MakeCmd command to run make
Malloc0ReturnsNull boolean for malloc(0) == NULL
Malloc0ReturnsNullDefines -D's to build libX11/libXt
MathLibrary library for programs using C math functions
MkCookieCmd command to generate an xauth cookie
MsMacros macro flag for TroffCmd, normally "-ms"
MvCmd command to rename a file
NdbmDefines -D's to turn on use of ndbm routines
NeedConstPrototoypes whether const is supported
NeedFunctionPrototypes whether or not to force function prototypes
NeedNestedPrototypes whether nested prototypes are supported
NeedVarargsPrototypes whether varargs prototypes are supported
NeedWidePrototypes whether or not to widen function prototypes
NoOpCDebugFlags C compiler flags to not debug or optimize
NoRConst YES if const for structs of funcs is bad
OSMajorVersion major version number of operating system
OSMinorVersion minor version number of operating system
OSName operating system name
OSTeenyVersion maintenance version number of operating system
OptimizedCDebugFlags C compiler flags to turn on optimization
XtPopdownConformance XtPopdown conformans to the specification
PreProcessCmd command to run /lib/cpp on scripts
RanlibCmd command to clean up libraries
RanlibInstFlags flags to ranlib after copying
ResourceConfigurationManagement boolean for Xt's Resource Configuration
Management
RmCmd command to delete files
ShLibDir directory in which to install shared libraries
StandardCppDefines -D's for running cpp
StandardDefines -D's for running C compiler
StandardIncludes -I's for running C compiler
StripInstalledPrograms boolean for sites that want to install -s
SystemV boolean for systems that are at least SVR2
SystemV4 boolean for SVR4 systems
TOPDIR relative path to top of sources
TagsCmd command to run tags
TblCmd command to run tbl
TroffCmd command to run troff to get PostScript
UNCOMPRESSPATH command to run uncompress (obsolete)
UnalignedReferencesAllowed boolean for unaligned copies ok
UsrLibDir directory in which to install libraries
YaccCmd command to run yacc
X11.tmpl provides defaults for the following variables:
AdmDir directory containing system log files
AllocateLocalDefines -D's to turn on alloca() (should be in Imake.tmpl)
BDFTOSNFFILT command to run bdftosnf
BaseExtensionDefines universal extensions to use
BinDir directory in which to install programs
BuildAppgroup build AppGroup extension in server
BuildCup build Colormap Utilization extension in server
BuildDBE build DOUBLE-BUFFER extension
BuildDmx build Distributed Multihead X server and extension
BuildDPMS build Display Power Management Signaling extension
BuildIncRoot relative path to location of headers in build
BuildIncTop path from build includes directory to top
BuildEVI build EVI server extension
BuildMultibuffer build Multibuffer extension (obsolete)
BuildPlugin build xrx plug-in for web browsers
BuildRECORD Build RECORD extension
BuildServer build X server
BuildXCSecurity Build Security Extension
BuildXInputExt build X Input extension (requires ddx support,
which exists only in Xhp and XFree86)
BuildXKB build X Keyboard Extension?
BuildXKBlib build X Keyboard Extension into Xlib?
UseXKBInClients Use XKB functions in normal clients?
ConfigDir install directory for config files
ConnectionFlags -D's for supported transports
ContribDir location of user-contributed sources
DebugLibX11 build libX11_d.a
DebugLibXau build libXau_d.a
DebugLibXext build libXext_d.a
DebugLibXtst build libXtst_d.a
DebugOldX build liboldX_d.a
DefaultCursorTheme name of default cursor theme
DefaultFontPath default server font path
DefaultRGBDatabase default server rgb color database
DefaultSystemPath default system xdm PATH environment variable
DefaultSystemShell default /bin/sh
DefaultUserPath default user xdm PATH environment variable
DependCmd command to run makedepend
DependDir build directory containing makedepend program
DriverManDir directory in which to install driver man pages
DriverManSuffix man suffix for driver pages
ExtensionDefines -D's for universal extensions
ExtensionOSDefines -D's for additional extensions
ForceNormalLib force building of .a in addition to shared lib
HasXdmAuth boolean for using XDM-AUTHORIZATION-1;
needs Wraphelp.c, see Release Notes
InstallLibManPages boolean for installing library man pages
InstallSecurityConfig install server security policy file over old?
KrbIVDefines defines for use with KerberosIV
LibDir directory in which to install X11 support files
LibManSuffix man suffix for library pages
LibmanDir directory in which to install library man pages
LintlibDir directory in which to install lint libs
ManDir directory in which to install program man pages
ManDirectoryRoot parent of man directories relative to root
ManPath full path of parent directory
ManSourcePath common prefix of man page directories
ManSuffix man suffix for programs
MiscManSuffix man suffix for miscellaneous pages
MiscManDir directory in which to install misc man pages
NeedDefaultDepLibs boolean for enabling default DEPLIBS
NlsDir directory in which to install nls files
NormalLibX11 build libX11.a
NormalLibXau build libXau.a
NormalLibXext build libXext.a
NormalLibXtst build libXtst.a
NormalOldX build liboldX.a
OsNameDefines If uname(2) unavailable, set to -DOS_NAME=OSName
PrimaryScreenResolution resolution of default server screen
ProfileLibX11 build libX11_p.a
ProfileLibXau build libXau_p.a
ProfileLibXext build libXext_p.a
ProfileLibXtst build libXtst_p.a
ProfileOldX build liboldX_p.a
ProjectX version indicating this is the X Window System
RemoveTargetProgramByMoving boolean for rm -f that doesn't
SHELLPATH -D for /bin/sh
ServerConfigDir directory for server security config files
ServerDefines complete -D's for server
ServerExtraDefines special -D's for server
ServerOSDefines OS -D's for server
ServerAssertDefines -DNDEBUG for no assertions, /**/ for assertions
SharedLibX11 boolean for making sharable libX11.so
SharedLibXau boolean for making sharable libXau.so
SharedLibXext boolean for making sharable libXext.so
SharedLibXtst boolean for making sharable libXtst.so
SharedOldX boolean for making sharable liboldX.so
ShmDefines MIT-SHM define
TwmDir directory in which to install twm config files
UseCCMakeDepend boolean for using alternate makedepend script
UseRgbTxt use rgb.txt file as is instead of DBM-compiled
VarDirectory directory in /var for logs, etc., and config
VendorHasX11R6_3libXext don't need Security & AppGroup in xrx plug-in
XAppLoadDir directory in which to install app defaults
XFileSearchPathBase base file search path
XFileSearchPathDefault default path to search for app defaults files
XInputDefines XINPUT define
XMalloc0ReturnsNullDefines -D's specifically for libX11
XdmConfigurationSubdirectory name of default xdm configuration
XdmDir directory in which to install xdm files
XinitDir directory in which to install xinit files
XmanLocalSearchPath non-standard path for man pages
XtErrorPrefix leading text in XtError() msg; eg. 'X Toolkit '
XtWarningPrefix leading text in XtWarning()msg, same as above
XtMalloc0ReturnsNullDefines -D's specifically for libXt
ZBDFTOSNFFILT -D to run uncompress and bdftosnf (obsolete)
Library.tmpl provides defaults for the following variables:
AvoidNullMakeCommand for makes that spout about $(_NULLCMD_)
LibraryCCOptions special C compiler options for libraries
LibraryCDebugFlags library debug/optimize flags to override defs
LibraryCcCmd command to run C compiler in libraries
LibraryCplusplusOptions special C++ options for libraries
LibraryCplusplusDebugFlags library debug/optimize flags for C++
LibraryCplusplusCmd command to run C++ compiler in libraries
LibraryDefines -D's for libraries
SeparateSharedCompile shared and unshared libs use same binaries?
Server.tmpl provides defaults for the following variables:
ServerCCOptions server C compiler options to override defaults
ServerCcCmd command to run C compiler in server
ServerCDebugFlags server debug/opt compiler flags
ServerDefines server standard -D's
InstallServerSetUID does this system need X server suid to root?
Threads.tmpl provides defaults for the following variables:
LocalThreads whether to enable multi-threading support
LocalThreadsDefines -D flags needed in this directory
An <os>Lib.rules file provides defaults for the following variables:
HasSharedLibraries boolean for using shared libraries
SharedDataSeparation boolean indicating separate data/code
SharedCodeDef -D's for compiling shared library files
SharedLibraryDef -D's for defining which kind of shared lib
ShLibIncludeFile location of the <os>Lib.tmpl file
SharedLibraryLoadFlags loader flags when making the library
UseExportLists boolean for using an export list
PositionIndependentCFlags PIC compiler flags for C
PositionIndependentCplusplusFlags PIC compiler flags for C++
Note: PositionIndependentCplusplusFlags is only required if the
C and C++ compilers use different flags to build PIC code. The
default configuration will try to use PositionIndependentCFlags
for both C and C++ compiles.
An <os>Lib.tmpl file provides defaults for the following variables:
SharedOldXReqs required libs for liboldX.so
SharedOldXRev version number for liboldX.so
SharedX11Reqs required libs for libX11.so
SharedX11Rev version number for libX11.so
SharedXauReqs required libs for libXau.so
SharedXauRev version number for libXau.so
SharedXextReqs required libs for libXext.so
SharedXextRev version number for libXext.so
SharedXtstReqs required libs for libXtst.so
SharedXtstRev version number for libXtst.so
Vendor.cf files and/or site/host specific .def files may define the
following variables:
ProjectRoot The directory under which the installation
will operate. This value will be hard coded
into some programs. As a result do not use it
to specify the installation directory for a
cross compiled system, use DESTDIR to
accomplish that task.
The following variables are used by some part of the tree:
AckToolset programs/Xserver/hw/xfree86
BuildChooser build the xdm chooser program?
SharedLibXdmGreet use xdm shared dynamic greeter library?
LatexCmd command to run LaTeX on a document
DvipsCmd command to turn .dvi file into PostScript
MotifBC using Motif 1.1.1, 1.1.2, or 1.1.3?
GetValuesBC compat GetValues behavior for broken apps?
SvgaConfig default SVGA configuration
HasGetReturnAddress util/memleak
HasShadowPasswd system has getspnam() function
WebServer host:port of your Web server (see programs/xrx)
HtmlDir path used by Web server for HTML and RX docs
CgiBinDir path used by Web server for CGI programs
ProxyManager ICE network ID to contact a running proxymngr
Make Variables
The following make variables are used by imake rules and may be set in
an individual Imakefile.
DEFINES program-specific -D flags and other arguments
to pass to the C compiler, lint, and makedepend.
DEPEND_DEFINES program-specific flags in addition to
$(DEFINES) to pass to lint and makedepend.
This is usually used when there are special
compilation rules for individual files, and
the defines passed to those files affect
makedepend results. If they can be passed to
all files during the makedepend step without
affecting the results for other files,
DEPEND_DEFINES is used to do that. Example is
the Xlib Imakefile.
INCLUDES program-specific -I flags.
HEADERS .h files to install with "make includes" and
"make install". If this Imakefile includes
Library.tmpl there are no headers, include
this line instead of a HEADERS definition:
#define LibHeaders NO
REQUIREDLIBS when building a shared library, other libraries used
by this library that should be referenced at
link time.
LINTLIBS program-specific libraries for lint.
LOCAL_LDFLAGS program-specific flags for the linker.
LOCAL_LIBRARIES project libraries (usually specified
as -lname) needed by this program.
For example, "-lXt -lXext -lX11".
Used by SimpleProgramTarget and
ComplexProgramTarget* rules.
Do not include any system-specific libraries here.
SYS_LIBRARIES system libraries (usually specified
as -lname) needed by this program.
For example "MathLibrary".
Do not include any system-specific libraries
such as "-lnsl" here; they are automatically
added to the link command by the
vendor-specific .cf file.
SUBDIRS for an Imakefile in a directory containing
subdirectories, this names the subdirectories.
Such an Imakefile also needs to #define IHaveSubdirs
and call MakeSubdirs() and DependSubdirs().
MANSUFFIX suffix used by InstallManPage* rules.
May be set to $(LIBMANSUFFIX), $(FILEMANSUFFIX), or
$(MISCMANSUFFIX) in directories for libraries or data
files.
Rule-specific variables that may be set in an individual Imakefile.
If you aren't using these rules, you may need variables with a similar
function, but you need not use these names. However, following these
conventions may make your Imakefile easier to read and maintain.
DEPLIBS library dependencies for ComplexProgramTarget
SRCS source files used by ComplexProgramTarget and
DependTarget.
OBJS object files used by ComplexProgramTarget
PROGRAMS default target used with ComplexProgramTarget_(n)
SRCS1 source files used by ComplexProgramTarget_1
OBJS1 object files used by ComplexProgramTarget_1
DEPLIBS1 library dependencies for ComplexProgramTarget_1
SRCS2 source files used by ComplexProgramTarget_2
OBJS2 object files used by ComplexProgramTarget_2
DEPLIBS2 library dependencies for ComplexProgramTarget_2
SRCS3 source files used by ComplexProgramTarget_3
OBJS3 object files used by ComplexProgramTarget_3
DEPLIBS3 library dependencies for ComplexProgramTarget_3
Variables that can be set on the make command line:
DESTDIR directory under which "make install" should
install instead of "/"; used only for testing
"make install" rules, binary package building,
and specifying alternative installation directories
for cross compiles.
FILE file for "lint1" target to run lint on.
CDEBUGFLAGS -g and/or -O flag to control C compiler optimization.
CXXDEBUGFLAGS -g and/or -O flag to control C++ optimization.
LDSTRIPFLAGS flag to have linker strip objects (typically -x).
Typically set to the empty string to prevent
the linker from stripping objects; use this
way when setting CDEBUGFLAGS to "-g".
These variables are set in project-specific files such as X11.tmpl.
They should NOT be set in an Imakefile. These variables are sometimes
misused; they are included here to remind Imakefile writers NOT to use
them:
EXTRA_DEFINES project-specific -D flags
EXTRA_INCLUDES project-specific -I flags
EXTRA_ICONFIGFILES Additional project-specific imake config files
to add to ICONFIGFILES.
This is a list of files that define variables
that might affect compilation of some files.
Many other make variables are set up by the imake config files and can
be used in an Imakefile. The easiest way to discover them is to look
at the Makefile generated by an empty Imakefile.
Comments
Use C comment syntax in an Imakefile for comments that should not
appear in the resulting Makefile.
Use "XCOMM" at the start of each
line to produce a comment that will appear in the Makefile.
(The "XCOMM" will
be translated into the Makefile comment character "#" by imake.)
Do NOT use "#" as a comment character in Imakefiles; it confuses the C
preprocessor used by imake on some systems.
Imake variables
Don't abuse the variables in X11.tmpl that describe
particular pieces of X by using them to describe your own subsystems.
Instead, create new variables that are defaulted using
Imake.tmpl variables.
Examples
Since the easiest way to write an Imakefile is to start with one that
works, here are some short, easy-to-read Imakefile examples in the X
distribution:
with subdirs: config/Imakefile
library: lib/Xau/Imakefile
simple program: programs/xdpyinfo/Imakefile
complex progs: programs/xclipboard/Imakefile
complex prog: programs/xmodmap/Imakefile
Common Rules
Here are some of the common rules for building programs. How to use
them is described in Imake.rules and in the O'Reilly book "Software
Portability with imake."
Basic program-building rules
All of these except NormalProgramTarget also generate rules to install
the program and its manual page, and to generate dependencies.
SimpleProgramTarget Use if there is only one program to be made
and it has only one source file.
ComplexProgramTarget Use if there is only one program to be made
and it has multiple source files. Set SRCS to
the names of the source files, set OBJS to
the names of the object files, and set DEPLIBS
to the libraries that this program depends on.
ComplexProgramTarget_1 Like ComplexProgramTarget, but uses SRCS1,
OBJS1, and DEPLIBS1 and can be used with
ComplexProgramTarget_2 and ComplexProgramTarget_3
to build up to three programs in the same directory.
Set PROGRAMS to the programs built by all of
these rules. For more than 3 programs, use
NormalProgramTarget for each.
ComplexProgramTarget_2 Use after ComplexProgramTarget_1 for the
second program in a directory. Uses SRCS2,
OBJS2, and DEPLIBS2.
ComplexProgramTarget_3 Use after ComplexProgramTarget_2 for the
third program in a directory. Uses SRCS3,
OBJS3, and DEPLIBS3.
NormalProgramTarget Build a program. Can be used multiple times
with different arguments in the same Imakefile.
Lower level rules, often used with NormalProgramTarget
InstallProgram install a program.
InstallManPage install a manual page.
InstallDirectory install a directory.
DependTarget() include once at end of Imakefile with
NormalProgramTarget rules or that uses Library.tmpl.
Generates dependencies for files named in SRCS.
Manual page rules, commonly used only in special documentation directories:
InstallManPage
InstallManPageLong
InstallManPageAliases
Other rules:
SpecialCObjectRule Compile a C file with special flags.
AllTarget Declare additional targets to build.
InstallAppDefaults Install X application defaults file.
Imakefile for directory with subdirectories
XCOMM this is a sample Imakefile for a directory containing subdirectories
#define IHaveSubdirs
#define PassCDebugFlags CDEBUGFLAGS="$(CDEBUGFLAGS)"
SUBDIRS = list of subdirs ...
MakeSubdirs($(SUBDIRS))
DependSubdirs($(SUBDIRS))
Common Targets
These targets are typically NOT defined explicitly by the Imakefile
writer; rather they are generated automatically by imake rules.
They are listed here for the convenience of people using the resulting
Makefile, not people writing the original Imakefile.
all Default rule; builds whatever is in this directory.
Makefile Remake the Makefile (use after changing Imakefile).
Run "make depend" after.
Makefiles Remake all Makefiles in subdirectories. (Does
nothing if no subdirectories.)
Run "make depend" after.
includes Generate and install in the tree any necessary
header files.
depend Update dependencies in the Makefile calculated
by examining the source files.
install Install what "make all" built on the system.
install.man Install manual pages.
clean Remove built objects and other derived files.
lint Run lint.
tags Create a tags file.
|