fix generated example

Author: braindigitalis

docpages/basic-language-reference/functions/string/SIGNS.md

@@ -13,28 +13,16 @@ The returned signature may be written to disk using \ref BINWRITE "BINWRITE" and
 ### Examples
 
 ```basic
-REM Sign a package
-
+REM First generate signature
 SIG$ = SIGN$("editor.gz", "packages.key")
-
+REM allocate memory for the signature as a raw buffer
+m = MEMALLOC(64)
 F = OPENOUT("editor.gz.sig")
-BINWRITE F, SIG$
-CLOSE #F
-```
-
-```basic
-REM Sign and immediately verify a package
-
-SIG$ = SIGN$("game.gz", "packages.key")
-
-F = OPENOUT("game.gz.sig")
-BINWRITE F, SIG$
-CLOSE #F
-
-IF VERIFY("game.gz", "game.gz.sig", "packages.pem") THEN
-{
-	PRINT "Signature valid"
-}
+REM Convert the string to a raw buffer
+n = STRINGTOBUFFER(SIG$, m, 64)
+REM write it to the file
+BINWRITE F, m, n
+CLOSE F
 ```
 
 ---
@@ -44,7 +32,7 @@ IF VERIFY("game.gz", "game.gz.sig", "packages.pem") THEN
 * `file$` is the file to sign.
 * `privatekey$` is a PEM private key file.
 * Returns an escaped detached Ed25519 signature string.
-* The returned string is safe to store using normal BASIC file functions.
+* The returned string should be converted to a binary buffer before storage.
 * Detached signatures are normally stored with a `.sig` extension.
 * Signatures generated by `SIGN$` may be verified using \ref VERIFY "VERIFY".
 

docs/SIGNS.html

@@ -129,33 +129,24 @@
 <hr  />
 <h3 class="doxsection"><a class="anchor" id="examples-152"></a>
 Examples</h3>
-<div class="fragment"><div class="line">REM Sign a package</div>
-<div class="line"> </div>
+<div class="fragment"><div class="line">REM First generate signature</div>
 <div class="line">SIG$ = SIGN$(&quot;editor.gz&quot;, &quot;packages.key&quot;)</div>
-<div class="line"> </div>
+<div class="line">REM allocate memory for the signature as a raw buffer</div>
+<div class="line">m = MEMALLOC(64)</div>
 <div class="line">F = OPENOUT(&quot;editor.gz.sig&quot;)</div>
-<div class="line">BINWRITE F, SIG$</div>
-<div class="line">CLOSE #F</div>
-</div><!-- fragment --><div class="fragment"><div class="line">REM Sign and immediately verify a package</div>
-<div class="line"> </div>
-<div class="line">SIG$ = SIGN$(&quot;game.gz&quot;, &quot;packages.key&quot;)</div>
-<div class="line"> </div>
-<div class="line">F = OPENOUT(&quot;game.gz.sig&quot;)</div>
-<div class="line">BINWRITE F, SIG$</div>
-<div class="line">CLOSE #F</div>
-<div class="line"> </div>
-<div class="line">IF VERIFY(&quot;game.gz&quot;, &quot;game.gz.sig&quot;, &quot;packages.pem&quot;) THEN</div>
-<div class="line">{</div>
-<div class="line">    PRINT &quot;Signature valid&quot;</div>
-<div class="line">}</div>
+<div class="line">REM Convert the string to a raw buffer</div>
+<div class="line">n = STRINGTOBUFFER(SIG$, m, 64)</div>
+<div class="line">REM write it to the file</div>
+<div class="line">BINWRITE F, m, n</div>
+<div class="line">CLOSE F</div>
 </div><!-- fragment --><hr  />
 <h3 class="doxsection"><a class="anchor" id="notes-149"></a>
 Notes</h3>
 <ul>
 <li><span class="tt">file$</span> is the file to sign.</li>
 <li><span class="tt">privatekey$</span> is a PEM private key file.</li>
 <li>Returns an escaped detached Ed25519 signature string.</li>
-<li>The returned string is safe to store using normal BASIC file functions.</li>
+<li>The returned string should be converted to a binary buffer before storage.</li>
 <li>Detached signatures are normally stored with a <span class="tt">.sig</span> extension.</li>
 <li>Signatures generated by <span class="tt">SIGN$</span> may be verified using <a class="el" href="VERIFY.html">VERIFY</a>.</li>
 </ul>