SourceMod 1.7.0 Release Notes - Revision history

Psychonic at 23:52, 4 February 2015

2015-02-04T23:52:22Z

Psychonic: /* User Changes */

2015-02-04T22:50:30Z

‎User Changes

BAILOPAN: /* Developer Notes */

2015-02-04T00:29:03Z

‎Developer Notes

BAILOPAN: /* Developer Notes */

2015-02-04T00:25:39Z

‎Developer Notes

BAILOPAN: /* Developer Notes */

2015-02-04T00:25:24Z

‎Developer Notes

BAILOPAN at 00:17, 4 February 2015

2015-02-04T00:17:00Z

BAILOPAN: /* Developer Notes */

2015-02-04T00:16:43Z

‎Developer Notes

BAILOPAN: /* Developer Notes */

2015-02-04T00:14:47Z

‎Developer Notes

BAILOPAN: /* Developer Notes */

2015-02-04T00:13:45Z

‎Developer Notes

BAILOPAN: /* Developer Notes */

2015-02-04T00:12:37Z

‎Developer Notes

← Older revision		Revision as of 23:52, 4 February 2015
Line 1:		Line 1:
−	~~''This page is still a work-in-progress, incomplete and barely edited, as SourceMod 1.7 has not been released yet''~~
−
	=Overview=		=Overview=

@@ Line 18: / Line 18: @@
 ** Command targeting now supports both Steam3 auth IDs in addition to Steam2 IDs.
 * Added default timeout for MySQL connections to avoid hangs. ({{pr|248}}).
 * SDKTools' gamerules gamedata is now far less likely to break on updates ({{pr|220}}).
 * Fixed crash with sm_dump_admcache on Windows ({{pr|163}}).

@@ Line 66: / Line 66: @@
 # '''Coercing function types is now a warning.''' For example, passing a <tt>Function</tt>-tagged value to <tt>any</tt>, and then returning it as an <tt>int</tt>. The ability to coerce function types to plain values is a serious impediment to future improvements to SourcePawn. It is now a warning, and will be an error in a future version of SourcePawn.
 # '''Multiple tag support has been removed.''' Previously, it was possible to specify multiple tags on an argument. For example, <tt>{Float,bool}:param</tt>. This syntax is no longer available.
 # '''<tt>sizeof</tt> can no longer be used on indeterminate arrays.''' Previously, <tt>sizeof</tt> on an indeterminate array (an array whose size is not statically known) was a warning. It is now an error.

@@ Line 68: / Line 68: @@
 # '''Multiple tag support has been removed.''' Previously, it was possible to specify multiple tags on an argument. For example, <tt>{Float,bool}:param</tt>. This syntax is no longer available.
 # '''<tt>sizeof</tt> can no longer be used on indeterminate arrays.''' Previously, <tt>sizeof</tt> on an indeterminate array (an array whose size is not statically known) was a warning. It is now an error.
