[#2367] Standard libraries — Dave Thomas <dave@...>

From ruby-dev summary:

60 messages 2004/02/11

[#2397] PATCH: deprecate cgi-lib, getopts, importenv, parsearg from standard library — Gavin Sinclair <gsinclair@...>

Index: cgi-lib.rb

15 messages 2004/02/12

[#2465] PATCH: OpenStruct#initialize to yield self — Gavin Sinclair <gsinclair@...>

This is a common approach I use to object initialization; I don't know

24 messages 2004/02/19

Re: Standard libraries

From: Dave Thomas <dave@...>
Date: 2004-02-12 05:16:50 UTC
List: ruby-core #2384
On Feb 11, 2004, at 20:40, NAKAMURA, Hiroshi wrote:
> RDoc style is a must?  I don't like documentation buried within
> a source code (code duplication for me).

I think one style is a good idea: whether it's RDoc or something else I 
don't really mind, but all code should use it.

I'm not sure, though, how RDoc adds duplication. Unlike every other 
style of documentation out there, RDoc actually extracts a fair amount 
of documentation from the actual executable source code, meaning that 
your have to write considerably less documentation than you would with 
rdtool or (say) html.


Cheers

Dave


In This Thread