If you plan on including images in your HOWTOs, you can now do this, as LinuxDoc didn't support images. Here's a sample way of including an image in your HOWTOS:
<figure> <title>LyX screen shot</title> <mediaobject> <imageobject> <imagedata fileref="lyx_screenshot.eps" format="eps"> </imageobject> <imageobject> <imagedata fileref="lyx_screenshot.jpg" format="jpg"> </imageobject> <textobject> <phrase>Screen shot of the LyX document processing program</phrase> </textobject> </mediaobject> </figure>
This is a better way than using <graphic> for two reasons. First, <graphic> will be removed in DocBook 5.0 in favor of the <mediaobject> tag. So you may as well get started with the right way now. Second, <mediaobject> allows for different kinds of media based on what the output is. In this example, the first <imageobject> is an encapsulated PostScript(eps) file for use with formats derived from TeX such as DVI, PS, and PDF. The second <imageobject> is a JPEG image for visual display, mostly for HTML output. The <textobject> is presented if the output doesn't support graphics (TXT). Think of it as an HTML <alt> tag.