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

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.3
• Fix Version/s: 1.7
• Component/s: Module - Apt
• Assignee: Herve Boutemy
• Reporter: Michael Osipov
• Created: 03/Jan/13 15:07
• Updated: 25/Mar/17 17:15
• Resolved: 02/Feb/16 20:35

Description

I have defined this as the very first lines in my apt file:

~~ 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$

This is unfortunately translated in
/html/body/div/div/div#bodyColumn to a line-by-line comment

<!-- 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$ -->

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.

Issue Links

• is depended upon by: DOXIASITETOOLS-146 don't translate APT source comments into output comments
• relates to: DOXIA-532 Update handling of comments for Server Side Includes (ie comments starting with #)
• supercedes: DOXIA-536 AptParser does not force linebreak in Sink after a comment is written