revprop

Darwin Information Typing Architecture (DITA) Version 1.2

Identifies a value in the rev attribute that should be flagged in some manner. Unlike the other conditional processing attributes, which may be used for both filtering and flagging, the rev attribute may only be used for flagging.

It is an error to include more than one <revprop> element with the same @val attribute setting. Recovery from this error is implementation dependent; in such cases processors may, but need not, provide an error or warning message.
When no alternate text is specified for a revision flag, the default alternate text for revprop start of change is a localized translation of "Start of change", and the default alternate text for revprop end of change is a localized translation of "End of change".
The rev attribute identifies when a particular section of a document was added in the lifetime of that document. The attribute is not considered a filtering attribute because this is not sufficient to be used for full version control, such as single-sourcing multiple product variants based on version level – it only represents one aspect of the revision level.

Contains

startflag (optional) then endflag (optional)

Contained by

val

Example

See the example in the <val> description.

Attributes

Name Description Data Type Default Value Required?
val The value to be acted upon. If the val attribute is absent, then the revprop element declares a default behavior for any value in the rev attribute. CDATA #IMPLIED no
action The action to be taken. The options are:
include
Include the content in output without flags. This is the default behavior unless otherwise set.
passthrough
Include the content in output, and preserve the attribute value as part of the output stream for further processing by a runtime engine, for example runtime filtering based on individual user settings. The value should be preserved in whatever syntax is required by the target runtime. Values that are not explicitly passed through should be removed from the output stream, even though the content is still included.
flag
Include and flag the content on output (if the content has not been excluded).
(include | passthrough | flag) #IMPLIED yes
changebar When flag has been set, specify a changebar color, style, or character, according to the changebar support of the target output format. If flag has not been set, this attribute is ignored. CDATA #IMPLIED no
color If flag has been set, the color to use to flag text. Colors may be entered by name or code. Processor support is recommended for the color names listed under the heading "<color>" in http://www.w3.org/TR/2001/REC-xsl-20011015/slice5.html#section-N8794-Property-Datatypes and for the 6 digit hex code form (#rrggbb, case insensitive). If flag has not been set, this attribute is ignored. CDATA #IMPLIED no
backcolor If flag has been set, the color to use as background for flagged text. Colors may be entered by name or code. Processor support is recommended for the color names listed under the heading "<color>" in http://www.w3.org/TR/2001/REC-xsl-20011015/slice5.html#section-N8794-Property-Datatypes and for the 6 digit hex code form (#rrggbb, case insensitive). If flag has not been set, this attribute is ignored. CDATA #IMPLIED no
style If flag has been set, the text style to use for flagged text. The following values are enumerated:
  • underline
  • double-underline
  • italics
  • overline
  • bold
If flag has not been set, this attribute is ignored.
(underline | double-underline | italics | overline | bold) #IMPLIED no