[jira] Created: (DOXIA-445) Extend the macro format supporting line breaks inside APT (multiline macro)

["Juergen Kellerer (JIRA)" <ji...@codehaus.org>]

Extend the macro format supporting line breaks inside APT (multiline macro)
---------------------------------------------------------------------------

                 Key: DOXIA-445
                 URL: https://jira.codehaus.org/browse/DOXIA-445
             Project: Maven Doxia
          Issue Type: Improvement
          Components: Module - Apt
    Affects Versions: 1.1.2
         Environment: Maven 3, Site Plugin 2.1
            Reporter: Juergen Kellerer


Macros inside an APT document can produce quite long lines making them difficult to maintain and read. (This may not be the largest problem with built-in macros, but when you attempt to add your own it can become quite problematic when using more parameters or longer values).

Example "*swf* macro":

{noformat}%{swf|id=MyMovie|src=http://somehost/swf/myfile.swf|width=600|height=200|quality=high|play=true}{noformat}

It would be nice if there was a possibility to use a syntax similar to properties files allowing to add linebreaks to a macro call, e.g.:

{noformat}%{swf|id=MyMovie|src=http://somehost/swf/myfile.swf\
    |width=600|height=200\
    |quality=high|play=true}{noformat}

The logic could be done like: "If a macro line ends with "\", the next line is appending the current line excluding "\" and the leading white spaces of the next line."
This should also not break any existing logic as macros end with "}" normally, so even escaping is not an issue.


--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira