| 1 |
730 |
jeremybenn |
/* Dependency generator for Makefile fragments.
|
| 2 |
|
|
Copyright (C) 2000, 2001, 2003, 2009 Free Software Foundation, Inc.
|
| 3 |
|
|
Contributed by Zack Weinberg, Mar 2000
|
| 4 |
|
|
|
| 5 |
|
|
This program is free software; you can redistribute it and/or modify it
|
| 6 |
|
|
under the terms of the GNU General Public License as published by the
|
| 7 |
|
|
Free Software Foundation; either version 3, or (at your option) any
|
| 8 |
|
|
later version.
|
| 9 |
|
|
|
| 10 |
|
|
This program is distributed in the hope that it will be useful,
|
| 11 |
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
| 12 |
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
| 13 |
|
|
GNU General Public License for more details.
|
| 14 |
|
|
|
| 15 |
|
|
You should have received a copy of the GNU General Public License
|
| 16 |
|
|
along with this program; see the file COPYING3. If not see
|
| 17 |
|
|
<http://www.gnu.org/licenses/>.
|
| 18 |
|
|
|
| 19 |
|
|
In other words, you are welcome to use, share and improve this program.
|
| 20 |
|
|
You are forbidden to forbid anyone else to use, share and improve
|
| 21 |
|
|
what you give them. Help stamp out software-hoarding! */
|
| 22 |
|
|
|
| 23 |
|
|
#ifndef LIBCPP_MKDEPS_H
|
| 24 |
|
|
#define LIBCPP_MKDEPS_H
|
| 25 |
|
|
|
| 26 |
|
|
/* This is the data structure used by all the functions in mkdeps.c.
|
| 27 |
|
|
It's quite straightforward, but should be treated as opaque. */
|
| 28 |
|
|
|
| 29 |
|
|
struct deps;
|
| 30 |
|
|
|
| 31 |
|
|
/* Create a deps buffer. */
|
| 32 |
|
|
extern struct deps *deps_init (void);
|
| 33 |
|
|
|
| 34 |
|
|
/* Destroy a deps buffer. */
|
| 35 |
|
|
extern void deps_free (struct deps *);
|
| 36 |
|
|
|
| 37 |
|
|
/* Add a set of "vpath" directories. The second argument is a colon-
|
| 38 |
|
|
separated list of pathnames, like you would set Make's VPATH
|
| 39 |
|
|
variable to. If a dependency or target name begins with any of
|
| 40 |
|
|
these pathnames (and the next path element is not "..") that
|
| 41 |
|
|
pathname is stripped off. */
|
| 42 |
|
|
extern void deps_add_vpath (struct deps *, const char *);
|
| 43 |
|
|
|
| 44 |
|
|
/* Add a target (appears on left side of the colon) to the deps list. Takes
|
| 45 |
|
|
a boolean indicating whether to quote the target for MAKE. */
|
| 46 |
|
|
extern void deps_add_target (struct deps *, const char *, int);
|
| 47 |
|
|
|
| 48 |
|
|
/* Sets the default target if none has been given already. An empty
|
| 49 |
|
|
string as the default target is interpreted as stdin. */
|
| 50 |
|
|
extern void deps_add_default_target (struct deps *, const char *);
|
| 51 |
|
|
|
| 52 |
|
|
/* Add a dependency (appears on the right side of the colon) to the
|
| 53 |
|
|
deps list. Dependencies will be printed in the order that they
|
| 54 |
|
|
were entered with this function. By convention, the first
|
| 55 |
|
|
dependency entered should be the primary source file. */
|
| 56 |
|
|
extern void deps_add_dep (struct deps *, const char *);
|
| 57 |
|
|
|
| 58 |
|
|
/* Write out a deps buffer to a specified file. The third argument
|
| 59 |
|
|
is the number of columns to word-wrap at (0 means don't wrap). */
|
| 60 |
|
|
extern void deps_write (const struct deps *, FILE *, unsigned int);
|
| 61 |
|
|
|
| 62 |
|
|
/* Write out a deps buffer to a file, in a form that can be read back
|
| 63 |
|
|
with deps_restore. Returns nonzero on error, in which case the
|
| 64 |
|
|
error number will be in errno. */
|
| 65 |
|
|
extern int deps_save (struct deps *, FILE *);
|
| 66 |
|
|
|
| 67 |
|
|
/* Read back dependency information written with deps_save into
|
| 68 |
|
|
the deps buffer. The third argument may be NULL, in which case
|
| 69 |
|
|
the dependency information is just skipped, or it may be a filename,
|
| 70 |
|
|
in which case that filename is skipped. */
|
| 71 |
|
|
extern int deps_restore (struct deps *, FILE *, const char *);
|
| 72 |
|
|
|
| 73 |
|
|
/* For each dependency *except the first*, emit a dummy rule for that
|
| 74 |
|
|
file, causing it to depend on nothing. This is used to work around
|
| 75 |
|
|
the intermediate-file deletion misfeature in Make, in some
|
| 76 |
|
|
automatic dependency schemes. */
|
| 77 |
|
|
extern void deps_phony_targets (const struct deps *, FILE *);
|
| 78 |
|
|
|
| 79 |
|
|
#endif /* ! LIBCPP_MKDEPS_H */
|
