Package: debian-policy Version: 3.2.0.0 The following patch corrects a misspelling and some other grammatical mistakes in policy.sgml.
Matt --- policy.sgml.orig Mon Aug 21 08:39:22 2000 +++ policy.sgml Mon Aug 21 10:00:52 2000 @@ -2608,7 +2608,7 @@ </footnote> <p> - The other way to do it is to via the maintainer scripts. + The other way to do it is via the maintainer scripts. In this case, the configuration file must not be listed as a <tt>conffile</tt> and must not be part of the package distribution. If the existence of a file is required for @@ -2616,7 +2616,7 @@ responsibility of the package maintainer to write scripts which correctly create, update, maintain and remove-on-purge the file. These scripts must be idempotent - (i.e. must work correctly if <prgn>dpkg</prgn> needs to + (i.e., must work correctly if <prgn>dpkg</prgn> needs to re-run them due to errors during installation or removal), must cope with all the variety of ways <prgn>dpkg</prgn> can call maintainer scripts, must not overwrite or @@ -2667,7 +2667,7 @@ If two or more packages use the same configuration file and it is reasonable for both to be installed at the same time, one of these packages must be defined as - <em>owner</em> of the configuration file, i.e. it will be + <em>owner</em> of the configuration file, i.e., it will be the package to list that distributes the file and lists it as a <tt>conffile</tt>. Other packages that use the configuration file must depend on the owning package if @@ -2736,7 +2736,7 @@ <p> Therefore, if a program in a Debian package needs to be - configured in some way in order to operate sensibly that + configured in some way in order to operate sensibly, that configuration should be done in a site-wide global configuration file elsewhere in <tt>/etc</tt>. Only if the program doesn't support a site-wide default configuration @@ -3016,8 +3016,8 @@ programs.</p> <p> - If it is very hard to adapt a program to make us of the - EDITOR and PAGER variable, that program may be configured + If it is very hard to adapt a program to make use of the + EDITOR and PAGER variables, that program may be configured to use <tt>/usr/bin/sensible-editor</tt> and <tt>/usr/bin/sensible-pager</tt> as editor or pager program, respectively. These are two scripts provided in the Debian @@ -3611,7 +3611,7 @@ page'.</p> <p> - Each program, utiltiy, and function should have an + Each program, utility, and function should have an associated manpage included in the same package. It is suggested that all configuration files also have a manual page included as well.