From 9c7aaf839025e58b25d1bb37afb2c11d36985dcb Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Mon, 11 Sep 2023 11:59:27 +0200
Subject: Add --dep-file option

In particular, this now allows writing the dependency information to stdout by
specifying `-` as this option's value.
---
 xsd/doc/pregenerated/xsd.1     | 11 ++++++++---
 xsd/doc/pregenerated/xsd.xhtml | 14 +++++++++++---
 2 files changed, 19 insertions(+), 6 deletions(-)

(limited to 'xsd/doc/pregenerated')

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
-- 
cgit v1.1