X-Git-Url: https://git.donarmstrong.com/?p=debian%2Fdebian-policy.git;a=blobdiff_plain;f=policy.sgml;h=404dc7373f80cdc20bf793e064d7163e3885518f;hp=7afd0fa3e2c202b081d27dc6292b5b2e30cc4a2e;hb=e369912eff1a2ff024668531cbd127ed48e61fcf;hpb=62e9a6ad9814d0493e9306c0095fec338cea0075

diff --git a/policy.sgml b/policy.sgml
index 7afd0fa..404dc73 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -10669,10 +10669,10 @@ END-INFO-DIR-ENTRY
 	  Any additional documentation that comes with the package may be
 	  installed at the discretion of the package maintainer.  It is
 	  often a good idea to include text information files
-	  (<file>README</file>s, <file>TODO</file>s, and so forth) that
-	  come with the source package in the binary package.  However,
-	  you don't need to install the instructions for building and
-	  installing the package, of course!
+	  (<file>README</file>s, FAQs, and so forth) that come with the
+	  source package in the binary package.  However, you don't need
+	  to install the instructions for building and installing the
+	  package, of course!
 	</p>
 
 	<p>
@@ -10699,7 +10699,7 @@ END-INFO-DIR-ENTRY
 	</p>
 
 	<p>
-	  Additional documentation included in the package must be
+	  Additional documentation included in the package should be
 	  installed under <file>/usr/share/doc/<var>package</var></file>.
 	  If the documentation is packaged separately,
 	  as <var>package</var>-doc for example, it may be installed under
@@ -10727,9 +10727,9 @@ END-INFO-DIR-ENTRY
 	    The system administrator should be able to delete files
 	    in <file>/usr/share/doc/</file> without causing any programs
 	    to break.
-	  </footnote>.  Any files that are referenced by programs but are
-	  also useful as stand alone documentation should be installed
-	  elsewhere, normally
+	  </footnote>.  Any files that are used or read by programs but
+	  are also useful as stand alone documentation should be installed
+	  elsewhere, such as
 	  under <file>/usr/share/<var>package</var>/</file>, and then
 	  included via symbolic links
 	  in <file>/usr/share/doc/<var>package</var></file>.