[ruby-core:52549] [ruby-trunk - Bug #7890][Open] Data class should have documentation

[ruby-core:52549] [ruby-trunk - Bug #7890][Open] Data class should have documentation

[halogenandtoast (Matthew Mongeau)]

Issue #7890 has been reported by halogenandtoast (Matthew Mongeau).

----------------------------------------
Bug #7890: Data class should have documentation
https://bugs.ruby-lang.org/issues/7890

Author: halogenandtoast (Matthew Mongeau)
Status: Open
Priority: Normal
Assignee: zzak (Zachary Scott)
Category: DOC
Target version: 
ruby -v: 2.0.0


This class is confusing without knowing where to lookup information. I've attached a patch that points developers to README.ext

I'm assigning this to zzak, hopefully if this is the wrong person to assign it to he can assign it to someone else.


-- 
http://bugs.ruby-lang.org/

[ruby-core:52550] [ruby-trunk - Bug #7890] Data class should have documentation

[halogenandtoast (Matthew Mongeau)]

Issue #7890 has been updated by halogenandtoast (Matthew Mongeau).


I have a lack of experience with redmine. I don't see my patch attached, so just incase:

Index: object.c
===================================================================
--- object.c	(revision 39327)
+++ object.c	(working copy)
@@ -3115,6 +3115,12 @@
     rb_cData = rb_define_class("Data", rb_cObject);
     rb_undef_alloc_func(rb_cData);
 
+    /*
+     * Document-class: Data
+     *
+     *  This is a recommended base class for use by C extensions using Data_Make_Struct/Data_Wrap_Struct, see README.EXT for details.
+     */
+
     rb_cTrueClass = rb_define_class("TrueClass", rb_cObject);
     rb_define_method(rb_cTrueClass, "to_s", true_to_s, 0);
     rb_define_alias(rb_cTrueClass, "inspect", "to_s");
----------------------------------------
Bug #7890: Data class should have documentation
https://bugs.ruby-lang.org/issues/7890#change-36637

Author: halogenandtoast (Matthew Mongeau)
Status: Open
Priority: Normal
Assignee: zzak (Zachary Scott)
Category: DOC
Target version: 
ruby -v: 2.0.0


This class is confusing without knowing where to lookup information. I've attached a patch that points developers to README.ext

I'm assigning this to zzak, hopefully if this is the wrong person to assign it to he can assign it to someone else.


-- 
http://bugs.ruby-lang.org/

[ruby-core:52557] [ruby-trunk - Bug #7890] Data class should have documentation

[nobu (Nobuyoshi Nakada)]

Issue #7890 has been updated by nobu (Nobuyoshi Nakada).


I've supposed removal of Data in Ruby level.
----------------------------------------
Bug #7890: Data class should have documentation
https://bugs.ruby-lang.org/issues/7890#change-36645

Author: halogenandtoast (Matthew Mongeau)
Status: Closed
Priority: Normal
Assignee: zzak (Zachary Scott)
Category: DOC
Target version: 
ruby -v: 2.0.0


This class is confusing without knowing where to lookup information. I've attached a patch that points developers to README.ext

I'm assigning this to zzak, hopefully if this is the wrong person to assign it to he can assign it to someone else.


-- 
http://bugs.ruby-lang.org/

[ruby-core:52558] [ruby-trunk - Bug #7890] Data class should have documentation

[halogenandtoast (Matthew Mongeau)]

Issue #7890 has been updated by halogenandtoast (Matthew Mongeau).


nobu (Nobuyoshi Nakada) wrote:
> I've supposed removal of Data in Ruby level.

It's my understanding that a lot of people feel that way, might be worth deprecating because I'd be uncertain as to how many C extensions use this. I know ruby std-lib has it in curses, iconv, raddrinfo, stringio, tcltklib, and win32ole. The core has it in marshal, transcode, and error. I don't currently understand the functionality behind TypedData_Make_Struct and Data_Wrap_Struct so I'm not sure how these libraries would be affected.


----------------------------------------
Bug #7890: Data class should have documentation
https://bugs.ruby-lang.org/issues/7890#change-36646

Author: halogenandtoast (Matthew Mongeau)
Status: Closed
Priority: Normal
Assignee: zzak (Zachary Scott)
Category: DOC
Target version: 
ruby -v: 2.0.0


This class is confusing without knowing where to lookup information. I've attached a patch that points developers to README.ext

I'm assigning this to zzak, hopefully if this is the wrong person to assign it to he can assign it to someone else.


-- 
http://bugs.ruby-lang.org/