-# '''New keywords'''. We have taken the opportunity to reserve a number of keywords for future versions of SourcePawn. They don't do anything, and they have no semantics. They are only reserved now to mitigate any potential problems if we do need them in the future. They are: <tt>acquire</tt>, <tt>as</tt>, <tt>builtin</tt>, <tt>catch</tt>, <tt>cast_to</tt>, <tt>double</tt>, <tt>explicit</tt>, <tt>finally</tt>, <tt>foreach</tt>, <tt>implicit</tt>, <tt>import</tt>, <tt>in</tt>, <tt>int8</tt>, <tt>int16</tt>, <tt>int32</tt>, <tt>int64</tt>, <tt>intn</tt>, <tt>let</tt>, <tt>namespace</tt>, <tt>object</tt>, <tt>package</tt>, <tt>private</tt>, <tt>protected</tt>, <tt>readonly</tt>, <tt>sealed</tt>, <tt>throw</tt>, <tt>try</tt>, <tt>typeof</tt>, <tt>uint8</tt>, <tt>uint16</tt>, <tt>uint32</tt>, <tt>uint64</tt>, <tt>uintn</tt>, <tt>union</tt>, <tt>var</tt>, <tt>variant</tt>, <tt>volatile</tt>, <tt>with</tt>.
+# '''Reserved keywords'''. We have taken the opportunity to reserve a number of keywords for future versions of SourcePawn. They don't do anything, and they have no semantics. They are only reserved now to mitigate any potential problems if we do need them in the future. They are: <tt>acquire</tt>, <tt>as</tt>, <tt>builtin</tt>, <tt>catch</tt>, <tt>cast_to</tt>, <tt>double</tt>, <tt>explicit</tt>, <tt>finally</tt>, <tt>foreach</tt>, <tt>implicit</tt>, <tt>import</tt>, <tt>in</tt>, <tt>int8</tt>, <tt>int16</tt>, <tt>int32</tt>, <tt>int64</tt>, <tt>intn</tt>, <tt>let</tt>, <tt>namespace</tt>, <tt>object</tt>, <tt>package</tt>, <tt>private</tt>, <tt>protected</tt>, <tt>readonly</tt>, <tt>sealed</tt>, <tt>throw</tt>, <tt>try</tt>, <tt>typeof</tt>, <tt>uint8</tt>, <tt>uint16</tt>, <tt>uint32</tt>, <tt>uint64</tt>, <tt>uintn</tt>, <tt>union</tt>, <tt>var</tt>, <tt>variant</tt>, <tt>volatile</tt>, <tt>with</tt>.
 # '''<tt>sizeof</tt> no longer has magic meaning as a default argument expression.''' Previously, <tt>sizeof</tt> as a default argument expression would bind to the variable at its callsite, rather than the argument in parameter scope. This allowed users to create functions that did not seem to require an explicit size parameter alongside an array. This feature was buggy, so it has been removed, alongside similar magic binding for <tt>tagof</tt> and <tt>cellsof</tt> in default argument expressions.
 # '''<tt>String[]</tt> and <tt>any</tt> no longer coerce'''. Previously, it was possible to coerce a character array to an <tt>any</tt> array, or vice-versa. This cast was unsafe because the storage widths of each array value are different (one normal array is four bytes per slot, and a character is one byte per slot). This coercion is now illegal.

@@ Line 68: / Line 68: @@
 # '''Multiple tag support has been removed.''' Previously, it was possible to specify multiple tags on an argument. For example, <tt>{Float,bool}:param</tt>. This syntax is no longer available.
 # '''<tt>sizeof</tt> can no longer be used on indeterminate arrays.''' Previously, <tt>sizeof</tt> on an indeterminate array (an array whose size is not statically known) was a warning. It is now an error.
 # '''<tt>sizeof</tt> no longer has magic meaning as a default argument expression.''' Previously, <tt>sizeof</tt> as a default argument expression would bind to the variable at its callsite, rather than the argument in parameter scope. This allowed users to create functions that did not seem to require an explicit size parameter alongside an array. This feature was buggy, so it has been removed, alongside similar magic binding for <tt>tagof</tt> and <tt>cellsof</tt> in default argument expressions.
 # '''<tt>String[]</tt> and <tt>any</tt> no longer coerce'''. Previously, it was possible to coerce a character array to an <tt>any</tt> array, or vice-versa. This cast was unsafe because the storage widths of each array value are different (one normal array is four bytes per slot, and a character is one byte per slot). This coercion is now illegal.

@@ Line 58: / Line 58: @@
 If you want a very brief takeaway, here are the four new features to keep in mind:
-# Declarations can now be written like in C# or Java. This is the new preferred syntax and will allow us to improve the language faster in the future.
+# Declarations can now be written like in C# or Java. This is the new preferred syntax and will allow us to improve the language faster in the future. In newer declarations, <tt>String</tt> is renamed to <tt>char</tt> and <tt>Float</tt> is renamed to <tt>float</tt>.
 # Instead of <tt>INVALID_HANDLE</tt>, there is a new <tt>null</tt> keyword.
 # Instead of explicit tags, there is now a <tt>view_as&lt;Tag&gt;</tt> expression that is preferred.

@@ Line 57: / Line 57: @@
 The biggest change for developers in SourceMod 1.7 is the new [[SourcePawn Transitional Syntax]], which adds some object-oriented capabilities to our API. The documentation on the transitional syntax has a comprehensive specification for all the changes, including examples.
-The most important changes developers should note are:
+If you want a very brief takeaway, here are the four new features to keep in mind:
 # Always prefer new-style declarations - it's the recommended syntax going forward and will allow us to improve the language faster.
 # Instead of <tt>INVALID_HANDLE</tt>, there is a new <tt>null</tt> keyword.