Re: [ANN] An extended Lua FAQ

[Peter Odding <peter@...>]

steve donovan wrote:
> Patrick Donnelly wrote:
> > Perhaps I missed it somewhere, but how do we contribute?
>
> (1) edit the markdown source and post diffs against it
> (2) just post items in markdown format for us to discuss
> (3) Put comments here:
>
> http://lua-users.org/wiki/UnofficialFaqDiscussion

I found two places in the FAQ HTML document where Markdown changed the 
input '\' (a single-quoted backslash) into '' (empty single-quotes), 
which makes the affected paragraphs in the FAQ rather confusing. I don't 
know which Markdown code you're using, but [1] gives me the same output 
based on FAQ.md in [2], and changing the input to '\\' gives the correct 
output. I also added some missing dots to end sentences. Please see the 
attached diff.

 - Peter

[1] http://www.frykholm.se/files/markdown.lua
[2] http://penlight.luaforge.net/FAQ/faq.zip

284c284
< The usual operators can be overloaded using [metamethods](http://lua-users.org/wiki/MetamethodsTutorial) If an object (either a Lua table or C userdata) has a metatable then we can control the meaning of the arithmetic operators (like + - * / ^),
---
> The usual operators can be overloaded using [metamethods](http://lua-users.org/wiki/MetamethodsTutorial). If an object (either a Lua table or C userdata) has a metatable then we can control the meaning of the arithmetic operators (like + - * / ^),
486c486
< Some method names are special, like `__tostring` (["metamethods"](http://www.lua.org/manual/5.1/manual.html#2.8)) Defining this function controls how our objects are represented as strings.
---
> Some method names are special, like `__tostring` (["metamethods"](http://www.lua.org/manual/5.1/manual.html#2.8)). Defining this function controls how our objects are represented as strings.
795c795
< Naturally! But see if you really cannot do the task with Lua's built-in _string patterns_. Although simpler than traditional regular expressions, they are powerful enough for most tasks. In most cases, you can understand a Lua string pattern by mentally replacing '%' with '\'; the advantage of % of course is that it does not itself need escaping in C-style strings such as Lua uses.
---
> Naturally! But see if you really cannot do the task with Lua's built-in _string patterns_. Although simpler than traditional regular expressions, they are powerful enough for most tasks. In most cases, you can understand a Lua string pattern by mentally replacing '%' with '\\'; the advantage of % of course is that it does not itself need escaping in C-style strings such as Lua uses.
1058c1058
< If you prefer a higher-level library that harnesses LuaFileSystem, then look at Penlight's [pl.path](http://penlight.luaforge.net/api/modules/pl.path.html) module. This is modelled after Python's `os.path` module, and makes it easier to do cross-platform coding (e.g. using `path.join` instead of explicitly stringing paths together with '/' or '\')
---
> If you prefer a higher-level library that harnesses LuaFileSystem, then look at Penlight's [pl.path](http://penlight.luaforge.net/api/modules/pl.path.html) module. This is modelled after Python's `os.path` module, and makes it easier to do cross-platform coding (e.g. using `path.join` instead of explicitly stringing paths together with '/' or '\\')
1208c1208
< A good place to start is the [Libraries and Bindings](http://lua-users.org/wiki/LibrariesAndBindings) page at the [Lua Wiki](http://lua-users.org/wiki) It's not a complete list, but a good start.  [LuaForge](http://luaforge.net) is the community repository of Lua libraries and hosts most of the good ones. A useful list of the most popular modules is available [here](http://luaforge.net/top/mostactive.php).
---
> A good place to start is the [Libraries and Bindings](http://lua-users.org/wiki/LibrariesAndBindings) page at the [Lua Wiki](http://lua-users.org/wiki). It's not a complete list, but a good start.  [LuaForge](http://luaforge.net) is the community repository of Lua libraries and hosts most of the good ones. A useful list of the most popular modules is available [here](http://luaforge.net/top/mostactive.php).