A quick sweep for missing or inaccurate code comments

core/modules/commands/dump.js

@@ -3,7 +3,7 @@ title: $:/core/modules/commands/dump.js
 type: application/javascript
 module-type: command
 
-Dump command
+Dump command for inspecting TiddlyWiki internals
 
 \*/
 (function(){

core/modules/commands/load.js

@@ -3,7 +3,7 @@ title: $:/core/modules/commands/load.js
 type: application/javascript
 module-type: command
 
-Load tiddlers command
+Command to load tiddlers from a file
 
 \*/
 (function(){

core/modules/commands/savetiddler.js

@@ -3,7 +3,7 @@ title: $:/core/modules/commands/savetiddler.js
 type: application/javascript
 module-type: command
 
-Save tiddlers command
+Command to save a tiddler to a file
 
 \*/
 (function(){

core/modules/commands/server.js

@@ -3,20 +3,7 @@ title: $:/core/modules/commands/server.js
 type: application/javascript
 module-type: command
 
-Serve tiddlers over http. The server is very simple. At the root, it serves a rendering of a specified tiddler. Otherwise, it serves individual tiddlers encoded in JSON, and supports the basic HTTP operations for GET, PUT and DELETE.
-
-For example:
-
-	--server 8080 $:/core/tiddlywiki5.template.html text/plain text/html
-
-The parameters are:
-
-	--server <port> <roottiddler> <rendertype> <servetype>
-
-* ''port'' - port number to serve from (defaults to "8080")
-* ''roottiddler'' - the tiddler to serve at the root (defaults to "$:/core/tiddlywiki5.template.html") 
-* ''rendertype'' - the content type to which the root tiddler should be rendered (defaults to "text/plain")
-* ''servetype'' - the content type with which the root tiddler should be served (defaults to "text/html")
+Serve tiddlers over http
 
 \*/
 (function(){

core/modules/macros/button.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/button.js
 type: application/javascript
 module-type: macro
 
+Button macro
+
 \*/
 (function(){
 

core/modules/macros/chooser.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/chooser.js
 type: application/javascript
 module-type: macro
 
+Zooming chooser macro
+
 \*/
 (function(){
 

core/modules/macros/download.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/download.js
 type: application/javascript
 module-type: macro
 
+Download macro
+
 \*/
 (function(){
 

core/modules/macros/echo.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/echo.js
 type: application/javascript
 module-type: macro
 
+Echo macro
+
 \*/
 (function(){
 

core/modules/macros/edit/edit.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/edit/edit.js
 type: application/javascript
 module-type: macro
 
+Edit macro for editting fields and tiddlers
+
 \*/
 (function(){
 

core/modules/macros/edit/editors/bitmapeditor.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/edit/editors/bitmapeditor.js
 type: application/javascript
 module-type: editor
 
+An editor plugin for editting bitmaps
+
 \*/
 (function(){
 

core/modules/macros/edit/editors/texteditor.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/edit/editors/texteditor.js
 type: application/javascript
 module-type: editor
 
+An editor plugin for editting text
+
 \*/
 (function(){
 

core/modules/macros/image.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/image.js
 type: application/javascript
 module-type: macro
 
+Image macro for displaying images
+
 \*/
 (function(){
 

core/modules/macros/include.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/include.js
 type: application/javascript
 module-type: macro
 
+Include macro
+
 \*/
 (function(){
 

core/modules/macros/list.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/list.js
 type: application/javascript
 module-type: macro
 
+List macro
+
 \*/
 (function(){
 

core/modules/macros/story/views/scroller.js

@@ -3,7 +3,7 @@ title: $:/core/modules/macros/story/views/scroller.js
 type: application/javascript
 module-type: storyview
 
-A storyview that shows a sequence of tiddlers and navigates by scrolling
+A storyview that shows a sequence of tiddlers and navigates by smoothly scrolling
 
 \*/
 (function(){

core/modules/macros/version.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/version.js
 type: application/javascript
 module-type: macro
 
+Version macro
+
 \*/
 (function(){
 

core/modules/macros/video.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/video.js
 type: application/javascript
 module-type: macro
 
+Video macro
+
 \*/
 (function(){
 

core/modules/macros/view.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/view.js
 type: application/javascript
 module-type: macro
 
+View macro
+
 \*/
 (function(){
 

core/modules/macros/zoomer.js

@@ -3,6 +3,8 @@ title: $:/core/modules/macros/zoomer.js
 type: application/javascript
 module-type: macro
 
+Zooming navigator macro
+
 \*/
 (function(){
 

core/modules/parsers/javascriptparser/javascriptparser.js

@@ -3,7 +3,7 @@ title: $:/core/modules/parsers/javascriptparser/javascriptparser.js
 type: application/javascript
 module-type: parser
 
-Parses a JSON object into a parse tree
+Parses a JavaScript program into a parse tree
 
 \*/
 (function(){

core/modules/parsers/plaintextparser.js

@@ -3,7 +3,7 @@ title: $:/core/modules/parsers/plaintextparser.js
 type: application/javascript
 module-type: parser
 
-Renders plain text tiddlers
+Parses plain text tiddlers
 
 \*/
 (function(){

core/modules/parsers/wikitextparser/rules/wikitextrules.js

@@ -3,6 +3,8 @@ title: $:/core/modules/parsers/wikitextparser/rules/wikitextrules.js
 type: application/javascript
 module-type: wikitextrule
 
+Rule modules for the wikitext parser
+
 \*/
 (function(){
 

core/modules/utils.js

@@ -5,8 +5,6 @@ module-type: utils
 
 Various static utility functions.
 
-This file is a bit of a dumping ground; the expectation is that most of these functions will be refactored.
-
 \*/
 (function(){
 

core/static.template.html.tid

@@ -7,9 +7,6 @@ type: text/x-tiddlywiki-html
 <meta name="application-name" content="TiddlyWiki" />
 <meta name="generator" content="TiddlyWiki" />
 <meta name="tiddlywiki-version" content="<<include "$:/core/version.txt" text/plain shadow:yes>>" />
-<meta name="viewport" content="width=device-width, initial-scale=1.0" />
-<meta name="apple-mobile-web-app-capable" content="yes" />
-<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
 <meta name="format-detection" content="telephone=no">
 <meta name="copyright" content="
 <<include "$:/core/copyright.txt" text/plain shadow:yes>>

tw5.com/tiddlers/CommandLineInterface.tid

@@ -2,35 +2,75 @@ title: CommandLineInterface
 modifier: JeremyRuston
 
 TiddlyWiki5 can be used on the command line to perform an extensive set of operations based on RecipeFiles, TiddlerFiles and TiddlyWikiFiles.
-
-!!Usage
-`
-node core/boot.js <options>
-`
-This boots the TiddlyWiki kernel and loads the core plugins. The wiki store is initially empty.
-
-The command line options are processed sequentially from left to right. Processing pauses during long operations and then resumes with the next command line option in sequence.
-
-The following options are available:
-|`--load <filepath>` |Load tiddlers from 2.x.x TiddlyWiki files (`.html`), `.tiddler`, `.tid`, `.json` or other files |
-|`--savetiddler <title> <filename> [<type>]` |Save an individual tiddler as a specified MIME type, defaults to `text/html` |
-|`--wikitest <dir> [save]` |Run wikification tests against the tiddlers in the given directory. Include the `save` flag to save the test result files as the new targets |
-|`--dump tiddlers` |Dump the titles of the tiddlers in the wiki store |
-|`--dump tiddler <title>` |Dump the fields of an individual tiddler |
-|`--dump shadows` |Dump the titles of the shadow tiddlers in the wiki store |
-|`--dump config` |Dump the current core configuration |
-|`--verbose` |Triggers verbose output, useful for debugging |
 !! Examples
 This example loads the tiddlers from a TiddlyWiki HTML file and then saves one of them in HTML:
 `
 node tiddlywiki.js --verbose --load mywiki.html --savetiddler ReadMe ./readme.html
 `
-!! Notes
-`--wikitest` looks for `*.tid` files in the specified folder. It then wikifies the tiddlers to both "text/plain" and "text/html" format and checks the results against the content of the `*.html` and `*.txt` files in the same directory.
-!!Try it out
-The easiest way to try out the code is to visit http://tiddlywiki.com/tiddlywiki5/
+!!Usage
+`
+node core/boot.js [--<option> [<arg>[,<arg>]]]
+`
+Running `boot.js` from the command line boots the TiddlyWiki kernel, loads the core plugins and establishes an empty wiki store. It then sequentially processes the command line arguments. The arguments are separated with spaces. The commands are identified by the prefix `--`.
 
-For trying it out under `node.js`, two batch files are provided:
+The commands are processed sequentially from left to right. Processing pauses during long operations and then resumes with the next command in sequence 
+!!Commands
+The following commands are available.
+
+!!! load
+`--load <filepath>`
+Load tiddlers from 2.x.x TiddlyWiki files (`.html`), `.tiddler`, `.tid`, `.json` or other files 
+
+!!! savetiddler
+`--savetiddler <title> <filename> [<type>]` 
+Save an individual tiddler as a specified MIME type, defaults to `text/html` 
+
+!!! wikitest
+`--wikitest <dir> [save]` 
+Run wikification tests against the tiddlers in the given directory. Include the `save` flag to save the test result files as the new targets.
+
+`--wikitest` looks for `*.tid` files in the specified folder. It then wikifies the tiddlers to both "text/plain" and "text/html" format and checks the results against the content of the `*.html` and `*.txt` files in the same directory.
+
+!!! server
+`--server <port> <roottiddler> <rendertype> <servetype>` 
+
+The server is very simple. At the root, it serves a rendering of a specified tiddler. Away from the root, it serves individual tiddlers encoded in JSON, and supports the basic HTTP operations for GET, PUT and DELETE.
+
+For example:
+{{{
+--server 8080 $:/core/tiddlywiki5.template.html text/plain text/html
+}}}
+The parameters are:
+{{{
+--server <port> <roottiddler> <rendertype> <servetype>
+}}}
+* ''port'' - port number to serve from (defaults to "8080")
+* ''roottiddler'' - the tiddler to serve at the root (defaults to "$:/core/tiddlywiki5.template.html") 
+* ''rendertype'' - the content type to which the root tiddler should be rendered (defaults to "text/plain")
+* ''servetype'' - the content type with which the root tiddler should be served (defaults to "text/html")
+
+!!! dump
+`--dump tiddlers` 
+Dump the titles of the tiddlers in the wiki store 
+
+!!! dump
+`--dump tiddler <title>` 
+Dump the fields of an individual tiddler 
+
+!!! dump
+`--dump shadows` 
+Dump the titles of the shadow tiddlers in the wiki store 
+
+!!! dump
+`--dump config` 
+Dump the current core configuration 
+
+!!! verbose
+`--verbose` 
+Triggers verbose output, useful for debugging 
+
+!!Trying it out
+For trying TiddlyWiki5 out under `node.js`, two batch files are provided:
 
 * `run.sh` boots the kernel and loads the core modules and then outputs the `$tw` global for inspection
 * `bld.sh` builds the new TiddlyWiki 5 HTML file (placed in the `tmp/tw5/` directory by default)