From: Felix Wiemann <felixwiemann@us...> - 2004-09-28 15:01:53
Update of /cvsroot/docutils/docutils/docs/user
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv27147
added more documentation on record_dependencies
RCS file: /cvsroot/docutils/docutils/docs/user/config.txt,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -d -r1.26 -r1.27
--- config.txt 25 Sep 2004 23:31:19 -0000 1.26
+++ config.txt 28 Sep 2004 15:01:28 -0000 1.27
@@ -360,9 +360,10 @@
Path to a file to which Docutils writes a list of files the input
- file(s) depends on, e.g. due to file inclusion. [#pwd]_ The format
- is one filename per line. This option is particularly useful in
- conjunction with programs like ``make``.
+ file(s) depends on [#dependencies]_, e.g. due to file
+ inclusion. [#pwd]_ The format is one filename per line. This
+ option is particularly useful in conjunction with programs like
Set to ``-`` in order to write dependencies to stdout.
@@ -821,6 +822,20 @@
do the overriding explicitly, by assigning ``None`` to the other
+.. [#dependencies] Some notes on the dependency recorder:
+ * Images are only added to the dependency list if the
+ reStructuredText parser extracted image dimensions from the file.
+ * Stylesheets are only added if they are embedded.
+ * For practical reasons, the output of the LaTeX writer is
+ considered merely an *intermediate* processing stage. The
+ dependency recorder records all files the *rendered* file
+ (e.g. in PDF or DVI format) depends on. Thus, images and
+ stylesheets are both unconditionally recorded as dependencies
+ when using the LaTeX writer.
Old-Format Configuration Files