From 22b86d5a5ca561c7d9cd6e68ed69d0357fe7f3d0 Mon Sep 17 00:00:00 2001
From: Daniel Veillard <veillard@src.gnome.org>
Date: Mon, 12 Jun 2006 14:32:24 +0000
Subject: [PATCH] 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
---
 ChangeLog        |  5 +++++
 NEWS             |  8 ++++++++
 doc/xsltproc.1   | 26 ++++++++++++++++++++++++--
 doc/xsltproc.xml | 20 ++++++++++++++++----
 4 files changed, 53 insertions(+), 6 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 399871d2..fe9ca195 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Mon Jun 12 16:34:15 CEST 2006 Daniel Veillard <daniel@veillard.com>
+
+	* doc/xsltproc.1 doc/xsltproc.xml: more info about --output
+	  from Daniel Leidert c.f. #344654
+
 Tue Jun  6 17:16:33 CEST 2006 Daniel Veillard <daniel@veillard.com>
 
 	* configure.in libxslt.spec.in doc//*: preparing release of 1.1.17
diff --git a/NEWS b/NEWS
index 088e9a78..0eb5927b 100644
--- a/NEWS
+++ b/NEWS
@@ -10,6 +10,14 @@ ChangeLog.html
 to the CVS at 
 http://cvs.gnome.org/viewcvs/libxslt/
  code base.Those are the public releases made:
+1.1.17: Jun 6 2006:
+   - portability fixes: python detection
+   - bug fixes: some regression tests, attribute/namespaces output (Kasimier
+    Buchcik), problem in mixed xsl:value-of and xsl:text uses (Kasimier)
+   - improvements: internal refactoring (Kasimier Buchcik), use of the XPath
+    object cache in libxml2-2.6.25 (Kasimier)
+
+
 1.1.16: May 01 2006:
    - portability fixes: EXSLT date/time on Solaris and IRIX (Albert Chin),
       HP-UX  build (Albert Chin), 
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>