notes, docs and some tweaks...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>

pwiki/parser.js

@@ -441,6 +441,15 @@ module.BaseParser = {
 	// 		- expand macros -- .expand(..)
 	// 	- apply filters
 	//
+	// NOTE: this has to synchronize everything between stage 1 (up to 
+	// 		and including expand) and stage 2 (post-handlers, filters, ...)
+	// 		because the former need a fully loaded and expanded page if 
+	// 		we want to do this in 2 stages and not 3...
+	// 		XXX might be fun to try a load-and-tweak approach the first 
+	// 			version used -- i.e. setting placeholders and replacing 
+	// 			them on demand rather than on encounter (as is now), e.g.
+	// 			a slot when loaded will replace the prior occurrences...
+	//
 	// XXX add a special filter to clear pending filters... (???)
 	parse: async function(page, ast, state={}){
 		var that = this
@@ -460,6 +469,8 @@ module.BaseParser = {
 					: section })
 			.flat()
 			// filters...
+			// XXX if one of the post-handlers is a promise this will 
+			// 		need to sync...
 			.map(function(section){
 				return (
 					// expand section...

pwiki2-test.js

@@ -71,9 +71,9 @@ pwiki.pwiki
 		text: object.doc`
 			Testing slot mechanics...
 
-			This slot is <slot name="empty">unfilled</slot>
+			This slot is (<slot name="empty">unfilled</slot>)
 
-			...while this <slot name="non-empty">text should be replaced...</slot>
+			...while this (<slot name="non-empty">text should be replaced...</slot>)
 
 			<slot name="non-empty">text is filling a slot</slot>
 		`,

pwiki2.js

@@ -2,6 +2,7 @@
 * 
 *
 * XXX wikiword filter seems to act up on /
+* XXX BUG? /test/wikiword -- produces nested links...
 *
 *
 * XXX ROADMAP:
@@ -16,7 +17,7 @@
 * 				...handle relative urls (???)
 * 		- migrate bootstrap
 * 		- store topology
-* 	- WikiWord
+* 	- WikiWord										-- DONE
 * 	- markdown										-- DONE??
 * 	- pwa
 * 	- archive old code