Ryan Davis | 21 Nov 04:59
Favicon
Gravatar

Re: Error in MatchData docs


On Nov 20, 2008, at 14:06 , Rich Morin wrote:

> At 14:16 -0700 11/14/08, James Britt wrote:
>> The API docs are generated from comments in the Ruby source code.
>>
>> The best way to handle this is to, ideally, post a patch to the
>> ruby-doc or ruby-core mailing lists for the code/comments in
>> question.
>
> Actually, the best way to handle this would be to have a way for
> the reader to make a comment, wiki-style, on the page, with an
> alert being generated to interested parties...

Actually, statements with "the best way" in them rarely are,  
especially if they start with "Actually".

In this case, the best way to actually get a change into the system is  
indeed to submit a patch to ruby-core. You're more than welcome to set  
up the system you're talking about. Until then it is simply pie-in-the- 
sky.

Btw, LOVED YOU in Strange Brew!

Ted Behling | 14 Nov 22:05

Error in MatchData docs

Hello,

I wanted to point out an error I found in the documentation for the
MatchData class, visible at
http://ruby-doc.org/core/classes/MatchData.html .  Please advise if I
should post this elsewhere (such as a bug tracker).

Under the heading "mtch.captures => array", that page says:

    Returns the array of captures; equivalent to mtch.to_a. 

However, that is demonstrably not the case, at least in Ruby 1.8.5.
MatchData#captures is different from MatchData#to_a in that to_a's first
element is the entire matched string, as in:

    irb(main):001:0> /(.)(.)(.)/.match('abc').captures
    => ["a", "b", "c"]
    irb(main):002:0> /(.)(.)(.)/.match('abc').to_a
    => ["abc", "a", "b", "c"]
    irb(main):003:0>

I suggest the verbage be changed to append the text "except that to_a
inserts the matched string as the first array element" after "equivalent
to mtch.to_a". 

Ted Behling
ISP Systems Analyst, Hargray Communications
ted.behling <at> htc.hargray.com

(Continue reading)

Joe Wölfel | 18 Sep 18:22

Using a single Rake dependency block to generate more than one file.

Often I have a block that generates more than one file.   Although  
Rake seems to accept reasonable syntax for doing this it doesn't   
work.  Here's a complete but simple example:

require 'rake'

a = 'file1.txt'
b = 'file2.txt'
file [a, b] do
   `touch #{a}`
   `touch #{b}`
end

task :all => [a, b]

Although Rake excepts this syntax, it doesn't do what I'd expect.  It  
gives me the surprising answer that it doesn't know how to build  
file1.txt even though it really should know.   I realize I could copy  
the block or define a function for it and use multiple file  
dependency declarations but this seems really clumsy and not very  
DRY.  Also, while such a workaround appears to work on my platform  
there isn't any reason to believe that it shouldn't call those blocks  
twice.  The fact that it doesn't makes me think Rake is checking file  
creation too often, i.e., before it could reasonably expect a file  
exists.  Am I correct about all this?

Joe

Lars Christensen | 14 Sep 11:31

[PATCH] File class documentation hidden by ftools.rb

Hello,

"ri File" gives the documentation from lib/ftools.rb and not the intended 
description of the File class.

ftools.rb has a declaration of the File class, which I suppose is not 
needed, so I removed it (attached patch). This fixes the documentation 
issues.

All 1.8 branches are affected. trunk is not (ftools.rb was removed).

Regards,
Lars
Attachment (ftools-rdoc.patch): application/octet-stream, 318 bytes
肖一方 | 7 Aug 10:17

Re: Welcome to our (ruby-doc ML) You are added automatically



2008/8/7 <ruby-doc-admin <at> ruby-lang.org>
Caution: If you reply this mail, the recipient is mailing list!
post articles   <ruby-doc <at> ruby-lang.org>
commands        <ruby-doc-ctl <at> ruby-lang.org>
maintainer      <ruby-doc-admin <at> ruby-lang.org>

Welcome to our mailing list <ruby-doc <at> ruby-lang.org> !

This mail contains the fundamental usage of the mailing list server.

1       How to use this server

Please send commands in the mail body not subject to the address
<ruby-doc-ctl <at> ruby-lang.org>.

The command syntax is as follows:

       help

       mget last:10 mp

Please send the "help" to the address <ruby-doc-ctl <at> ruby-lang.org> for help and
server functions overview

       help

to get general information on this list

       guide

If you want to make a contact with the mailing list maintainer, please
e-mail to

       ruby-doc-admin <at> ruby-lang.org

ML server exists to decrease routine works by maintainers. Please try
to use server functions as could as possible.

                               ruby-doc <at> ruby-lang.org Maintainer
                               ruby-doc-admin <at> ruby-lang.org



Plain Wu | 14 Jul 06:03
Favicon

unscribe

unscribe

zuo peng | 11 Jul 16:49

Re: unsubscribe

unsubscribe

anselm | 10 Jul 21:54

Re: unsubscribe

Sorry,

I am out of the office until Tuesday 15th of July.

For any requests relating to Netuxo work or support, please contact support <at> netuxo.co.uk

Best,
Anselm Heaton

--

-- 
------------------------------
Netuxo Ltd
a workers' co-operative
providing low-cost IT solutions
for peace, environmental and social justice groups
and the radical NGO sector

Registered as a company in England and Wales. No 4798478
Registered office: Unit 31, Daro Works, 80-84 Wallis Road, E9 5LW, Britain
------------------------------
email office <at> netuxo.co.uk
http://www.netuxo.co.uk
------------------------------

jieer_lee | 9 Jul 03:53
Favicon

来自jieer_lee的邮件

unsubscribe
anselm | 7 Jul 11:21

Re: un

Sorry,

I am out of the office until Tuesday 15th of July.

For any requests relating to Netuxo work or support, please contact support <at> netuxo.co.uk

Best,
Anselm Heaton

--

-- 
------------------------------
Netuxo Ltd
a workers' co-operative
providing low-cost IT solutions
for peace, environmental and social justice groups
and the radical NGO sector

Registered as a company in England and Wales. No 4798478
Registered office: Unit 31, Daro Works, 80-84 Wallis Road, E9 5LW, Britain
------------------------------
email office <at> netuxo.co.uk
http://www.netuxo.co.uk
------------------------------

anselm | 7 Jul 11:21

Re: un

Sorry,

I am out of the office until Tuesday 15th of July.

For any requests relating to Netuxo work or support, please contact support <at> netuxo.co.uk

Best,
Anselm Heaton

--

-- 
------------------------------
Netuxo Ltd
a workers' co-operative
providing low-cost IT solutions
for peace, environmental and social justice groups
and the radical NGO sector

Registered as a company in England and Wales. No 4798478
Registered office: Unit 31, Daro Works, 80-84 Wallis Road, E9 5LW, Britain
------------------------------
email office <at> netuxo.co.uk
http://www.netuxo.co.uk
------------------------------


Gmane