From: divverent <divverent@d7cf8633-e32d-0410-b094-e92efae38249>
Date: Sat, 8 Mar 2014 17:57:10 +0000 (+0000)
Subject: Clarify what sprintf does on %1$s %s
X-Git-Tag: xonotic-v0.8.0~79
X-Git-Url: https://git.rm.cloudns.org/?a=commitdiff_plain;h=419790e40ad97002ae1be11359bdf9093f9ba9e5;p=xonotic%2Fdarkplaces.git

Clarify what sprintf does on %1$s %s

git-svn-id: svn://svn.icculus.org/twilight/trunk/darkplaces@12056 d7cf8633-e32d-0410-b094-e92efae38249
::stable-branch::merge=217d39f7bcfcbbacdc090dd43c624e3d6aa43ce6
---

diff --git a/dpdefs/csprogsdefs.qc b/dpdefs/csprogsdefs.qc
index 7e173f04..1dc73a14 100644
--- a/dpdefs/csprogsdefs.qc
+++ b/dpdefs/csprogsdefs.qc
@@ -978,10 +978,10 @@ string(string format, ...) sprintf = #627;
 //you know sprintf :P
 //supported stuff:
 //  %
-//  optional: <argpos>$ for the argument to format
+//  optional: <argpos>$ for the argument to format (the arg counter then is not increased)
 //  flags: #0- +
-//  optional: <width>, *, or *<argpos>$ for the field width
-//  optional: .<precision>, .*, or .*<argpos>$ for the precision
+//  optional: <width>, *, or *<argpos>$ for the field width (width is read before value and precision)
+//  optional: .<precision>, .*, or .*<argpos>$ for the precision (precision is read before value)
 //  length modifiers: h for forcing a float, l for forcing an int/entity (by default, %d etc. cast a float to int)
 //  conversions:
 //    d takes a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to an int
diff --git a/dpdefs/dpextensions.qc b/dpdefs/dpextensions.qc
index dfd260bf..652bb0cc 100644
--- a/dpdefs/dpextensions.qc
+++ b/dpdefs/dpextensions.qc
@@ -1022,10 +1022,10 @@ string(string format, ...) sprintf = #627;
 //you know sprintf :P
 //supported stuff:
 //  %
-//  optional: <argpos>$ for the argument to format
+//  optional: <argpos>$ for the argument to format (the arg counter then is not increased)
 //  flags: #0- +
-//  optional: <width>, *, or *<argpos>$ for the field width
-//  optional: .<precision>, .*, or .*<argpos>$ for the precision
+//  optional: <width>, *, or *<argpos>$ for the field width (width is read before value and precision)
+//  optional: .<precision>, .*, or .*<argpos>$ for the precision (precision is read before value)
 //  length modifiers: h for forcing a float, l for forcing an int/entity (by default, %d etc. cast a float to int)
 //  conversions:
 //    d takes a float if no length is specified or h is, and an int/entity if l is specified as length, and cast it to an int