<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

<!-- Process this file with docbook-to-man to generate an nroff manual
     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
     less'.  A typical entry in a Makefile or Makefile.am is:

manpage.1: manpage.sgml
	docbook-to-man $< > $@


	The docbook-to-man binary is found in the docbook-to-man package.
	Please remember that if you create the nroff version in one of the
	debian/rules file targets (such as build), you will need to include
	docbook-to-man in your Build-Depends control field.

  -->

  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
  <!ENTITY dhfirstname "<firstname>Ying-Chun</firstname>">
  <!ENTITY dhsurname   "<surname>Liu</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>Sep 12, 2006</date>">
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
       allowed: see man(7), man(1). -->
  <!ENTITY dhsection   "<manvolnum>6</manvolnum>">
  <!ENTITY dhemail     "<email>grandpaul@gmail.com</email>">
  <!ENTITY dhusername  "Ying-Chun Liu (PaulLiu)">
  <!ENTITY dhucpackage "<refentrytitle>KAWARI8</refentrytitle>">
  <!ENTITY dhpackage   "kawari">

  <!ENTITY debian      "<productname>Debian</productname>">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
]>

<refentry>
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
    <copyright>
      <year>2006</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </refentryinfo>
  <refmeta>
    &dhucpackage;

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>kawari_encode, kawari_encode2, kawari_decode2</refname>

    <refpurpose>&dhpackage; 8.0 encoder/decoder</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>kawari_encode</command>

      <arg rep='repeat'><replaceable>file</replaceable></arg>
    </cmdsynopsis>
    <cmdsynopsis>
      <command>kawari_encode2</command>

      <arg rep='repeat'><replaceable>file</replaceable></arg>
    </cmdsynopsis>
    <cmdsynopsis>
      <command>kawari_decode2</command>

      <arg rep='repeat'><replaceable>file</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>

    <para>This manual page documents briefly the
      <command>&dhpackage;</command> command.
    </para>

    <para>This manual page was written for the &debian; distribution
      because the original program does not have a manual page.
      Instead, it has documentation written in HTML format. For detailed
      descriptions, see <application>doc-base</application>.
    </para>

    <para><command>&dhpackage;_encode</command> encodes kawari scripts to
    an encoded file. So the users for the scripts cannot easily read the
    content. It can be used to protect the content of Kawari scripts.
    It takes several text files as inputs and converts them to 
    <filename>.kaw</filename> files
    separately.
    </para>

    <para><command>&dhpackage;_encode2</command> is an advanced
     <command>&dhpackage;_encode</command>. It is able to assign
    a symmetric key like some encrypting systems. The key affects
    the encoding system. Users need the key to decode them.
    </para>

    <para><command>&dhpackage;_decode2</command> is a decoder of the
    <filename>.kaw</filename> files. It takes several 
    <filename>.kaw</filename> files and convert them back to
    <filename>.txt</filename> files. If the kaw files is 
    encoded by
    <command>&dhpackage;_encode2</command>, the key must be provided
    correctly for decoding.
    </para>

  </refsect1>
  <refsect1>
    <title>AUTHOR</title>

    <para>This manual page was written by &dhusername; &lt;&dhemail;&gt; for
      the &debian; system (but may be used by others).
      This manual page is in public domain and is freely reproduced,
      distributed,
      transmitted, used, modified, built upon, or otherwise
      exploited by anyone for any purpose, commercial or non-commercial,
      and
      in any way, including by methods that have not yet been invented or
      conceived.
    </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:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
