Roger Pack | 3 Aug 00:51 2010
Picon

Re: comments from an experienced programmer on ruby docs

Might suggest adding info to the ruby wikibook:

http://en.wikibooks.org/wiki/Ruby_Programming

On Wed, Jul 28, 2010 at 12:41 PM,  <travis.ml-ruby-doc <at> subspacefield.org> wrote:
>
> Hey there, I am learning ruby for my hard drive backup project:
>
> http://www.subspacefield.org/security/hdb/
>
> Ruby is a cool language, but the documentation is a little hard to
> read.  Many people use the term "Foo#whatever" with the assumption
> that one knows what it means - I originally assumed it was an instance
> method, but now believe it is a class method.  Since it's a special
> character, you can't really search google for it easily.
>
> Regarding http://rubylearning.com/: the formatting of the text boxes
> is awful, since at least on my computer, it requires manually scrolling
> every one, effectively peering at the program through a tiny viewport.
> The content, however, is very good.
>
> One thing that needs discussion is how everything except ints and
> floats (and perhaps some other types) are passed by reference.  I got
> really bit by passing strings into constructors, and the constructor
> later modified the string, and that changed the value of the thing I
> passed in.  This is true for arrays as well, and any user-defined
> objects.  Since this is a change from how many other scripting
> languages work, you should point it out a little better (it is hinted
> at).  In essence, you'll want to dup any parameter before modifying it
> (unless again it is an integer or float).  I assume these are the
(Continue reading)

Rich Morin | 9 Aug 00:05 2010

http://ruby-doc.org/core/classes/Dir.html#M002322 nits

There is a formatting problem in the Dir.glob entry:

  http://ruby-doc.org/core/classes/Dir.html#M002322

It looks like a backslash is confusing things in the last entry
in the table.  What displays is:

  <code>
  </code>:  Escapes the next metacharacter.

Also, I don't see any places where backslashes are demonstrated in
the example area.

Finally, the entry says that * is / .* /x in regexp.  I think it's
actually closer to / [^/]* /.

-r
--

-- 
http://www.cfcl.com/rdm            Rich Morin
http://www.cfcl.com/rdm/resume     rdm <at> cfcl.com
http://www.cfcl.com/rdm/weblog     +1 650-873-7841

Technical editing and writing, programming, system design

Roger Pack | 9 Aug 14:13 2010
Picon

http://ruby-doc.org/core/classes/Dir.html#M002322 nits

you can submit a patch on http://redmine.ruby-lang.org/
GL.
-r

On Sun, Aug 8, 2010 at 4:05 PM, Rich Morin <rdm <at> cfcl.com> wrote:
> There is a formatting problem in the Dir.glob entry:
>
>  http://ruby-doc.org/core/classes/Dir.html#M002322
>
> It looks like a backslash is confusing things in the last entry
> in the table.  What displays is:
>
>  <code>
>  </code>:  Escapes the next metacharacter.
>
> Also, I don't see any places where backslashes are demonstrated in
> the example area.
>
>
> Finally, the entry says that * is / .* /x in regexp.  I think it's
> actually closer to / [^/]* /.
>
> -r
> --
> http://www.cfcl.com/rdm            Rich Morin
> http://www.cfcl.com/rdm/resume     rdm <at> cfcl.com
> http://www.cfcl.com/rdm/weblog     +1 650-873-7841
>
> Technical editing and writing, programming, system design
>
(Continue reading)


Gmane