Page 1 of 1

Linked List documentation error

Posted: Wed Jan 03, 2007 7:30 pm
by Lewis
The comments in the example in http://www.purebasic.com/documentation/ ... ments.html do not appear to take into account that the first list element starts at index/position 0 (zero). In particular, the SelectElement(Numbers(), 3) and SelectElement(Numbers(), 9) calls retrieve respectively the 4th and 10th elements, not the 3rd and 9th as specified in the comments.

FWIW, I think it would be a good idea to have a "PureBasic Documentation" sub-forum where people can easily report back on the (many) documentation errors and suggest possible improvements, rewrites etc.

Posted: Wed Jan 03, 2007 7:41 pm
by Trond
FWIW, I think it would be a good idea to have a "PureBasic Documentation" sub-forum where people can easily report back on the (many) documentation errors and suggest possible improvements, rewrites etc.
I also think this is a good idea (probably a sub-forum to the bugs forum to not clutter things up?). Currently doc reports are getting in the way of real bugs, and the real bugs gets in the way of the doc reports.

Posted: Wed Jan 03, 2007 7:54 pm
by Comtois
it's fixed in the doc V4+

you can see it on PureArea.net

Posted: Thu Jan 04, 2007 1:10 am
by Lewis
Trond wrote:
FWIW, I think it would be a good idea to have a "PureBasic Documentation" sub-forum where people can easily report back on the (many) documentation errors and suggest possible improvements, rewrites etc.
I also think this is a good idea (probably a sub-forum to the bugs forum to not clutter things up?). Currently doc reports are getting in the way of real bugs, and the real bugs gets in the way of the doc reports.
Actually, I would suggest it be made the major sub-forum, placed at the very top of the forum index. Most programmers despise the task of documentation, yet consider it the most important part of a program they themselves are using in their work, particularly in the early stages of familiarizing oneself with the program. No, let us not tuck it away where people will quickly forget its existence (and importance).