Clean up code and improve documentation

This switches the code documentation genarator (we're now using phpdoc
instead of NaturalDoc).

Also various small code cleanup tasks:

- Remove unused code
- Get rid of `and` / `or`, we're using `&&` / `||` now
- Adding missing return values
- Helping PhpStorm to detect some dynamically called functions
  (mark_builtin_callable in Transcompiler)
- Reword transcompiling => compiling in documentation

1 files changed, 7 insertions, 1 deletions

diff --git a/src/ste/ParseCompileError.php b/src/ste/ParseCompileError.php
index f5f0272..29590da 100644
--- a/src/ste/ParseCompileError.php
+++ b/src/ste/ParseCompileError.php
@@ -2,6 +2,9 @@
 
 namespace kch42\ste;
 
+/**
+ * An exception thrown by the parser or compiler
+ */
 class ParseCompileError extends \Exception
 {
     public $msg;
@@ -16,10 +19,13 @@ class ParseCompileError extends \Exception
         $this->message = "$msg (Template $tpl, Offset $offset)";
     }
 
+    /**
+     * Update the message to include a human readable offset.
+     * @param string $code
+     */
     public function rewrite($code)
     {
         $line = substr_count(str_replace("\r\n", "\n", substr($code, 0, $this->off)), "\n") + 1;
         $this->message = "{$this->msg} (Template {$this->tpl}, Line $line)";
-        $this->is_rewritten = true;
     }
 }