X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/57a981ebbbb35bcf0ab3c3af54e7ed86a088e492..f5576df6fd6c54ac0836b6cc9634f63a156f325a:/usr/src/usr.bin/mkdep/mkdep.1 diff --git a/usr/src/usr.bin/mkdep/mkdep.1 b/usr/src/usr.bin/mkdep/mkdep.1 index f283292843..2c4596818a 100644 --- a/usr/src/usr.bin/mkdep/mkdep.1 +++ b/usr/src/usr.bin/mkdep/mkdep.1 @@ -1,54 +1,103 @@ -.\" Copyright (c) 1987 Regents of the University of California. +.\" Copyright (c) 1987, 1990 The Regents of the University of California. .\" All rights reserved. .\" -.\" Redistribution and use in source and binary forms are permitted -.\" provided that the above copyright notice and this paragraph are -.\" duplicated in all such forms and that any documentation, -.\" advertising materials, and other materials related to such -.\" distribution and use acknowledge that the software was developed -.\" by the University of California, Berkeley. The name of the -.\" University may not be used to endorse or promote products derived -.\" from this software without specific prior written permission. -.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR -.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED -.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. .\" -.\" @(#)mkdep.1 5.6 (Berkeley) %G% +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. .\" -.TH MKDEP 1 "" -.UC 5 -.SH NAME -mkdep \- construct Makefile dependency list -.SH SYNOPSIS -.B mkdep -[ -.B \-f makefile -] [ -.B \-p -] [ flags ] file ... -.SH DESCRIPTION -\fIMkdep\fP 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. -It attaches this dependency list to the end of the file ``Makefile''. -An example of its use in a makefile might be: -.nf -.RS - -CFLAGS= -O -I../include -I. +.\" @(#)mkdep.1 5.13 (Berkeley) 6/2/91 +.\" +.Dd June 2, 1991 +.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: +.Bd -literal -offset indent +CFLAGS= -O -I../include SRCS= file1.c file2.c depend: mkdep ${CFLAGS} ${SRCS} -.RE -.PP +.Ed +.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. The \fB-f\fP option -provides \fImkdep\fP with a name other than ``Makefile'' to be edited. -If the \fB-p\fP option is provided, \fImkdep\fP produces dependencies -of the form ``program: program.c'' so that subsequent makes will -produce \fIprogram\fP directly from its C module rather than using an -intermediate \fI.o\fP module. This is useful in directories that -contain many programs, each of whose source is contained in a single -C module. -.SH "SEE ALSO" -cc(1), make(1) +CFLAGS is the list of flags for the C compiler. +.Pp +The options are as follows: +.Bl -tag -width Ds +.It Fl a +Append to the output file, +so that multiple +.Nm mkdep Ns 's +may be run from a single Makefile. +.It Fl f +Write the include file dependencies to +.Ar file , +instead of the default ``.depend''. +.It Fl p +Cause +.Nm mkdep +to produce dependencies of the form: +.Bd -literal -offset indent +program: program.c +.Ed +.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. +.El +.Sh SEE ALSO +.Xr cc 1 , +.Xr cpp 1 , +.Xr make 1 +.Sh FILES +.Bl -tag -width .depend -compact +.It Pa .depend +File containing list of dependencies. +.El +.Sh HISTORY +The +.Nm mkdep +command appeared in +.Bx 4.3 Tahoe .