Re: [PATCH] upgrading-checklist in present tense?
Russ Allbery wrote:
> Alternately, if we're going to standardize on past tense, we should
> probably go ahead and fix everything back to 3.8.0 or so, which seems to
> be when I started introducing present tense. (It looks like Manoj was
> using past tense.)
Here's a rough patch on top to do that, in case we want to go that way.
upgrading-checklist.sgml | 42 +++++++++++++++++++++---------------------
1 files changed, 21 insertions(+), 21 deletions(-)
diff --git a/upgrading-checklist.sgml b/upgrading-checklist.sgml
index 80c778a..ce81eaa 100644
--- a/upgrading-checklist.sgml
+++ b/upgrading-checklist.sgml
@@ -127,8 +127,8 @@ Released July, 2010.
<tag>8.1</tag>
<item>The SONAME of a library should change whenever the ABI of the
library changes in a way that isn't backward-compatible. It should not
- change if the library ABI changes are backward-compatible. Discourage
- bundling shared libraries together in one package.
+ change if the library ABI changes are backward-compatible. Bundling
+ shared libraries together in one package is discouraged.
</item>
<tag>8.4</tag>
<item>Ada Library Information (<file>*.ali</file>) files must be
@@ -153,8 +153,8 @@ Released July, 2010.
</item>
<tag>10.2</tag>
<item>Libraries no longer need to be built with <tt>-D_REENTRANT</tt>,
- which was an obsolete LinuxThreads requirement. Instead, say explicitly
- that libraries should be built with threading support and to be
+ which was an obsolete LinuxThreads requirement. Instead, policy now says
+ explicitly that libraries should be built with threading support and to be
thread-safe if the library supports this.
</item>
<tag>10.4</tag>
@@ -165,7 +165,7 @@ Released July, 2010.
with <prgn>trap</prgn>.
</item>
<tag>10.8</tag>
- <item>Recommend <file>/etc/logrotate.d/<var>package</var></file> for
+ <item>Recommended <file>/etc/logrotate.d/<var>package</var></file> for
logrotate rules.
</item>
<tag>10.9</tag>
@@ -205,7 +205,7 @@ Released June, 2010.
particular field name.
</item>
<tag>5.4, 5.5, 5.6.24</tag>
- <item>Document and recommend the <tt>Checksums-Sha1</tt>
+ <item>Documented and recommended the <tt>Checksums-Sha1</tt>
and <tt>Checksums-Sha256</tt> fields in <file>*.dsc</file>
and <file>*.changes</file> files.
</item>
@@ -271,7 +271,7 @@ Released June, 2010.
common-licenses for the time being.
</item>
<tag>debconf</tag>
- <item>Add <tt>SETTITLE</tt> (which has been supported for some time).
+ <item>Added <tt>SETTITLE</tt> (which has been supported for some time).
Like <tt>TITLE</tt> but takes a template instead of a string to allow
translation.
</item>
@@ -301,7 +301,7 @@ Release Jan 2010.
<file>/usr/lib/triplet</file> directories.
</item>
<tag>10.6</tag>
- <item>Explicitly state that packages may not contain named pipes and
+ <item>Explicitly states that packages may not contain named pipes and
should instead create them in postinst and remove them in prerm or postrm.
</item>
<tag>9.1.1</tag>
@@ -316,12 +316,12 @@ Released Aug 2009.
</p><p><taglist>
<tag>4.9</tag>
- <item>Add DEB_*_ARCH_CPU and DEB_*_ARCH_OS variables and
- recommend them over GNU-style variables for that information.
+ <item>Added DEB_*_ARCH_CPU and DEB_*_ARCH_OS variables and
+ they are recommended over GNU-style variables for that information.
</item>
<tag>5.6.8</tag>
<item>Source package Architecture fields may contain <em/all/ in
- combination with other architectures. Clarify when <em/all/ and <em/any/
+ combination with other architectures. Clarified when <em/all/ and <em/any/
may be used in different versions of the field.
</item>
<tag>5.6.14</tag>
@@ -332,18 +332,18 @@ Released Aug 2009.
<item>The Binary field may span multiple lines.
</item>
<tag>10.2</tag>
- <item>Remove the permission for shared library packages to
+ <item>Removed the permission for shared library packages to
install libraries in a non-standard location and modify <file/ld.so.conf/.
Packages should either be installed in a standard library directory
or packages using them should be built with RPATH.
</item>
<tag>11.8.7</tag>
- <item>Clarify installation directories for X programs and
- remove the requirement to pre-depend on x11-common before installing
+ <item>Clarified installation directories for X programs and
+ removed the requirement to pre-depend on x11-common before installing
into <file>/usr/include/X11</file> and <file>/usr/lib/X11</file>.
</item>
<tag>12.1</tag>
- <item>Remove the requirement that all characters in a manual
+ <item>Removed the requirement that all characters in a manual
page be representable in the legacy encoding for that language.
</item>
<tag>12.1</tag>
@@ -420,11 +420,11 @@ Released Mar 2009.
<item>Changelog files must be encoded in UTF-8.
</item>
<tag>4.4</tag>
- <item>Tighten some format requirements for changelog files from a should
+ <item>Tightened some format requirements for changelog files from a should
to a must.
</item>
<tag>4.4.1</tag>
- <item>Remove alternative changelog formats. Debian only supports one
+ <item>Removed alternative changelog formats. Debian only supports one
changelog format for the Debian Archive.
</item>
<tag>4.9.1</tag>
@@ -511,14 +511,14 @@ Released Jun 2008.
named in Breaks is deconfigured first. This field should not be
used until the dpkg in Debian stable supports it.
<tag>8.1, 8.2</tag>
-<item>Clarify which files should go into a shared library package, into a
- separate package, or into the -dev package. Suggest -tools instead
+<item>Clarified which files should go into a shared library package, into a
+ separate package, or into the -dev package. Now suggests -tools instead
of -runtime for runtime support programs, since that naming is more
common in Debian.
<tag>9.5</tag>
<item>Files in <file>/etc/cron.{hourly,daily,weekly,monthly}</file> must be
- configuration files (upgraded from should). Mention the hourly
- directory.
+ configuration files (upgraded from should). The hourly directory was not
+ mentioned before.
<tag>11.8.6</tag>
<item>Packages providing <file>/etc/X11/Xresources</file> files need not
conflict with <tt> xbase (<< 3.3.2.3a-2)</tt>, which is
--
1.7.5.rc0
Reply to: