← Back to team overview

documentation-packages team mailing list archive

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


About 60 pages in the desktop help use <list> elements. (I listed them
using the command grep "<list" *.page.) Can I go through them and (where
possible) tidy up the help by putting in type="disc" (that's the bullet
style that we are using)? I was planning to do the changes manually -
not of course via a global replace - each time checking the html (but
not checking the page appearance using yelp).

Most of the uses of <list> seem straightforward. However, there's a
handful of unusual/complicated uses, which I may well leave alone. (If
in doubt, leave it alone.)

So far I've noticed three short procedures that have been wrongly marked
up using <list>, so I'm planning to change those too. They'll be changed
to <steps> elements.

I'll just be changing markup (not the English text) so there is (surely)
no impact on the translators. This is basically a simple job (though
there are 60 pages to check). Can anything go wrong?

You received this bug notification because you are a member of
Documentation Packages, which is subscribed to ubuntu-docs in Ubuntu.

  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.


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


To manage notifications about this bug go to: