Skip Menu |

This queue is for tickets about the Tie-File CPAN distribution.

Report information
The Basics
Id: 2276
Status: resolved
Priority: 0/
Queue: Tie-File

People
Owner: Nobody in particular
Requestors:
Cc:
AdminCc:

Bug Information
Severity: Wishlist
Broken in: 0.93
Fixed in: (no value)



Subject: POD typo in Tie-File-0.93
From the synopsis: $array[13] = 'blah'; # line 13 of the file is now 'blah' print $array[42]; # display line 42 of the file Shouldn't it be: $array[13] = 'blah'; # line 14 of the file is now 'blah' print $array[42]; # display line 43 of the file Rgds, Gunnar Hjalmarsson Email: http://www.gunnar.cc/cgi-bin/contact.pl
To: bug-Tie-File [...] rt.cpan.org
CC: mjd [...] plover.com
Subject: Re: [cpan #2276] POD typo in Tie-File-0.93
Date: Sun, 23 Mar 2003 18:50:45 -0500
From: Mark Jason Dominus <mjd [...] plover.com>
RT-Send-Cc:
Show quoted text
> > This message about Tie-File was sent to you by guest <> via rt.cpan.org > > Full context and any attached attachments can be found at: > <URL: https://rt.cpan.org/Ticket/Display.html?id=2276 > >
> >From the synopsis:
> > $array[13] = 'blah'; # line 13 of the file is now 'blah' > print $array[42]; # display line 42 of the file > > Shouldn't it be: > > $array[13] = 'blah'; # line 14 of the file is now 'blah' > print $array[42]; # display line 43 of the file
I guess it depends on whether you think the first line of the file is line 0 or line 1.
From: Gunnar Hjalmarsson
[mjd@plover.com - Sun Mar 23 18:50:36 2003]: Show quoted text
> I guess it depends on whether you think the first line of the file is > line 0 or line 1.
Yes, of course. And to me, in plain English (or in my case Swedish...), the first line of something is line # 1. Maybe it's just me... ;-) I admit that if you are somewhat familiar with Perl arrays, you still realize what the message is.
To: bug-Tie-File [...] rt.cpan.org
CC: mjd [...] plover.com
Subject: Re: [cpan #2276] POD typo in Tie-File-0.93
Date: Fri, 04 Apr 2003 10:45:50 -0500
From: Mark Jason Dominus <mjd [...] plover.com>
RT-Send-Cc:
Show quoted text
> [mjd@plover.com - Sun Mar 23 18:50:36 2003]:
> > I guess it depends on whether you think the first line of the file is > > line 0 or line 1.
> > Yes, of course. And to me, in plain English (or in my case Swedish...), > the first line of something is line # 1. Maybe it's just me... ;-)
You will note that the documentation does not say "display 42nd line of the file". It says "Display line 42 of the file". This was not an accident. The 42nd line of the file is line 41, just as the first line of the file is line 0 and the third line of the file is line 2. Of course, one could argue on philological grounds that "third" must necessarily mean "item #3", regardless of where the numbering starts. But this is undesirable. It would introduce a discontinuity between the cardinal and the ordinal numerals in cases where items are numbered starting with 0, as is common in computer applications, because the ordinal numerals 'first' and 'second' are *not* derived from the cardinal numbers 'one' and 'two'. The first ('principal') item would be #0, the second ('following') item would be #1, and then the third ('number three') item would be #3. Then you would have no way to refer to item #2. If for some reason the iterms were numbered starting with -57, the problem would be even bigger since then there would be no word for items -55 through 2. In any case, it doesn't seem clear that making the change you suggested would lead to a net decrease of confusion in people reading the manual, so I think I probably won't do it. Best regards, -D.