From ec00b639169c2fb10e295ad712cb417156839d09 Mon Sep 17 00:00:00 2001
From: Adam Dickmeiss <adam@indexdata.dk>
Date: Tue, 18 Nov 2003 20:34:34 +0000
Subject: [PATCH] man page for yaz-iconv

---
 doc/Makefile.am          |    9 ++--
 doc/yaz-iconv-man.xml    |  110 ++++++++++++++++++++++++++++++++++++++++++++++
 doc/yaz-marcdump-man.xml |    4 +-
 3 files changed, 119 insertions(+), 4 deletions(-)
 create mode 100644 doc/yaz-iconv-man.xml

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 2c71662..c5980b3 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,4 +1,4 @@
-## $Id: Makefile.am,v 1.50 2003-11-16 22:56:53 adam Exp $
+## $Id: Makefile.am,v 1.51 2003-11-18 20:34:34 adam Exp $
 
 docdir=$(datadir)/doc/@PACKAGE@
 
@@ -25,10 +25,10 @@ HTMLFILES = \
 
 MANFILES=yaz-client.1 yaz-client-ssl.1 yaz-ztest.8 \
 	yaz-ztest-ssl.8 yaz-config.8 yaz.7 zoomsh.1 yaz-asncomp.1 \
-	yaz-marcdump.1
+	yaz-marcdump.1 yaz-iconv.1
 REFFILES=yaz-client-man.xml yaz-ztest-man.xml yaz-config-man.xml \
 	yaz-man.xml zoomsh-man.xml yaz-asncomp-man.xml \
-	yaz-marcdump-man.xml
+	yaz-marcdump-man.xml yaz-iconv-man.xml
 
 SUPPORTFILES=yazhtml.dsl yazphp.dsl yazprint.dsl tkl.xsl xml.dcl id.eps \
 	apilayer.obj yaz.css
@@ -66,6 +66,9 @@ yaz-asncomp.1: yaz-asncomp-man.xml
 yaz-marcdump.1: yaz-marcdump-man.xml
 	docbook2man $(srcdir)/yaz-marcdump-man.xml
 
+yaz-iconv.1: yaz-iconv-man.xml
+	docbook2man $(srcdir)/yaz-iconv-man.xml
+
 $(HTMLFILES): $(XMLFILES)  
 	jade -E14 -D $(srcdir) -d yazhtml.dsl -t sgml $(srcdir)/xml.dcl yaz.xml
 
diff --git a/doc/yaz-iconv-man.xml b/doc/yaz-iconv-man.xml
new file mode 100644
index 0000000..502f846
--- /dev/null
+++ b/doc/yaz-iconv-man.xml
@@ -0,0 +1,110 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
+<!-- $Id: yaz-iconv-man.xml,v 1.1 2003-11-18 20:34:34 adam Exp $ -->
+<refentry id="yaz-iconv">
+ <refmeta>
+  <refentrytitle>yaz-iconv</refentrytitle>
+  <manvolnum>1</manvolnum>
+ </refmeta>
+ 
+ <refnamediv>
+  <refname>yaz-iconv</refname>
+  <refpurpose>YAZ Charcter set conversion utility</refpurpose>
+ </refnamediv>
+ 
+ <refsynopsisdiv>
+  <cmdsynopsis>
+   <command>yaz-iconv</command>
+   <arg choice="opt"><option>-f <replaceable>from</replaceable></option></arg>
+   <arg choice="opt"><option>-t <replaceable>to</replaceable></option></arg>
+   <arg choice="opt"><option>-v</option></arg>
+   <arg choice="opt" rep="repeat">file</arg>
+  </cmdsynopsis>
+ </refsynopsisdiv>
+ 
+ <refsect1><title>DESCRIPTION</title>
+  <para>
+   <command>yaz-iconv</command> converts data in file in character
+   set specified by <replaceable>from</replaceable> to output in
+   character set as specified by <replaceable>to</replaceable>.
+  </para>
+  <para>
+   This <command>yaz-iconv</command> utility similar to the
+   <command>iconv</command> found on many POSIX systems (Glibc, Solaris, etc).
+  </para>
+  <para>
+   If no <replaceable>file</replaceable> is specified,
+   <command>yaz-iconv</command> reads from standard input.
+  </para>
+ </refsect1>
+ 
+ <refsect1><title>OPTIONS</title>
+  
+  <variablelist>
+   <varlistentry>
+    <term>-f<replaceable>from</replaceable>]</term>
+    <listitem><para>
+      Specify the character set <replaceable>from</replaceable>
+      of the input file.
+      Should be used in conjunction with option <literal>-t</literal>.
+     </para></listitem>
+   </varlistentry>
+
+   <varlistentry>
+    <term>-t<replaceable>to</replaceable>]</term>
+    <listitem><para>
+      Specify the character set <replaceable>of</replaceable>
+      of the output.
+      Should be used in conjunction with option <literal>-f</literal>.
+     </para></listitem>
+   </varlistentry>
+
+   <varlistentry>
+    <term>-v</term>
+    <listitem><para>
+      Print more information about the conversion process.
+     </para></listitem>
+   </varlistentry>
+
+  </variablelist>
+ </refsect1>
+
+ <refsect1><title>EXAMPLES</title>
+  <para>
+   The following command converts from ISO-8859-1 (Latin-1) to
+   UTF-8.
+   <screen>
+    yaz-iconv -f ISO-8859-1 -t UTF-8 -X &lt;input.lst &gt;output.lst
+   </screen>
+  </para>
+ </refsect1> 
+
+ <refsect1><title>FILES</title>
+  <para>
+   <filename><replaceable>prefix</replaceable>/bin/yaz-iconv</filename>
+  </para>
+  <para>
+   <filename><replaceable>prefix</replaceable>/include/yaz/yaz-iconv.h</filename>
+  </para>
+ </refsect1>
+ <refsect1><title>SEE ALSO</title>
+  <para>
+   yaz(7)
+   iconv(1)
+  </para>
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-local-catalogs: nil
+sgml-namecase-general:t
+End:
+-->
diff --git a/doc/yaz-marcdump-man.xml b/doc/yaz-marcdump-man.xml
index 607c75a..4ed296e 100644
--- a/doc/yaz-marcdump-man.xml
+++ b/doc/yaz-marcdump-man.xml
@@ -1,5 +1,5 @@
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
-<!-- $Id: yaz-marcdump-man.xml,v 1.1 2003-10-27 12:21:24 adam Exp $ -->
+<!-- $Id: yaz-marcdump-man.xml,v 1.2 2003-11-18 20:34:34 adam Exp $ -->
 <refentry id="yaz-marcdump">
  <refmeta>
   <refentrytitle>yaz-marcdump</refentrytitle>
@@ -114,6 +114,8 @@
  <refsect1><title>FILES</title>
   <para>
    <filename><replaceable>prefix</replaceable>/bin/yaz-marcdump</filename>
+  </para>
+  <para>
    <filename><replaceable>prefix</replaceable>/include/yaz/marcdisp.h</filename>
   </para>
   </refsect1>
-- 
1.7.10.4