summaryrefslogtreecommitdiff
path: root/xsd/doc
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2023-09-11 11:59:27 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2023-09-11 11:59:27 +0200
commit9c7aaf839025e58b25d1bb37afb2c11d36985dcb (patch)
tree5555e9829b492f747a95cabd25a9bd71c7eef2af /xsd/doc
parent7d26ea59564e573b9f8a1f025f7fd5df24ee2e80 (diff)
Add --dep-file option
In particular, this now allows writing the dependency information to stdout by specifying `-` as this option's value.
Diffstat (limited to 'xsd/doc')
-rw-r--r--xsd/doc/pregenerated/xsd.111
-rw-r--r--xsd/doc/pregenerated/xsd.xhtml14
2 files changed, 19 insertions, 6 deletions
diff --git a/xsd/doc/pregenerated/xsd.1 b/xsd/doc/pregenerated/xsd.1
index 52820fb..b75232f 100644
--- a/xsd/doc/pregenerated/xsd.1
+++ b/xsd/doc/pregenerated/xsd.1
@@ -384,7 +384,8 @@ Generate \fBmake\fR dependency information\. This option triggers the creation
of the \fB\.d\fR file containing the dependencies of the generated files on
the main schema file as well as all the schema files that it includes/imports,
transitively\. This dependency file is then normally included into the main
-\fBmakefile\fR to implement automatic dependency tracking\.
+\fBmakefile\fR to implement automatic dependency tracking\. See also the
+\fB--dep-*\fR options\.
Note also that automatic dependency generation is not supported in the
file-per-type mode (\fB--file-per-type\fR)\. In this case, all the generated
@@ -405,8 +406,12 @@ directory prefixes\. If you require multiple targets, then you can specify
them as a single, space-separated argument or you can repeat this option
multiple times\.
.IP "\fB--dep-suffix\fR \fIsuffix\fR"
-Use the provided \fIsuffix\fR instead of the default \fB\.d\fR to construct
-the name of the dependency file\.
+Use \fIsuffix\fR instead of the default \fB\.d\fR to construct the name of the
+dependency file\. See also \fB--dep-file\fR\.
+.IP "\fB--dep-file\fR \fIpath\fR"
+Use \fIpath\fR as the generated dependency file path instead of deriving it
+from the input file name\. Write the dependency information to \fBstdout\fR if
+\fIpath\fR is \fB-\fR\. See also \fB--dep-regex\fR\.
.IP "\fB--dep-regex\fR \fIregex\fR"
Use the provided expression to construct the name of the dependency file\.
\fIregex\fR is a Perl-like regular expression in the form
diff --git a/xsd/doc/pregenerated/xsd.xhtml b/xsd/doc/pregenerated/xsd.xhtml
index 53b905c..15d9d5f 100644
--- a/xsd/doc/pregenerated/xsd.xhtml
+++ b/xsd/doc/pregenerated/xsd.xhtml
@@ -482,7 +482,8 @@
dependencies of the generated files on the main schema file as well as all
the schema files that it includes/imports, transitively. This dependency
file is then normally included into the main <code><b>makefile</b></code>
- to implement automatic dependency tracking.
+ to implement automatic dependency tracking. See also the
+ <code><b>--dep-*</b></code> options.
<p>Note also that automatic dependency generation is not supported in the
file-per-type mode (<code><b>--file-per-type</b></code>). In this case,
@@ -508,8 +509,15 @@
multiple times.</dd>
<dt><code><b>--dep-suffix</b></code> <code><i>suffix</i></code></dt>
- <dd>Use the provided <code><i>suffix</i></code> instead of the default
- <code><b>.d</b></code> to construct the name of the dependency file.</dd>
+ <dd>Use <code><i>suffix</i></code> instead of the default
+ <code><b>.d</b></code> to construct the name of the dependency file. See
+ also <code><b>--dep-file</b></code>.</dd>
+
+ <dt><code><b>--dep-file</b></code> <code><i>path</i></code></dt>
+ <dd>Use <code><i>path</i></code> as the generated dependency file path
+ instead of deriving it from the input file name. Write the dependency
+ information to <code><b>stdout</b></code> if <code><i>path</i></code> is
+ <code><b>-</b></code>. See also <code><b>--dep-regex</b></code>.</dd>
<dt><code><b>--dep-regex</b></code> <code><i>regex</i></code></dt>
<dd>Use the provided expression to construct the name of the dependency