[#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: "NAKAMURA, Hiroshi" <nahi@...>
Date: 2004-02-12 05:58:22 UTC
List: ruby-core #2387
Hi,

> From: "Dave Thomas" <dave@thomases.com>
> Sent: Thursday, February 12, 2004 2:16 PM

> > 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.

I don't like inline documentation, not RDoc formatting rule.
As we discussed a year ago, "RDoc" is a name of a document
embedding style and a text formatting rule.

> 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.

RD is just a text formatting rule.  I also dislike inline RD or
HTML documentation, too.

I love rdoc's "parsing and analysing to generate code browse view
even if no document there" feature very much.  It must be the way.

Regards,
// NaHi

In This Thread