Date: Wed, 5 Jul 2006 13:26:26 +0800 (CST) From: Cheng-Lung Sung <clsung@FreeBSD.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/99797: [patch] add libiconv subsection to zh-tut/converter Message-ID: <20060705052626.DBDC07E9A2@FreeBSD.csie.nctu.edu.tw> Resent-Message-ID: <200607050530.k655UJvE059291@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 99797
>Category: docs
>Synopsis: [patch] add libiconv subsection to zh-tut/converter
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: update
>Submitter-Id: current-users
>Arrival-Date: Wed Jul 05 05:30:18 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator: Cheng-Lung Sung
>Release: FreeBSD 6.1-PRERELEASE i386
>Organization:
FreeBSD @ Taiwan
>Environment:
System: FreeBSD.csie.nctu.edu.tw 6.1-STABLE FreeBSD 6.1-STABLE #9: Thu May 11 14:31:45 CST 2006 root@FreeBSD.csie.nctu.edu.tw:/home/usr.obj/usr/src/sys/FREEBSD i386
>Description:
- add libiconv subsection to converter/ of zh_TW's tutorial
- also modify original iconv section
>How-To-Repeat:
>Fix:
Index: chapters/converter.sgml
===================================================================
RCS file: /home/dcvs/doc/zh_TW.Big5/books/zh-tut/chapters/converter.sgml,v
retrieving revision 1.2
diff -u -r1.2 converter.sgml
--- chapters/converter.sgml 31 Jan 2006 01:31:05 -0000 1.2
+++ chapters/converter.sgml 5 Jul 2006 05:22:54 -0000
@@ -11,16 +11,18 @@
<sect1 id="iconv">
<title>iconv</title>
<para>由於版權的問題，FreeBSD 下的 iconv 2.0 大約是 2000 年的程式，
- 也就不能 GNU libiconv 所擁有的轉換表，
- 在使用上也是有許多缺點。</para>
+ 也就不能使用
+ <ulink url="http://www.gnu.org/software/libiconv/">GNU libiconv</ulink>
+ 所擁有的轉換表，在使用上也是有許多缺點，建議改用
+ <application>libiconv</application>。</para>
<para>安裝 <filename role="package">converters/iconv</filename>。</para>
<para>基本的用法有：</para>
<screen>
-&prompt.user; <userinput>iconv -f gb2312 -t big5 file.gb > file.big5</userinput></screen>
+&prompt.user; <userinput>biconv -f gb2312 -t big5 file.gb > file.big5</userinput></screen>
<para>以下是寫 C 程式的小範例：</para>
<programlisting>
#include <stdio.h>
-#include "iconv.h"
+#include "biconv.h"
void
my_iconv(char *fromcode, char *tocode, char *inbuf, char *outbuf)
@@ -74,6 +76,22 @@
http://www.dante.net/staff/konstantin/FreeBSD/iconv/</ulink></para>;
</sect1>
+ <sect1 id="libiconv">
+ <title>libiconv - GNU libiconv</title>
+ <para>
+ <filename role="package">converters/libiconv</filename>
+ 是由 GNU 所發展的，功能比前述的 <application>iconv</application> 較為完備。
+ </para>
+ <para><application>libiconv</application>使用方法：</para>
+ <screen>
+&prompt.user; <userinput>iconv -f big5 -t utf8 < doc.big5 > doc.utf8</userinput>
+&prompt.user; <userinput>iconv -l</userinput>
+ </screen>
+ <para>
+ WWW: <ulink url="http://www.gnu.org/software/libiconv/">;
+ http://www.gnu.org/software/libiconv/</ulink></para>;
+ </sect1>
+
<sect1 id="cn2jp">
<title>cn2jp - 在中文和日文間的編碼轉移函式庫</title>
<para>
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060705052626.DBDC07E9A2>