[DOXIA-210] Snippet macro should include whole file if no id is given

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.0-alpha-9
• Fix Version/s: 1.1
• Component/s: Core, Documentation
• Assignee: Lukas Theussl
• Reporter: Lukas Theussl
• Created: 04/Feb/08 10:13
• Updated: 07/Apr/15 18:15
• Resolved: 07/Feb/08 07:02

Description

Currently the snippet macro requires an id attribute, and snippets are only included if they are enclosed with the START and END demarcators. However, neither id nor demarcators are necessary if you want to include an entire file. I'd suggest to allow the following:

 
%{snippet|file=path/to/file.txt}
 

which will include the whole file.txt.

Note also that the documentation at http://maven.apache.org/doxia/macros/index.html seems misleading, as it says that the demarcators are only needed if you want to include part of a file.