Merge pull request #157 from gesslar:update-file-resolution

Update-file-resolution

TODO/The parser has access to BeDoc's core lo.md

@@ -0,0 +1,35 @@
+The parser has access to BeDoc's core logging utilities through `this.log`.
+There are four logging functions available:
+
+- `this.log.debug(string[, ...arg])`: Debug messages
+  ```javascript
+  async parse(file, content) {
+    this.log.debug("This will only show in debug mode")
+  }
+
+  // [BeDoc] Debug: This will only show in debug mode
+  ```
+- `this.log.info(string[, ...arg])`: Informational messages
+  ```javascript
+  async parse(file, content) {
+    this.log.info("A wild Happy Fun Ball has appeared.")
+  }
+
+  // [BeDoc] Info: A wild Happy Fun Ball has appeared.
+  ```
+- `this.log.warn(string[, ...arg])`: Warning messages
+  ```javascript
+  async parse(file, content) {
+    this.log.warn("Do not taunt Happy Fun Ball.")
+  }
+
+  // [BeDoc] Warn: Do not taunt Happy Fun Ball.
+  ```
+- `this.log.error(string[, ...arg])`: Error messages
+  ```javascript
+  async parse(file, content) {
+    this.log.error("You have been eaten by Happy Fun Ball. 🙀")
+  }
+
+  // [BeDoc] Error: You have been eaten by Happy Fun Ball. 🙀
+  ```

examples/config-lpc-to-markdown.json

@@ -1,7 +1,10 @@
 {
   "language": "lpc",
   "format": "markdown",
-  "output": "output/",
-  "input": ["wip/sample/arrays.c", "wip/sample/base64.c"],
-  "hooks": "wip/wikitext-hooks.js"
+  "output": "output/markdown",
+  "input": [
+    "examples/source/lpc/arrays.c",
+    "examples/source/lpc/base64.c"
+  ],
+  "hooks": "examples/hooks/lpc-wikitext-hooks.js"
 }

examples/config-lpc-to-markdown.json5

@@ -0,0 +1,10 @@
+{
+  "language": "lpc",
+  "format": "markdown",
+  "output": "examples/output/markdown",
+  "input": [
+    "examples/source/lpc/arrays.c",
+    "examples/source/lpc/base64.c"
+  ],
+  "hooks": "examples/hooks/lpc-wikitext-hooks.js"
+}

examples/node_modules_test/bedoc-markdown-printer/bedoc-markdown-printer.js

@@ -15,10 +15,10 @@ export const actions = [
      * This is the action to print structured object to text.
      *
      * @param {object} module Data coming in from the printer
-     * @param {string} module.moduleName The module name (base name) of the
-     *  file
+     * @param {object} module.file The file object representing the file
+     * being currently being processed
      * @param {object[]} module.moduleContent An array of objects containing
-     *  function definitions.
+     *  function definitions prepared by the parser.
      * @returns {Promise<object>} The result of the print operations.
      */
     async run(module) {