[libxml2] Add limitations about encoding conversion

[Daniel Veillard <veillard src gnome org>]

commit e59c244e73450f67672a077571f594484e8b3f1e
Author: Daniel Veillard <veillard redhat com>
Date:   Wed Dec 11 00:01:38 2013 +0800

    Add limitations about encoding conversion

 doc/xmllint.1   |    7 ++-----
 doc/xmllint.xml |    2 +-
 2 files changed, 3 insertions(+), 6 deletions(-)
---
diff --git a/doc/xmllint.1 b/doc/xmllint.1
index c647763..540a114 100644
--- a/doc/xmllint.1
+++ b/doc/xmllint.1
@@ -1,7 +1,7 @@
 '\" t
 .\"     Title: xmllint
 .\"    Author: John Fleck <jfleck inkstain net>
-.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
 .\"      Date: $Date$
 .\"    Manual: xmllint Manual
 .\"    Source: libxml2
@@ -55,7 +55,6 @@ is included in
 \fBlibxml\fR(3)\&.
 .SH "OPTIONS"
 .PP
-
 \fBxmllint\fR
 accepts the following options (in alphabetical order):
 .PP
@@ -147,7 +146,7 @@ and populate the tree with inherited attributes\&.
 .PP
 \fB\-\-encode \fR\fB\fIENCODING\fR\fR
 .RS 4
-Output in the given encoding\&.
+Output in the given encoding\&. Note that this works for full document not fragments or result from XPath 
queries\&.
 .RE
 .PP
 \fB\-\-format\fR
@@ -409,7 +408,6 @@ input\&.
 .RE
 .SH "SHELL COMMANDS"
 .PP
-
 \fBxmllint\fR
 offers an interactive shell mode invoked with the
 \fB\-\-shell\fR
@@ -537,7 +535,6 @@ controls the indentation\&. The default value is two spaces " "\&.
 .RE
 .SH "DIAGNOSTICS"
 .PP
-
 \fBxmllint\fR
 return codes provide information that can be used when calling it from scripts\&.
 .PP
diff --git a/doc/xmllint.xml b/doc/xmllint.xml
index 5f0f000..1008179 100644
--- a/doc/xmllint.xml
+++ b/doc/xmllint.xml
@@ -271,7 +271,7 @@
                <varlistentry>
        <term><option>--encode <replaceable class="option">ENCODING</replaceable></option></term>
        <listitem>
-               <para>Output in the given encoding.</para>
+               <para>Output in the given encoding. Note that this works for full document not fragments or 
result from XPath queries.</para>
        </listitem>
                </varlistentry>