add .Vx so tmac.andoc will call tmac.mdoc-old
[unix-history] / usr / src / usr.bin / mkdep / mkdep.1
.\" Copyright (c) 1987, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\" @(#)mkdep.1 5.12 (Berkeley) %G%
.\"
.Vx
.Vx
.Dd
.Dt MKDEP 1
.Os BSD 4.2
.Sh NAME
.Nm mkdep
.Nd construct Makefile dependency list
.Sh SYNOPSIS
.Nm mkdep
.Op Fl ap
.Op Fl f Ar file
.Op Ar flags
.Ar file ...
.Sh DESCRIPTION
.Nm Mkdep
takes a set of flags for the C compiler and a list
of C source files as arguments and constructs a set of include
file dependencies which are written into the file ``.depend''.
An example of its use in a Makefile might be:
.Pp
.Ds I
CFLAGS= -O -I../include
SRCS= file1.c file2.c
depend:
mkdep ${CFLAGS} ${SRCS}
.De
.Pp
where the macro SRCS is the list of C source files and the macro
CFLAGS is the list of flags for the C compiler.
.Pp
The options are as follows:
.Tw Ds
.Tp Fl a
Append to the output file,
so that multiple
.Sf Nm mkdep \&'s
may be run from a single Makefile.
.Tp Fl f
Write the include file dependencies to
.Ar file ,
instead of the default ``.depend''.
.Tp Fl p
Cause
.Nm mkdep
to produce dependencies of the form:
.Pp
.Ds I
program: program.c
.De
.Pp
so that subsequent makes will produce
.Ar program
directly from its C module rather than using an intermediate
.Pa \&.o
module.
This is useful for programs whose source is contained in a single
module.
.Tp
.Sh SEE ALSO
.Xr cc 1 ,
.Xr cpp 1 ,
.Xr make 1
.Sh FILES
.Dw .depend
.Di L
.Dp .depend
list of dependencies
.Sh HISTORY
.Nm Mkdep
appeared in the 4.3 Tahoe BSD release.