The biggest thing is that the documentation doesn't answer the question that is the subject of this email thread: why would one want to use lua?
It also doesn't show up in the manual at all, it shows up in a separate section entitled "Lua parser." That section seems to assume that we already know the lua language, and thus appears to be intended for "other people" than an ordinary person wanting to know how to use tup. It contains no introduction to the lua language, and defines things in terms of how tup differs from "standard lua." It has a listing of functions with little explanation of why you would use the, and it turns out to not be a complete listing anyhow. e.g. there is apparently a run-script function. The examples page is better, if one somehow decides that lua is relevant in spite of the "Lua parser" page. However, it still doesn't answer the question of "why lua"? Glancing through the examples, it appears to be no more than a clumsy syntax for doing the same thing the ordinary Tupfile can do. So the two things that are lacking are: 1. Explanation of why one would care. (Which I still haven't learned, except perhaps for portability to lame systems like windows. But since my projects use python, that's not really an issue, unless there is some way to *find* an installed python that is not in the path using lua.) 2. An introduction to how to use the Tupfile.lua format effectively. This overlaps with the former lack, since effectively should mean in a way that works better than the Tupfile format, or is more elegant. David On Monday, November 10, 2014 7:07:11 PM UTC-8, Rendaw wrote: > > On 11/11/2014 09:04 AM, David Roundy wrote: > > However, the biggest problem with the lua mode is the lack of > > documentation. > Would you please elaborate on where you feel the Lua documentation is > lacking? I'd like to improve it, and input from someone who has some > distance from the software would be greatly appreciated. > -- -- tup-users mailing list email: [email protected] unsubscribe: [email protected] options: http://groups.google.com/group/tup-users?hl=en --- You received this message because you are subscribed to the Google Groups "tup-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
