diff --git a/oracle-docs.perl b/oracle-docs.perl
index 8e85fd0..1d893b5 100755
--- a/oracle-docs.perl
+++ b/oracle-docs.perl
@@ -5,11 +5,11 @@
 # Basic script for generating XML markup for the major sections of the Oracle Documentation, and XSLT templates (and meta-templates, for both output formats) for transforming it.
 # 
 # To do:
-#  * respond to different command line parameters: produce either markup, XSLT for HTML, XSLT for LaTeX, or XSLT for both; produce only for the specified section (identified by its Code).
+#  * Maybe modify the script to work for any URL-based hyperlinks (e.g. <Blackboard/>, <OtagoUniversity/>).  This would mean ditching the automatic "Ora" prefix, but wouldn't require much else to implement.
  
 
 # Here's the raw data (this used to be in an Excel spreadsheet, which now obviously shouldn't be used any more - might remove from CVS some time).
-# Each entry has a name (marked up as XML), a unique, short, space-less code, and the actual URL.
+# Each entry has a name (marked up as XML), a unique, short, space-less code name for it, and the actual URL.
 @references =
 (
 	# Name(0)	Code(1)	URL(2)
@@ -84,7 +84,7 @@
 # 
 # 	<hyperlink url="http://wherever/">Some Web Site</hyperlink>
 # 
-# However, this will only match elements with a url attribute; we therefore need a new internal hyperlink that's parameterised.  Should be modal.
+# However, this will only match elements with a url attribute; we therefore need a new internal hyperlink that's parameterised.  Should be modal (but "call-templates" doesn't seem to like it when you give it a "mode" attribute).
 # The derived xml2html.xsl and xml2latex.xsl files will need to call this hyperlink-internal template directly:
 #
 # 	<xsl:call-template name="hyperlink-internal" mode="hyperlink-internal">