Re: [docbook-apps] DocBook Elements for Specific Comments

["Bob Stayton" <bobs@sagehill.net>]

If you are using DocBook 5, then the annotation element is useful for such 
purposes, although remark is simpler and still available.  Annotations are 
not output by default, so some customization is required. See:

http://www.docbook.org/tdg5/en/html/annotation.html
and
http://www.sagehill.net/docbookxsl/CustomDb5Xsl.html#AnnotationCustomization

If you are using DocBook4, then remark can be used, with the stylesheet 
parameter show.comments set to 1 to display them (that is the default) or 0 
to turn them off.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- 
From: "Betty Ing" <ingbe@mcmaster.ca>
To: <docbook-apps@lists.oasis-open.org>
Sent: Wednesday, April 22, 2009 10:49 AM
Subject: [docbook-apps] DocBook Elements for Specific Comments


> Hello,
>
> What are some options for marking up comments that relate to the
> following types of text in a document:
>
> 1. content that needs clarification
> 2. ideas for future development
>
> I had a look at <remark>, but are there other solutions?
>
> Thanks.
>
> Betty
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
>