Add limitations about encoding conversion

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

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>