← Back to team overview

documentation-packages team mailing list archive

[Bug 1649554] Re: Default Mallard <list> element translated incorrectly

 

> On reflection I think it's best if writers say what kind of <list>
they want.

Agreed.

> The command grep "<list" *.page seems useful in finding pages that may
have problems.

Yes, all other uses should be checked.

I also started looking back through the doc team mail archives for
related discussions, but only got to 2004 before giving up due to a high
number of html e-mails that often trigger the "list" search.

@Chris: Note that it might not always be a bug if the html display
differs from the Mallard specification. The whole purpose of the
ubuntu.xsl file is to provide overrides to the defaults, in addition to
adding some functionality.

-- 
You received this bug notification because you are a member of
Documentation Packages, which is subscribed to ubuntu-docs in Ubuntu.
https://bugs.launchpad.net/bugs/1649554

Title:
  Default Mallard <list> element translated incorrectly

Status in ubuntu-docs package in Ubuntu:
  Fix Committed

Bug description:
  When "type" is not specified in a Mallard <list> element the Mallard
  spec says it should display as a bulleted (unordered) list. This is
  true when the .page file is displayed using yelp but not when the
  .page file is translated into HTML (where you get a numbered list).
  This is a bug. The HTML should be displayed as specified by the
  Mallard spec.

  Here's an example <list> element without "type" specified.

  <list>
    <item><p><code>GTK_MESSAGE_INFO</code></p></item>
    <item><p><code>GTK_MESSAGE_WARNING</code></p></item>
    <item><p><code>GTK_MESSAGE_QUESTION</code></p></item>
    <item><p><code>GTK_MESSAGE_ERROR</code></p></item>
    <item><p><code>GTK_MESSAGE_OTHER</code></p></item>
  </list>

  Here's the link to the relevant page of the Mallard spec:

  http://projectmallard.org/1.0/mal_block_list

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs/+bug/1649554/+subscriptions


References