--- wikisrc/users/jruoho/Attic/doc.mdwn	2010/04/05 07:07:44	1.7
+++ wikisrc/users/jruoho/Attic/doc.mdwn	2010/04/05 07:34:19	1.8
@@ -1,19 +1,12 @@
-[[!meta title="markup test"]]
-
-# This is a test page.
-
-The conventions used for markup transitions:
-
-* <chap> -> ##
-* <para> -> #
-* &os; -> NetBSD
+# A Test.
 
 Problems:
 
 * All documents must be HTML ready (the eternal <, >, &, etc.).
+  The ability to inline HTML can cause additional problems.
 * There seems to be no easy way to define custom macros (cf. &os;, etc.).
-* Only the H1-headers are enumerated in the table of conents.
-* Headers are not enumerated in the body text.
+* When using [toc], only the H1-headers are enumerated in the table of
+  contents. Also: headers are not enumerated in the body text.
 
 Benefits:
 
@@ -21,11 +14,18 @@ Benefits:
   plain text. This should be a big benefit in lowering the barriers of entry
   to documentation.
 
-# About NetBSD
+* [About NetBSD](#intro-about)
+	* [What is NetBSD?](#intro-whatis)
+	* [The story of NetBSD](#intro-story)
+	* [NetBSD features](#intro-features)
+	* [Supported platforms](#intro-platforms)
+	* [NetBSD's target users](#intro-users)
+	* [Applications of NetBSD](#intro-applications)
+	* [How to get NetBSD](#intro-get)
 
-[[!toc]]
+<h2 id="intro-about">About NetBSD</h2>
 
-## What is NetBSD?
+<h3 id="intro-whatis">What is NetBSD?</h3>
 
 NetBSD is a free, fast, secure, and highly portable Unix-like Open Source
 operating system.  It is available for many platforms, from 64-bit x86 servers
@@ -34,7 +34,7 @@ and advanced features make it excellent 
 environments, and it is user-supported with complete source.  Many applications
 are easily available through pkgsrc, the NetBSD Packages Collection.
 
-### The story of NetBSD
+<h3 id="intro-story">The story of NetBSD</h3>
 
 The first version of NetBSD (0.8) dates back to 1993 and springs from the
 4.3BSD Lite operating system, a version of Unix developed at the University
@@ -49,7 +49,7 @@ Berkeley fast file system, reliable sign
 TCP/IP, just to name a few.  This tradition of research and development
 survives today in the BSD systems and, in particular, in NetBSD.
 
-### NetBSD features
+<h3 id="intro-features">NetBSD features</h3>
 
 NetBSD operates on a vast range of hardware platforms and is very portable.
 The full source to the NetBSD kernel and userland is available for all the
@@ -77,7 +77,7 @@ could be described as *it doesn't work u
 many overgrown programs are collapsing under their own weight and "features"
 and you'll understand why NetBSD tries to avoid this situation at all costs.
 
-### Supported platforms
+<h3 id="intro-platforms">Supported platforms</h3>
 
 NetBSD supports many platforms, including the popular PC platform (i386 and
 amd64), SPARC and UltraSPARC, Alpha, Amiga, Atari, and m68k and PowerPC
@@ -86,7 +86,7 @@ found on
 [the NetBSD site](http://www.NetBSD.org/ports "NetBSD Ports")
 .
 
-### NetBSD's target users
+<h3 id="intro-users">NetBSD's target users</h3>
 
 The NetBSD site states that: *the NetBSD Project provides a freely available
 and redistributable system that professionals, hobbyists, and researchers
@@ -102,7 +102,7 @@ performance on modern hardware.  In addi
 which runs consistently on a variety of platforms, NetBSD is probably your
 best choice.
 
-### Applications for NetBSD
+<h3 id="intro-applications">Applications for NetBSD</h3>
 
 Aside from the standard Unix productivity tools, editors, formatters, C/C++
 compilers and debuggers and so on that are included with the base system,
@@ -120,7 +120,7 @@ example.  You can run the Linux versions
 * Acrobat Reader
 * many other programs
 
-### How to get NetBSD
+<h3 id="intro-get">How to get NetBSD</h3>
 
 NetBSD is an Open Source operating system, and as such it is freely
 available for download from