[jira] [Commented] (DOXIA-482) add an API to avoid translating APT source comments into output comments

["Michael Osipov (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/DOXIA-482?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15115996#comment-15115996 ] 

Michael Osipov commented on DOXIA-482:
--------------------------------------

SSIs abuse comments. They should rather be processing instructions.

> add an API to avoid translating APT source comments into output comments
> ------------------------------------------------------------------------
>
>                 Key: DOXIA-482
>                 URL: https://issues.apache.org/jira/browse/DOXIA-482
>             Project: Maven Doxia
>          Issue Type: Bug
>          Components: Module - Apt
>    Affects Versions: 1.3
>            Reporter: Michael Osipov
>            Assignee: Michael Osipov
>             Fix For: 1.7
>
>         Attachments: DOXIA-482.patch
>
>
> I have defined this as the very first lines in my apt file:
> {code}
> ~~ Copyright 2012 Michael Osipov
> ~~
> ~~ Licensed under the Apache License, Version 2.0 (the "License");
> ~~ you may not use this file except in compliance with the License.
> ~~ You may obtain a copy of the License at
> ~~
> ~~     http://www.apache.org/licenses/LICENSE-2.0
> ~~
> ~~ Unless required by applicable law or agreed to in writing, software
> ~~ distributed under the License is distributed on an "AS IS" BASIS,
> ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
> ~~ See the License for the specific language governing permissions and
> ~~ limitations under the License.
> ~~ $Id$
> {code}
> This is unfortunately translated in
> {{/html/body/div/div/div#bodyColumn}} to a line-by-line comment
> {noformat}
> <!-- Copyright 2012 Michael Osipov --><!--  --><!-- Licensed under the Apache License, Version 2.0 (the "License"); --><!-- you may not use this file except in compliance with the License. --><!-- You may obtain a copy of the License at --><!--  --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!--  --><!-- Unless required by applicable law or agreed to in writing, software --><!-- distributed under the License is distributed on an "AS IS" BASIS, --><!-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. --><!-- See the License for the specific language governing permissions and --><!-- limitations under the License. --><!-- $Id$ -->
> {noformat}
> This, of course, is somewhat useless. I'd rather would have split comments like in JSP or Velocity. Template comments are left out and HTML comments remain untouched.
> I obviously do not need the ASL somewhere in the middle of by page as comment.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)