cleanup, docs

site/doc/pages/mysql_error.txt

@@ -14,4 +14,11 @@ Returns the last error message associated with the given MySQL connection.
 If there is no current error, the result is an empty string.
 
 :example
-print("mysql_error is resource-bound; configure the service or connection, then call it in request code.\n");
+MySQL* db = mysql_connect();
+if(db != 0)
+{
+    mysql_query(db, "select * from no_such_table_xyz");
+    print(mysql_error(db) != "" ? "error reported" : "no error", "\n");
+    mysql_disconnect(db);
+}
+else print("(requires a reachable MySQL server)\n");