[Date Prev][Date Next][Thread Prev][Thread Next]
[Date Index]
[Thread Index]
- Subject: RE: file:read("*n") reference manual entry improvement
- From: Thijs Schreijer <thijs@...>
- Date: Fri, 25 Oct 2013 09:20:37 +0000
> -----Original Message-----
> From: lua-l-bounces@lists.lua.org [mailto:lua-l-bounces@lists.lua.org] On
> Behalf Of Paul Merrell
> Sent: vrijdag 25 oktober 2013 11:17
> To: Lua mailing list
> Subject: Re: file:read("*n") reference manual entry improvement
>
> 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
>
+1 ... again :)