more info about --output from Daniel Leidert c.f. #344654 Daniel

* doc/xsltproc.1 doc/xsltproc.xml: more info about --output
  from Daniel Leidert c.f. #344654
Daniel

2 files changed, 40 insertions, 6 deletions

diff --git a/doc/xsltproc.1 b/doc/xsltproc.1
index f506946e..0b10849f 100644
--- a/doc/xsltproc.1
+++ b/doc/xsltproc.1
@@ -2,7 +2,7 @@
 .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 .\" Instead of manually editing it, you probably should edit the DocBook XML
 .\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "XSLTPROC" "1" "2006\-03\-05" "libxslt" ""
+.TH "XSLTPROC" "1" "$Date$" "libxslt" ""
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -117,10 +117,32 @@ Direct output to the given
 \fIFILE\fR. Using the option with a
 \fIDIRECTORY\fR
 directs the output files to the specified directory. This can be useful for multiple outputs (also known as "chunking") or manpage processing.
-\fBNote:\fR
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBImportant\fR
 The given directory
 \fBmust\fR
 already exist.
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBNote\fR
+Make sure that
+\fIFILE\fR
+and
+\fIDIRECTORY\fR
+follow the
+\(lqURI reference computation\(rq
+as described in RFC 2396 and laters. This means, that e.g.
+\fB\-o directory\fR
+will maybe not work, but
+\fB\-o directory/\fR
+will.
 .TP
 \fB\-\-param \fR\fB\fIPARAMNAME\fR\fR\fB \fR\fB\fIPARAMVALUE\fR\fR
 Pass a parameter of name
diff --git a/doc/xsltproc.xml b/doc/xsltproc.xml
index b1fa4861..ae292883 100644
--- a/doc/xsltproc.xml
+++ b/doc/xsltproc.xml
@@ -26,7 +26,7 @@
 		</affiliation>
 	</author>
 	<!-- date should be the date of the latest change or the release version -->
-	<date>2006-03-05</date>
+	<date>$Date$</date>
 	<!-- still a bit buggy output, will talk to docbook-xsl upstream to fix this -->
 	<!-- <releaseinfo>This is release 0.4 of the xsltproc Manual.</releaseinfo> -->
 	<!-- <edition>0.4</edition> -->
@@ -280,10 +280,22 @@
 			the option with a <replaceable>DIRECTORY</replaceable> directs the
 			output files to the specified directory. This can be
 			useful for multiple outputs (also known as "chunking") or manpage
-			processing. <emphasis role="bold">Note:</emphasis> The given
-			directory <emphasis role="bold">must</emphasis>
-			already exist.
+			processing.
 		</para>
+		<important>
+			<para>
+				The given directory <emphasis role="bold">must</emphasis> already exist.
+			</para>
+		</important>
+		<note>
+			<para>
+				Make sure that <replaceable>FILE</replaceable>
+				and <replaceable>DIRECTORY</replaceable> follow the <quote>URI reference
+				computation</quote> as described in RFC 2396 and laters. This means, that
+				e.g. <option>-o directory</option> will maybe not work,
+				but <option>-o directory/</option> will.
+			</para>
+		</note>
 	</listitem>
 		</varlistentry>