[added a few comments and examples
ijones@syntaxpolice.org**20050210055436] {
hunk ./doc/Cabal.xml 43
-      does not work very well, as the executables may not depend on
-      the library.</para>
+    does not work very well; if the executables depend on the library,
+    they must explicitly list the modules they use from that
+    library.</para>
hunk ./doc/Cabal.xml 47
-    <para>Internally, the package may consist of much more than a bunch
-      of Haskell modules: it may also have C source code and header
-      files, documentation, test cases, auxiliary tools etc.</para>
+    <para>Internally, the package may consist of much more than a
+    bunch of Haskell modules: it may also have C source code and
+    header files, source code meant for preprocessing, documentation,
+    test cases, auxiliary tools etc.</para>
hunk ./doc/Cabal.xml 134
-      <title>A package containing executable programs</title>
+      <title>A package containing a library and executable programs</title>
hunk ./doc/Cabal.xml 136
-Name:           TestPackage
-Version:        0.0
-License:        BSD3
-Author:         Angela Author
-Build-Depends:  HUnit
+Name:            TestPackage
+Version:         0.0
+License:         BSD3
+Author:          Angela Author
+Build-Depends:   HUnit
+Exposed-Modules: A, B, C
hunk ./doc/Cabal.xml 145
+Hidden-Modules: A, B
hunk ./doc/Cabal.xml 150
+Hidden-Modules: C
hunk ./doc/Cabal.xml 656
-          <para>Writing your own setup script conforming to the interface
-            of <xref linkend="builders"/>, possibly using the Cabal
-            library for part of the work.  Good luck.</para>
+          <para>Writing your own setup script conforming to the
+          interface of <xref linkend="builders"/>, possibly using the
+          Cabal library for part of the work.  One option is to copy
+          the source of Distribution.Simple, and alter it for your
+          needs.  Good luck.</para>
hunk ./doc/Cabal.xml 971
+      <para>...</para>
hunk ./doc/Cabal.xml 976
+      <para>...</para>
}