Uploaded image for project: 'Maven Doxia'
  1. Maven Doxia
  2. DOXIA-210

Snippet macro should include whole file if no id is given

    XMLWordPrintableJSON

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 1.0-alpha-9
    • Fix Version/s: 1.1
    • Component/s: Core, Documentation
    • Labels:
      None

      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.

        Attachments

          Activity

            People

            • Assignee:
              ltheussl Lukas Theussl
              Reporter:
              ltheussl Lukas Theussl
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: