[oXygen-user] Allowed elements in a:documentation?

[George Cristian Bina]

Hi Patrick,

My second part of the answer refers to the fact that in a Relax NG 
grammar you can use any element not in the Relax NG namespace as 
documentation, but not inside a:documentation, instead or at the same 
level with a:documentation:

<grammar xmlns="http://relaxng.org/ns/structure/1.0" 
xmlns:my="http://www.example.com/doc">
     <start>
         <element name="root">
             <my:doc>Root element description... <my:x>It is</my:x> - 
<my:y>empty!</my:y></my:doc>
             <empty/>
         </element>
     </start>
</grammar>

my:doc in the above case is also annotation.

To enable oXygen to present the annotations other than a:documentation 
next to content completion proposals you need to enable the "Use all 
Relax NG annotations as documentation" from Options->Preferences -- 
Editor / Content Completion / Annotations.

You can use also elements inside a:documentation, that is not a Relax NG 
schema error but it will not be according with the DTD compatibility 
spec that defines the a:documentation element.

Best Regards,
George
-- 
George Cristian Bina
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

Patrick Gundlach wrote:
> Hello George,
> 
>> The a:documentation is described in the RELAX NG DTD Compatibility  
>> specification:
>> http://www.oasis-open.org/committees/relax-ng/compatibility.html#IDAC1YR
>>
>> It does not allow any elements inside, only text.
>> Note however that in a Relax NG grammar any element not in the Relax  
>> NG namespace is considered annotation.
> 
> I have to admit that I don't understand your answer fully. The link  
> above tells me, that in <a:documentation> no element is allowed.  
> Right? The second part of your answer is what I don't understand.
> 
> I can, for example, use <br /> in <a:documentation>. That gives me a  
> linebreak in Oxygen. I'd guess that this is non-official?!? I only  
> need it for Oxygen use, so I could live with that. Any more elements  
> Oxygen understands in <a:documentation>? Or is this a "wrong" question?
> 
> Patrick
> 
> 
> _______________________________________________
> oXygen-user mailing list
> 
> http://www.oxygenxml.com/mailman/listinfo/oxygen-user