[bug545548-srivasta]: Arrange to regenerate derived files from org source
For machines without a newer Emacs, this has no effect, but if a new
Emacs is present, the .txt and .html files shall be regenerated if the
org file is newer.
This patch add a README file, rendered as txt and html, and also
documents the policy change process, again rendered as text and
HTML. While the text and HTML files are automatically generated, they are
shipped in the package itself so as to avoud depending on a recent
version of Emacs during build.
The contents of the new documents are based on (but no identical to) the
contents of related pages on the Debian wiki. The long term plan is to
make these documents the canonical ones, and have the Wiki point to these
pages.
Steve Langasek [Sat, 5 Sep 2009 03:50:30 +0000 (20:50 -0700)]
Bug#542865: Grant an FHS exception for the multiarch library directories
On Fri, Aug 21, 2009 at 09:25:30PM -0700, Russ Allbery wrote:
> Manoj Srivastava <srivasta@debian.org> writes:
> > On Fri, Aug 21 2009, Russ Allbery wrote:
> >> The current restriction is specific to libraries. Don't we need to say
> >> that you can't put *any* files into any triplet directory that isn't
> >> for your package architecture?
> > Hmm. My first read was that one could not put anything that was
> > not a library in these directories, but perhaps it should be stated
> > explicitly.
> I was expecting that we'd need to put anything that you might want to have
> simultaneous installs from multiple architectures in that directory, which
> would include, for instance, any shared library plugins or loadable
> modules, which aren't strictly libraries.
> We might have to duplicate some library helper programs as well, if for
> instance they communicate with the library using binary structures that
> are sensitive to sizeof(long).
Right, this was a bug in the proposed patch, not a deliberate statement that
only libraries belong in these directories. (As I mentioned, the first
patch was something of a trial balloon.) I think this updated patch should
cover everything for the first round.
Russ Allbery [Sun, 16 Aug 2009 00:04:24 +0000 (17:04 -0700)]
Remove seconds by non-DDs
Consensus on debian-policy seems to be that seconding should be
restricted to Debian Developers, so remove seconds from non-DDs and
add an additional second from that thread for the man page translation
change.
Russ Allbery [Sun, 16 Aug 2009 00:04:00 +0000 (17:04 -0700)]
sensible-* come from the sensible-utils package
Say that sensible-editor and sensible-pager are provided by the
sensible-utils package, not by the base system. Thanks, Clint Adams
and Steve Langasek. (Closes: #541537)
Russ Allbery [Sat, 15 Aug 2009 23:49:37 +0000 (16:49 -0700)]
Add dependency recommendation for packages with info documents
This is an additional fix for #538665. Recommend a dependency that
ensures a triggerized install-info is available so that the dir file
will be properly rebuilt on partial upgrades from lenny. Reviewed
by Bill Allombert and Raphaël Hertzog.
Russ Allbery [Mon, 10 Aug 2009 20:23:34 +0000 (13:23 -0700)]
Fix the footnote on modifying Texinfo source for dir information
The footnote about how to modify the Texinfo source to add the necessary
info directory information ended two lines before it should. Thanks,
Raphaël Hertzog.
Russ Allbery [Sat, 8 Aug 2009 08:14:46 +0000 (01:14 -0700)]
Improve Description and Changes specification for *.changes
* Change the wording of the Description and Changes field specifications
for *.changes files to more closely match the wording for Files and
add more details about the contents of the Description field in
a *.changes file.
Russ Allbery [Sat, 8 Aug 2009 03:06:17 +0000 (20:06 -0700)]
Clarify the description of the Files control field
Reword a difficult sentence in the Files control field description and
add examples of the two versions of the field. Thanks to Jeremiah
Foster for the report and wording discussion.
Russ Allbery [Sat, 8 Aug 2009 02:40:22 +0000 (19:40 -0700)]
Maintainer scripts may not have a controlling terminal
Maintainer scripts are no longer guaranteed to have a controlling terminal
and may not be able to interact with the user. If debconf is used to
prompt, maintainer scripts may assume that it will handle the fallback to
noninteractive defaults.
Russ Allbery [Sat, 8 Aug 2009 02:07:47 +0000 (19:07 -0700)]
Add an SGML comment with a close double-quote to unconfuse Emacs
Emacs wants the unmatched double-quote in the discussion of init scripts
to be closed and otherwise treats the rest of the file as if it's in a
string. Unconfuse it with an SGML comment.
Russ Allbery [Fri, 7 Aug 2009 23:36:18 +0000 (16:36 -0700)]
Remove the encoding requirement for manual pages
Previously, all characters in a manual page had to be representable in
the legacy encoding for that language due to limitations in groff. The
current release of groff removes that limitation, so this restriction
can be lifted.
The system administrator may have removed an override, and --remove will
fail if none exist. Suggest checking first to see whether the override
exists before removing it.
Russ Allbery [Fri, 7 Aug 2009 22:34:31 +0000 (15:34 -0700)]
Rewrite info documents section
install-info now uses dpkg hooks, so remove all requirements for running
install-info in package maintainer scripts. Document the necessary info
directory information and provide Texinfo modification instructions in a
footnote. Explicitly forbid packages from including /usr/share/info/dir.
Russ Allbery [Fri, 7 Aug 2009 22:04:09 +0000 (15:04 -0700)]
Unify the syntax description for package names
In the Package field description, reference the syntax for source package
names in the Source field description rather than repeating it. Add a
cross-reference to Package in the Source field description.
Russ Allbery [Fri, 7 Aug 2009 20:34:07 +0000 (13:34 -0700)]
Allow the Binary control field to wrap
Allow the Binary control field to wrap in both *.dsc and *.changes files,
since we have some source packages that produce lines so long that GnuPG
is no longer willing to sign the file.
Clearly state that the syntax is different depending on whether the field
appears in a *.dsc file or a *.changes file.
Thanks to Raphaël Hertzog for the report. Debian Bug#533852.
Russ Allbery [Fri, 7 Aug 2009 20:24:46 +0000 (13:24 -0700)]
Improve the Installed-Size wording
Avoid the term kibibytes, which is controversial. Document that
Installed-Size is only an estimate and may vary based on block size,
file system properties, and actions taken by maintainer scripts.
Using /etc/X11 for configuration is allowed, not should
Expand the list of applications that may use /etc/X11 for configuration
files to include session managers, but change this section to may from
should. There doesn't appear to be a reason to encourage this going
forward. Reword the section for more direct phrasing.
* Explain that the copyright dates are for the original Policy manual
and that there is no updated list of copyright holders for subsequent
revisions available. (Partly addresses #47438)
Russ Allbery [Sat, 20 Jun 2009 17:09:14 +0000 (10:09 -0700)]
Remove obsolete versioned Perl depend and build-depend requirement
Perl modules are no longer required to build-depend on perl 5.6.0-16
or later and arch-independent modules are no longer required to depend
on perl or perl-base 5.6.0-16 or later. All versions of Debian
released for years have shipped with a newer version of Perl than that.
Russ Allbery [Sat, 20 Jun 2009 06:50:47 +0000 (23:50 -0700)]
Rewrite X installation directory issues
Rework the whole section on X installation directory issues to remove
obsolete transitional requirements and to be clearer about the history
of alternative installation directories and the mapping of old to new
locations.
Guillem Jover [Sat, 20 Jun 2009 02:05:17 +0000 (19:05 -0700)]
Update information about DEB_*_ARCH variables
Recommend using the DEB_*_ARCH_CPU and DEB_*_ARCH_OS variables instead
of the GNU style ones. And mention that the latter are mostly intended
for use with upstream build systems, and not Debian packaging.
Russ Allbery [Tue, 16 Jun 2009 20:35:07 +0000 (13:35 -0700)]
Bring Architecture description in line with dpkg-source
dpkg-source now may include "all" in the list of architectures in the
*.dsc Architecture field. Rewrite the Architecture section to be
clearer about the acceptable values in different contexts and what
they mean.
Bill Allombert [Tue, 16 Jun 2009 18:38:18 +0000 (20:38 +0200)]
Add myself to Uploaders.
Update Standards-Version to 3.8.1 (no changes required).
debian/rules: use dpkg --print-architecture instead of
obsolete form dpkg --print-installation-architecture
Colin Watson [Mon, 27 Apr 2009 15:22:34 +0000 (16:22 +0100)]
Spelling fixes
The FHS is the "Filesystem Hierarchy Standard", regardless of our
preferred spelling of "file system" elsewhere. Fix this and a nearby
search-and-replace capitalisation bug.