This is first step in the Handbook migration from the LinuxDoc DTD to

the DocBook DTD. Details on how this was carried out are in the README
file.

en/handbook/README

@@ -1,10 +1,48 @@
 This will be the location of the DocBook version of the FreeBSD Handbook,
 which will eventually obsolete the version currently in doc/handbook/.
 
-The conversion process will start at roughly GMT 1830, 1/4/1998. Interested
-parties should examine
+Interested parties should examine
 
   <URL:http://www.nothing-going-on.demon.co.uk/FreeBSD/docbook-migration.html>
 
 and get in touch with Nik Clayton (either to nik@FreeBSD.ORG or via the
-FreeBSD-doc mailing list).
+FreeBSD-doc mailing list) if they have specific questions.
+
+   ------------------------------------------------------------------------
+    The Handbook is midway through the conversion process. It will almost
+		certainly not convert to other formats cleanly
+   ------------------------------------------------------------------------
+
+
+				   Actions
+
+  This list explains what's been done so far, so the Japanese team can
+  track my changes. All actions took place on freefall.
+
+  1. Initial conversion to DocBook
+
+     Checked out a copy of the doc repository to ~/cvs/. Then used 2 scripts
+     to convert the handbook to its initial DocBook format. The 2 scripts are
+     2docbook.sh and entity-cdata.pl, both of which can be found in ~nik/bin/.
+
+     2docbook.sh calls entity-cdata.pl as necessary.
+
+         % cd ~/cvs/doc/handbook
+	 % 2docbook.sh
+
+     This created handbook-db.sgml in ~/cvs/doc/handbook. This file contains
+     syntactically valid (but quite ugly) SGML. This file was then moved to
+     the doc/en/handbook directory and renamed to handbook.sgml. The
+     conversion process left a few spurious changes in the old handbook files
+     which I don't want to commit, so I removed them and updated the
+     repository.
+
+     The new file was then committed.
+
+         % mv handbook-db.sgml ~/cvs/doc/en/handbook/handbook.sgml
+	 % rm *.sgml
+	 % cvs update
+	 % cd ~/cvs/doc/en/handbook
+	 % cvs add handbook.sgml
+	 % cvs commit
+