Re: file:read("*n") reference manual entry improvement

[Paul Merrell <marbux@...>]

On Fri, Oct 25, 2013 at 1:28 AM, Roberto Ierusalimschy
<roberto@inf.puc-rio.br> wrote:

> Anyway, it seems we both agree the C documentation is quite convoluted
> about this topic.  So, the question remains whether it is worth trying
> to explain something similar in the Lua manual, versus leaving it open
> to the user's imagination or own tests...

I'll revive my suggestion from about a year ago that we aim to create
a web version of the manual that can be user-annotated, for example,
one numbered section per web page with the ability to add comments.
That would allow us to deal with such issues, link to relevant pages
on the wiki, add detail for those new to Lua, etc.

Best regards,

Paul



-- 
[Notice not included in the above original message:  The U.S. National
Security Agency neither confirms nor denies that it intercepted this
message.]