[
https://jira.codehaus.org/browse/DOXIA-482?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=326369#comment-326369
]
SebbASF commented on DOXIA-482:
-------------------------------
I fully agree that APT comments should be omitted entirely from the output.
This would also be useful for disabling certain sections of the file if they
aren't yet ready for publication.
Also for adding developer notes that don't belong in the final output. etc.
> Give more control over APT comments
> -----------------------------------
>
> Key: DOXIA-482
> URL: https://jira.codehaus.org/browse/DOXIA-482
> Project: Maven Doxia
> Issue Type: Bug
> Components: Module - Apt
> Affects Versions: 1.3
> Reporter: Michael Osipov
>
> 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 is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
