- * String.raw is intended for use as a tag function of a Tagged Template String. When called\r
- * as such the first argument will be a well formed template call site object and the rest\r
- * parameter will contain the substitution values.\r
+ * String.raw is usually used as a tag function of a Tagged Template String. When called as\r
+ * such, the first argument will be a well formed template call site object and the rest\r
+ * parameter will contain the substitution values. It can also be called directly, for example,\r
+ * to interleave strings and values from your own tag function, and in this case the only thing\r
+ * it needs from the first argument is the raw property.\r