naruse	2008-01-13 20:24:44 +0900 (Sun, 13 Jan 2008)

  New Revision: 15024

  Modified files:
    trunk/ChangeLog
    trunk/encoding.c

  Log:
    * encoding.c: add documents.


  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi/trunk/ChangeLog?r1=15024&r2=15023&diff_format=u
  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi/trunk/encoding.c?r1=15024&r2=15023&diff_format=u

Index: encoding.c
===================================================================
--- encoding.c	(revision 15023)
+++ encoding.c	(revision 15024)
@@ -757,16 +757,14 @@
  * Returns the list of loaded encodings.
  *
  *   Encoding.list
- *   => [#<Encoding:ASCII-8BIT>, #<Encoding:EUC-JP>,
- *       #<Encoding:Shift_JIS>, #<Encoding:UTF-8>,
+ *   => [#<Encoding:ASCII-8BIT>, #<Encoding:UTF-8>,
  *       #<Encoding:ISO-2022-JP (dummy)>]
  *
  *   Encoding.find("US-ASCII")
  *   => #<Encoding:US-ASCII>
  *
  *   Encoding.list
- *   => [#<Encoding:ASCII-8BIT>, #<Encoding:EUC-JP>,
- *       #<Encoding:Shift_JIS>, #<Encoding:UTF-8>,
+ *   => [#<Encoding:ASCII-8BIT>, #<Encoding:UTF-8>,
  *       #<Encoding:US-ASCII>, #<Encoding:ISO-2022-JP (dummy)>]
  *
  */
@@ -1000,6 +998,22 @@
     return ST_CONTINUE;
 }
 
+/*
+ * call-seq:
+ *   Encoding.name_list => ["enc1", "enc2", ...]
+ *
+ * Returns the list of available encoding names.
+ *
+ *   Encoding.name_list
+ *   => ["US-ASCII", "ASCII-8BIT", "UTF-8",
+ *       "ISO-8859-1", "Shift_JIS", "EUC-JP",
+ *       "Windows-31J",
+ *       "BINARY", "CP932", "eucJP"]
+ *
+ * This list doesn't include dummy encodings.
+ *
+ */
+
 static VALUE
 rb_enc_name_list(VALUE klass)
 {
@@ -1025,6 +1039,18 @@
     return 0;
 }
 
+/*
+ * call-seq:
+ *   Encoding.aliases => {"alias1" => "orig1", "alias2" => "orig2", ...}
+ *
+ * Returns the hash of available encoding alias and original encoding name.
+ *
+ *   Encoding.aliases
+ *   => {"BINARY"=>"ASCII-8BIT", "ASCII"=>"US-ASCII", "ANSI_X3.4-1986"=>"US-ASCII",
+ *       "SJIS"=>"Shift_JIS", "eucJP"=>"EUC-JP", "CP932"=>"Windows-31J"}
+ *
+ */
+
 static VALUE
 rb_enc_aliases(VALUE klass)
 {
Index: ChangeLog
===================================================================
--- ChangeLog	(revision 15023)
+++ ChangeLog	(revision 15024)
@@ -1,3 +1,7 @@
+Sun Jan 13 20:24:03 2008  NARUSE, Yui  <naruse@r...>
+
+	* encoding.c: add documents.
+
 Sun Jan 13 18:41:48 2008  Nobuyoshi Nakada  <nobu@r...>
 
 	* encoding.c (Init_Encoding): moved initialization from encdb.h.

--
ML: ruby-changes@q...
Info: