Debian Bug report logs - #415468
aptitude: Manpages unreadable

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Florentin Duneau <florentin.duneau@free.fr>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: aptitude: Manpages unreadable

Date: Mon, 19 Mar 2007 20:54:34 +0100

Package: aptitude
Version: 0.4.4-4
Severity: normal

Hi,

The aptitude manpages (en, fr for example) are wrongly generated. See
below the english manpage:

COMMAND-LINE ACTIONS
       The first argument which does not begin with a hyphen (“\fB-\fR”) is
       considered to be an action that the program should perform.
       If an action is not specified on the command-line, aptitude will start
       up in visual mode.

       The following actions are available:

       \fBinstall\fR


Florentin Duneau


-- System Information:
Debian Release: 4.0
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.18-4-486
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)

Versions of packages aptitude depends on:
ii  apt [libapt-pkg-libc6.3-6-3 0.6.46.4-0.1 Advanced front-end for dpkg
ii  libc6                       2.3.6.ds1-13 GNU C Library: Shared libraries
ii  libgcc1                     1:4.1.1-21   GCC support library
ii  libncursesw5                5.5-5        Shared libraries for terminal hand
ii  libsigc++-2.0-0c2a          2.0.17-2     type-safe Signal Framework for C++
ii  libstdc++6                  4.1.1-21     The GNU Standard C++ Library v3

Versions of packages aptitude recommends:
pn  aptitude-doc-en | aptitude-do <none>     (no description available)
pn  libparse-debianchangelog-perl <none>     (no description available)

-- no debconf information

Message #10 received at 415468@bugs.debian.org (full text, mbox, reply):

From: Daniel Leidert <daniel.leidert@wgdd.de>

To: 415468@bugs.debian.org, control@bugs.debian.org

Subject: Re: Bug#415468: aptitude: Manpages unreadable

Date: Mon, 19 Mar 2007 23:01:25 +0100

tags 415468 + patch
thanks

Am Montag, den 19.03.2007, 20:54 +0100 schrieb Florentin Duneau:

> The aptitude manpages (en, fr for example) are wrongly generated. See
> below the english manpage:

Change the literal matching template to:

<xsl:template match="literal">
  <xsl:apply-templates mode="bold" select="."/>
</xsl:template>

Regards, Daniel

Message #17 received at 415468@bugs.debian.org (full text, mbox, reply):

From: Thomas Huriaux <thomas.huriaux@gmail.com>

To: Florentin Duneau <florentin.duneau@free.fr>, 415468@bugs.debian.org

Cc: control@bugs.debian.org

Subject: Re: Bug#415468: aptitude: Manpages unreadable

Date: Mon, 19 Mar 2007 23:11:30 +0100

[Message part 1 (text/plain, inline)]

clone 415468 -1
reassign -1 docbook-xsl
severity -1 important
found -1 1.72.0.dfsg.1-1
retitle -1 docbook-xsl: broken stylesheets for nroff
block 415468 by -1
thanks

Florentin Duneau <florentin.duneau@free.fr> (19/03/2007):
> The aptitude manpages (en, fr for example) are wrongly generated. See
> below the english manpage:
> 
> COMMAND-LINE ACTIONS
>        The first argument which does not begin with a hyphen (“\fB-\fR”) is
>        considered to be an action that the program should perform.
>        If an action is not specified on the command-line, aptitude will start
>        up in visual mode.
> 
>        The following actions are available:
> 
>        \fBinstall\fR

This bug can be reproduced only with docbook-xsl 1.72.0.dfsg.1-1
(I tested 1.71.0.dfsg.1-1.1 and 1.68.1-0.1)


Cheers,

-- 
Thomas Huriaux

[signature.asc (application/pgp-signature, inline)]

Message #28 received at 415468@bugs.debian.org (full text, mbox, reply):

From: Daniel Burrows <dburrows@debian.org>

To: Florentin Duneau <florentin.duneau@free.fr>, 415468@bugs.debian.org

Subject: Re: Bug#415468: aptitude: Manpages unreadable

Date: Wed, 21 Mar 2007 07:25:23 -0700

On Mon, Mar 19, 2007 at 08:54:34PM +0100, Florentin Duneau <florentin.duneau@free.fr> was heard to say:
> Package: aptitude
> Version: 0.4.4-4
> Severity: normal
> 
> Hi,
> 
> The aptitude manpages (en, fr for example) are wrongly generated. See
> below the english manpage:
> 
> COMMAND-LINE ACTIONS
>        The first argument which does not begin with a hyphen (“\fB-\fR”) is
>        considered to be an action that the program should perform.
>        If an action is not specified on the command-line, aptitude will start
>        up in visual mode.
> 
>        The following actions are available:
> 
>        \fBinstall\fR

  I get:

COMMAND-LINE ACTIONS
       The first argument which does not begin with a hyphen (“-”) is
       considered to be an action that the program should perform. If an
       action is not specified on the command-line, aptitude will start up in
       visual mode.

       The following actions are available:

       install

  This is with aptitude 0.4.4-4 as present in Debian.  Did you get your
package from somewhere else?

  Daniel

Message #35 received at 415468@bugs.debian.org (full text, mbox, reply):

From: Florentin Duneau <florentin.duneau@free.fr>

To: 415468@bugs.debian.org

Cc: Daniel Burrows <dburrows@debian.org>

Subject: Re: Bug#415468: aptitude: Manpages unreadable

Date: Thu, 22 Mar 2007 22:02:30 +0100

[Message part 1 (text/plain, inline)]

On 07:25 Wed 21 Mar, Daniel Burrows wrote:
[...]
> 
>   I get:
> 
> COMMAND-LINE ACTIONS
>        The first argument which does not begin with a hyphen (“-”) is
>        considered to be an action that the program should perform. If an
>        action is not specified on the command-line, aptitude will start up in
>        visual mode.
> 
>        The following actions are available:
> 
>        install
> 
>   This is with aptitude 0.4.4-4 as present in Debian.  Did you get your
> package from somewhere else?

I get aptitude from official Debian repository (ftp.fr.debian.org).

With aptitude-0.4.4-4, I can reproduce it with konsole, xterm and in
console mode (with english and french man page) on my two computers.

I have downgraded aptitude-0.4.4-4 to 0.4.4-3 from /var/cache/apt/archives
with dpkg and I can't reproduce it with this version.

Find attached a diff of aptitude.8 manpage between 0.4.4-3 and 0.4.4-4.


Florentin Duneau

[aptitude.8.diff (text/x-diff, attachment)]

Message #40 received at 415468@bugs.debian.org (full text, mbox, reply):

From: Kobayashi Noritada <nori1@dolphin.c.u-tokyo.ac.jp>

To: florentin.duneau@free.fr, 415468@bugs.debian.org

Cc: dburrows@debian.org

Subject: Re: Bug#415468: aptitude: Manpages unreadable

Date: Fri, 23 Mar 2007 15:34:56 +0900 (JST)

From: Florentin Duneau <florentin.duneau@free.fr>
Subject: Bug#415468: aptitude: Manpages unreadable
Date: Thu, 22 Mar 2007 22:02:30 +0100

> On 07:25 Wed 21 Mar, Daniel Burrows wrote:
> [...]
> > 
> >   I get:
> > 
> > COMMAND-LINE ACTIONS
> >        The first argument which does not begin with a hyphen (“-”) is
> >        considered to be an action that the program should perform. If an
> >        action is not specified on the command-line, aptitude will start up in
> >        visual mode.
> > 
> >        The following actions are available:
> > 
> >        install
> > 
> >   This is with aptitude 0.4.4-4 as present in Debian.  Did you get your
> > package from somewhere else?
> 
> I get aptitude from official Debian repository (ftp.fr.debian.org).
> 
> With aptitude-0.4.4-4, I can reproduce it with konsole, xterm and in
> console mode (with english and french man page) on my two computers.
> 
> I have downgraded aptitude-0.4.4-4 to 0.4.4-3 from /var/cache/apt/archives
> with dpkg and I can't reproduce it with this version.

This bug also occurs for Japanese manpages in my environment (i.e. on
mlterm, packages in pbuilder chroot for sid).  I'm sure this is
reproducible.  I cannot understand why it cannot be reproduced in
Daniel's environment...

Thanks,

-nori

Message #45 received at 415468@bugs.debian.org (full text, mbox, reply):

From: Daniel Leidert <daniel.leidert@wgdd.de>

To: Daniel Burrows <dburrows@debian.org>, 415468@bugs.debian.org

Cc: 415468-submitter@bugs.debian.org

Subject: Re: Bug#415468: aptitude: Manpages unreadable

Date: Fri, 23 Mar 2007 18:28:46 +0100

Am Mittwoch, den 21.03.2007, 07:25 -0700 schrieb Daniel Burrows:
> On Mon, Mar 19, 2007 at 08:54:34PM +0100, Florentin Duneau <florentin.duneau@free.fr> was heard to say:
> > Package: aptitude
> > Version: 0.4.4-4
> > Severity: normal
> > 
> > Hi,
> > 
> > The aptitude manpages (en, fr for example) are wrongly generated. See
> > below the english manpage:
> > 
> > COMMAND-LINE ACTIONS
> >        The first argument which does not begin with a hyphen (“\fB-\fR”) is
> >        considered to be an action that the program should perform.
> >        If an action is not specified on the command-line, aptitude will start
> >        up in visual mode.
> > 
> >        The following actions are available:
> > 
> >        \fBinstall\fR
> 
>   I get:
> 
> COMMAND-LINE ACTIONS
>        The first argument which does not begin with a hyphen (“-”) is
>        considered to be an action that the program should perform. If an
>        action is not specified on the command-line, aptitude will start up in
>        visual mode.
> 
>        The following actions are available:
> 
>        install
> 
>   This is with aptitude 0.4.4-4 as present in Debian.  Did you get your
> package from somewhere else?

The package in Debian definitely shows the issue reported by the OP. The
reason is a change in the DocBook-XSL stylesheets version 1.72.0, that
missed some more announcement. In this change, backslashes are escaped
as '\e'. So

<xsl:text>\fB</xsl:text>

results in

\efB

in groff code. See
e.g. /usr/share/xml/docbook/stylesheet/nwalsh/manpages/utility.xsl
mode="bold" template for an example, how to handle this behaviour. You
must use the unicode code to represent backslahes. They code is then
replaced in the very last step with the sign it represents, the
backslash. Upstream has reverted this change recently, because this
design is very slow and consumes a lot of memory.

However, I suggest you to use the following template in your
customization layer aptitude-man.xsl (the btw recommended way, see also
the comments in utility.xsl):

<xsl:template match="literal">
  <xsl:if test="$man.hyphenate.computer.inlines = 0">
    <xsl:call-template name="suppress.hyphenation"/>
  </xsl:if>
  <xsl:apply-templates mode="bold" select="."/>
</xsl:template>

BTW: I first thought, that the reason, that you don't see this issue is
maybe, that you build the package against docbook-xsl < 1.72.0 and the
submitter maybe used an auto-build(ded) package for a different
architecture, that used docbook-xsl 1.72.0. But the upload wsa made for
i386, the arch the submitter uses too.

Regards, Daniel

Message #53 received at 415468@bugs.debian.org (full text, mbox, reply):

From: Daniel Burrows <dburrows@debian.org>

To: Daniel Leidert <daniel.leidert@wgdd.de>, 415468@bugs.debian.org

Subject: Re: Bug#415468: aptitude: Manpages unreadable

Date: Fri, 23 Mar 2007 22:05:02 -0700

On Fri, Mar 23, 2007 at 06:28:46PM +0100, Daniel Leidert <daniel.leidert@wgdd.de> was heard to say:
> Am Mittwoch, den 21.03.2007, 07:25 -0700 schrieb Daniel Burrows:
> >   This is with aptitude 0.4.4-4 as present in Debian.  Did you get your
> > package from somewhere else?
> 
> The package in Debian definitely shows the issue reported by the OP. The
> reason is a change in the DocBook-XSL stylesheets version 1.72.0, that
> missed some more announcement. In this change, backslashes are escaped
> as '\e'. So

  Aha!  I had a correct version in /usr/local.  Not good for testing. :P

> However, I suggest you to use the following template in your
> customization layer aptitude-man.xsl (the btw recommended way, see also
> the comments in utility.xsl):
> 
> <xsl:template match="literal">
>   <xsl:if test="$man.hyphenate.computer.inlines = 0">
>     <xsl:call-template name="suppress.hyphenation"/>
>   </xsl:if>
>   <xsl:apply-templates mode="bold" select="."/>
> </xsl:template>

  Oddly enough, one of my local branches (not the one I uploaded) seems to
have this as an uncommitted change.  I'm not sure why it's there or why it
isn't committed -- probably I didn't understand it completely when I first
made it and I was going to convince myself there were no bad side
effects (before I forgot completely that it was there).

  Daniel

Message #64 received at 415468@bugs.debian.org (full text, mbox, reply):

From: Johannes Wiedersich <johannes@physik.blm.tu-muenchen.de>

To: 415468@bugs.debian.org

Subject: confirmed on stable etch

Date: Wed, 18 Apr 2007 19:01:52 +0200

This is confirmed for the stable release of etch.

I would suggest to include the fix in an upcoming point release, because
it makes it rather difficult to read

/-------------------
           <package>\fB+\fR
               Install <package>.

           <package>\fB+M\fR
\-------------------

as "<package>+M" etc. -- especially for new users that are not familiar
with aptitude.

Thanks,
Johannes

Message #71 received at 415468-close@bugs.debian.org (full text, mbox, reply):

From: Daniel Burrows <dburrows@debian.org>

To: 415468-close@bugs.debian.org

Subject: Bug#415468: fixed in aptitude 0.4.4-5~1

Date: Wed, 16 May 2007 04:47:03 +0000

Source: aptitude
Source-Version: 0.4.4-5~1

We believe that the bug you reported is fixed in the latest version of
aptitude, which is due to be installed in the Debian FTP archive:

aptitude-doc-cs_0.4.4-5~1_all.deb
  to pool/main/a/aptitude/aptitude-doc-cs_0.4.4-5~1_all.deb
aptitude-doc-en_0.4.4-5~1_all.deb
  to pool/main/a/aptitude/aptitude-doc-en_0.4.4-5~1_all.deb
aptitude-doc-fi_0.4.4-5~1_all.deb
  to pool/main/a/aptitude/aptitude-doc-fi_0.4.4-5~1_all.deb
aptitude-doc-fr_0.4.4-5~1_all.deb
  to pool/main/a/aptitude/aptitude-doc-fr_0.4.4-5~1_all.deb
aptitude_0.4.4-5~1.diff.gz
  to pool/main/a/aptitude/aptitude_0.4.4-5~1.diff.gz
aptitude_0.4.4-5~1.dsc
  to pool/main/a/aptitude/aptitude_0.4.4-5~1.dsc
aptitude_0.4.4-5~1_i386.deb
  to pool/main/a/aptitude/aptitude_0.4.4-5~1_i386.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 415468@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Daniel Burrows <dburrows@debian.org> (supplier of updated aptitude package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.7
Date: Tue, 15 May 2007 19:07:19 -0700
Source: aptitude
Binary: aptitude-doc-cs aptitude-doc-fr aptitude-doc-fi aptitude-doc-en aptitude
Architecture: source all i386
Version: 0.4.4-5~1
Distribution: experimental
Urgency: low
Maintainer: Daniel Burrows <dburrows@debian.org>
Changed-By: Daniel Burrows <dburrows@debian.org>
Description: 
 aptitude   - terminal-based apt frontend
 aptitude-doc-cs - Czech manual for aptitude, a terminal-based apt frontend
 aptitude-doc-en - English manual for aptitude, a terminal-based apt frontend
 aptitude-doc-fi - Finnish manual for aptitude, a terminal-based apt frontend
 aptitude-doc-fr - French manual for aptitude, a terminal-based apt frontend
Closes: 357042 415468 416232 420358 420381 420405 420407
Changes: 
 aptitude (0.4.4-5~1) experimental; urgency=low
 .
     * Eliminate the crashes due to inconsistencies in the dependency
       resolver. (Closes: #420358, #420381, #420407)
 .
       Also added checks for errors that occur in the dependency resolution
       thread, so the program can cleanly generate an error message instead
       of blowing up, and improved the errors generated by consistency checks
       to include more context information.
 .
     * Eliminated a crash with the revdep column generator (Closes: #420405).
 .
     * Add DPKG_NO_TSTP to the environment when doing a package-configure run
       after something failed, so "Z" backgrounding works at the conffile
       prompt. (Closes: #357042)
 .
     * Fix how bolding is performed in the docbook templates for manpages;
       this made the manpages completely unreadable when built with a newer
       Docbook (Closes: #415468, #416232).
Files: 
 93b123e1a8680df109f17d60e7668cbd 807 admin - aptitude_0.4.4-5~1.dsc
 27fa7eb667aa77a66a4d58cc0641cfbc 332868 admin - aptitude_0.4.4-5~1.diff.gz
 2c772d0a3307dff83a79c8dc717da3bf 340490 doc optional aptitude-doc-cs_0.4.4-5~1_all.deb
 55b03ea849bf79b56a75406a59d49830 326046 doc optional aptitude-doc-en_0.4.4-5~1_all.deb
 a8fa18e6a95dbbb06ab34c8692e6346f 257768 doc optional aptitude-doc-fi_0.4.4-5~1_all.deb
 50690bfe9b65b12e26a56567bdc1462c 270874 doc optional aptitude-doc-fr_0.4.4-5~1_all.deb
 2b74a4b573f58914bdd82195d9c4bfb7 2893398 admin important aptitude_0.4.4-5~1_i386.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFGSogwch6xsM7kSXgRAqH5AJ48ZslTuGzhpXCJInmGL5xg6duCewCfbW0W
foGS49v1Ozs50y5TjGd8Aok=
=sdDs
-----END PGP SIGNATURE-----

Send a report that this bug log contains spam.