Including simplelib in a Project - Revision history

Ximan: /* Version */

2011-01-03T23:42:09Z

‎Version

2010-12-01T00:33:47Z

‎A Note on the Object Model

2010-12-01T00:33:07Z

‎A Note on the Object Model

2010-12-01T00:31:47Z

‎Case of Member Names

2010-12-01T00:29:38Z

‎Intermediary Library Authors

2010-12-01T00:05:16Z

2010-12-01T00:03:04Z

‎Version

2010-11-30T23:51:15Z

‎Version

2010-11-30T23:50:59Z

‎Version

2010-11-30T23:50:27Z

‎Version

@@ Line 13: / Line 13: @@
    local v = sl.slversion()
-Version will always be a monotonically increasing real number. Current version is 0.05 as of 20101124.
+Version will always be a monotonically increasing real number. Current version is 0.07 as of 20110103.
 == Case of Member Names ==

@@ Line 32: / Line 32: @@
 See [http://www.lua.org/pil/16.4.html Programming in Lua -- Private Objects] to understand the employed object model. Objects are implemented as [http://en.wikipedia.org/wiki/Closure_%28computer_science%29 closures], so the colon calling syntax typically seen in object oriented lua code '''e.g. object:method()''' is ''never'' valid to use with simplelib objects or tables.  Just use the dot operator, '''e.g. object.method()'''.  This applies to the object returned by the initial dofile call, as well.
-Further, private metatables are set on all interfaces to deny any accidental deletion and overwriting and to raise errors if invocation is attempted on non-existent (or misspelled) methods.  For this reason bulk importation of the library names into the [[_G]] environment is discouraged as control and capture of logical errors is diminished and case and partial name matching aren't available.
+Further, private metatables are set on all interfaces to deny any accidental deletion and overwriting and to raise errors if invocation is attempted on non-existent (or misspelled) methods.  For this reason bulk importation of the library names into the [[_G]] environment is discouraged as capture of logical errors is diminished and case and partial name matching aren't available.
 == Intermediary Library Authors ==

@@ Line 32: / Line 32: @@
 See [http://www.lua.org/pil/16.4.html Programming in Lua -- Private Objects] to understand the employed object model. Objects are implemented as [http://en.wikipedia.org/wiki/Closure_%28computer_science%29 closures], so the colon calling syntax typically seen in object oriented lua code '''e.g. object:method()''' is ''never'' valid to use with simplelib objects or tables.  Just use the dot operator, '''e.g. object.method()'''.  This applies to the object returned by the initial dofile call, as well.
-Further, private metatables are set on all interfaces to deny any accidental deletion and overwriting and to raise errors if invocation is attempted on non-existent (or misspelled) methods.  For this reason bulk importation of the library names into the [[_G]] environment is discouraged as control and capture of logical errors is diminished.
+Further, private metatables are set on all interfaces to deny any accidental deletion and overwriting and to raise errors if invocation is attempted on non-existent (or misspelled) methods.  For this reason bulk importation of the library names into the [[_G]] environment is discouraged as control and capture of logical errors is diminished and case and partial name matching aren't available.
 == Intermediary Library Authors ==

@@ Line 26: / Line 26: @@
    --> true
-This matching feature is incorporated to enable user to choose the case of member names as desired; it shouldn't be used to obfuscate code.
+This matching feature is incorporated to enable user to choose the case of member names as desired; it shouldn't be used to [http://en.wikipedia.org/wiki/Obfuscated_code obfuscate code].
 == A Note on the Object Model ==

@@ Line 36: / Line 36: @@
 == Intermediary Library Authors ==
-Calling dofile() on simplelib.lua multiple times is unnecessary but will cause no harm unless the global environment guard variable [[simple_lib_soliton__]] is overwritten. That's the only value/variable defined by simplelib in [[_G]] (or other calling environment) by default.  Calling [[simple_lib_soliton__]] returns the unique interface table of simplelib, it can otherwise be ignored.
+Calling dofile() on simplelib.lua multiple times is unnecessary but will cause no harm unless the global environment guard variable [[simple_lib_soliton__]] is overwritten. That's the only value/variable defined by simplelib in [[_G]] (the global environment) by default.  Calling [[simple_lib_soliton__]] returns the unique interface table of simplelib, it can otherwise be ignored as it serves no direct purpose to the end user.
 == See Also ==

← Older revision		Revision as of 00:05, 1 December 2010
Line 14:		Line 14:

	Version will always be a monotonically increasing real number. Current version is 0.05 as of 20101124.		Version will always be a monotonically increasing real number. Current version is 0.05 as of 20101124.
		+
		+	== Case of Member Names ==

	In version 0.06, a pattern matching metamethod is incorporated which allows any partial, unique specification of a library member name to call the correct method. Additionally, while the default case of all methods is lower case, any case specified will match properly. E.g.,		In version 0.06, a pattern matching metamethod is incorporated which allows any partial, unique specification of a library member name to call the correct method. Additionally, while the default case of all methods is lower case, any case specified will match properly. E.g.,

@@ Line 19: / Line 19: @@
    local v1 = sl.SLVers()
    local v2 = sl.slVersion()
-   local v3 = sl.ioN()
+   local v3 = sl.ioN() -- pretty obtuse, but a unique pattern match
    print(tostring(v1 == v2 and v2 == v3))
    --> true
 == A Note on the Object Model ==

@@ Line 15: / Line 15: @@
 Version will always be a monotonically increasing real number. Current version is 0.05 as of 20101124.
-In version 0.06, a pattern matching metamethod is incorporated which allows any partial, unique specification of a member name to call the correct method.  Additionally, while the default case of all methods is lower case, any case specified will match properly.  E.g.,
+In version 0.06, a pattern matching metamethod is incorporated which allows any partial, unique specification of a library member name to call the correct method.  Additionally, while the default case of all methods is lower case, any case specified will match properly.  E.g.,
    local v1 = sl.SLVers()

← Older revision		Revision as of 23:50, 30 November 2010
Line 14:		Line 14:

	Version will always be a monotonically increasing real number. Current version is 0.05 as of 20101124.		Version will always be a monotonically increasing real number. Current version is 0.05 as of 20101124.
		+
		+	In version 0.06, a pattern matching metamethod is incorporated which allows any partial, unique specification of a member name to call the correct method. Additionally, while the default case of all methods is lower case, any case specified will match properly. E.g.,
		+
		+	local v1 = sl.SLVers()
		+	local v2 = sl.slVersion()
		+	local v3 = sl.sioN()
		+	print(tostring(v1 == v2 and v2 == v3))
		+
		+	--> true

	== A Note on the Object Model ==		== A Note on the Object Model ==