[RUNTIME-28] documentation of include directive in block.xml for included files

• Type: Bug
• Status: Closed
• Priority: Trivial
• Resolution: Won't Fix
• Affects Version/s: 3.2.5, 3.3.0
• Fix Version/s: 3.4.0
• Component/s: COMPOSITION
• Environment: All
• Assignee: Unassigned
• Reporter: Cameron Fieber
• Created: 15/May/04 05:55
• Updated: 13/Nov/04 02:14
• Resolved: 13/Nov/04 02:14

Description

Documentation and behaviour of the include directive for including files in block.xml are out of sync.

Documentation examples show the include like:

<include path="file.xml">
or
<include>
<source path="file.xml">
</include>
and doesn't clearly state that the name is required on the include.

In:
avalon/composition/impl/src/java/org/apache/avalon/composition/data/builder/XMLContainmentProfileCreator.java
On line 561:
It is requiring the name attribute

On line 584:
It is getting the value of source element

The result is that the block.xml that must conform to:
<include name="required">
<source>file.xml</source>
</include>

I'd have included a patch, but I don't know what needs to change, the doc or the code