Correct some formulations, fix XXX comments.

Doc/lib/libmsilib.tex

@@ -33,7 +33,7 @@ MSI routines, and standard table structures.
   be a list of tuples, each containing the name of the file on
   disk, and the name of the file inside the CAB file.
 
-  The files are added to the CAB file in the order they have
+  The files are added to the CAB file in the order they appear
   in the list. All files are added into a single CAB file,
   using the MSZIP compression algorithm.
 
@@ -99,8 +99,7 @@ MSI routines, and standard table structures.
   listing all tables for which content should be added,
   and one attribute per table that has the actual content.
 
-  This is typically used to install the sequence 
-  % XXX unfinished sentence
+  This is typically used to install the sequence tables.
 \end{funcdesc}
 
 \begin{funcdesc}{add_stream}{database, name, path}
@@ -293,7 +292,7 @@ the string inside the exception will contain more detail.
 \subsection{Directory Objects\label{msi-directory}}
 
 \begin{classdesc}{Directory}{database, cab, basedir, physical, 
-                  logical, default, component, \optional{flags}}
+                  logical, default, component, \optional{componentflags}}
   Create a new directory in the Directory table. There is a current
   component at each point in time for the directory, which is either
   explicitly created through \method{start_component}, or implicitly when files
@@ -301,9 +300,8 @@ the string inside the exception will contain more detail.
   component, and into the cab file.  To create a directory, a base
   directory object needs to be specified (can be \code{None}), the path to
   the physical directory, and a logical directory name.  \var{default}
-  specifies the DefaultDir slot in the directory table. componentflags
+  specifies the DefaultDir slot in the directory table. \var{componentflags}
   specifies the default flags that new components get.
-  % XXX signature says 'component', 'flags'; text says 'componentflags'.
 \end{classdesc}
 
 \begin{methoddesc}[Directory]{start_component}{\optional{component\optional{,
@@ -484,4 +482,4 @@ are based on MSI version 2.0.
 \begin{datadesc}{text}
   This module contains definitions for the UIText and ActionText
   tables, for the standard installer actions.
-\end{datadesc}
+\end{datadesc}
\ No newline at end of file