A couple of DocBook style questions

[Jeff Schering]

On 2/13/06, Matthew East <mdke at ubuntu.com> wrote:
>
> Another style I think we should adopt: as discussed on irc earlier today
> with Brian: the method of advising users to install packages is dodgy at
> the moment. Instead of:
>
> [quote]
> * Add the X repository
> * Install:
>         Programming (universe) -> Bluefish
> [/quote]
>
> We'd like to do this:
>
> [quote]
> * Install <application>Bluefish</application> from the Multiverse
> repository (see <xref linkend="add-applications"/>).
> [/quote]
>
Here's how it's done in the internet section of common-tasks.xml:
[quote]
2.4.4.1. Macromedia Flash for Mozilla Firefox

   1.      Make sure the multiverse repository is enabled. (See Adding
Extra Repositories)
   2.      Install the flashplayer-mozilla package with Add/Remove
Applications (See Section 1.3 ― Adding, Removing and Updating
Applications)

      World Wide Web (multiverse) > flashplayer-mozilla

   3.      The plug-in will be available the next time you start Firefox.
[/quote]

> I'd also suggest that we use the <filename> tags around names of
> repositories, because that makes them stand out a bit, in monospace,
> which is nice I think.

It's better to use the <emphasis> tag for this, I think..

Cheers,
Jeff
--
Jeff Schering
GPG: F23C67E8