OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [dita] Groups - Issue 12060 (coderef element) (IssueNumber12060.html)uploaded

mpriestl@ca.ibm.com wrote:
> The document named Issue 12060 (coderef element) (IssueNumber12060.html)
> has been submitted by Michael Priestley to the OASIS Darwin Information
> Typing Architecture (DITA) TC document repository.

The current wording:

"Create new coderef element modelled after xref, with equivalent 
attributes but no subelements, since the purpose of the element is to 
pull in the targetted file into the containing codeblock element, 
massaging < and > characters as necessary to make it valid CDATA."

Inappropriately describes a transformation, as though the processing 
result was *always* to literally embed the referenced content in some 
new XML instance.

It should simply say something like:

"the purpose is to present the literal character content of the 
referenced resource as though it occurred at the point of reference 
(e.g., within a CDATA marked section or with any XML markup characters 



Eliot Kimber
Senior Solutions Architect
"Bringing Strategy, Content, and Technology Together"
Main: 610.631.6770

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]