desruisseaux commented on code in PR #2061:
URL: https://github.com/apache/maven/pull/2061#discussion_r1929880442
##########
api/maven-api-model/src/main/mdo/maven.mdo:
##########
@@ -775,28 +775,30 @@
<type>String</type>
</field>
<field>
- <!-- TODO: replaced by <Source> with "main" scope and "resources"
language -->
<name>resources</name>
<version>3.0.0+</version>
<description>
This element describes all the classpath resources such as
properties
files associated with a project. These resources are often
included in the final
package.
The default value is {@code src/main/resources}.
+
+ @deprecated Replaced by <Source> with "main" scope and
"resources" language.
Review Comment:
`{@code]` escapes HTML characters, so the output would really be
`<Source>` in the Javadoc. If it was a Java file, I would have written
{@code <Source>} (allowing direct use of `<` and `>` are the purpose of
`{@code]` and `{@literal]`). But since this is a `.mdo` file, I wasn't sure if
`<Source>` wouldn't be interpreted as XML. I thought that escaping the XML
characters was the safest, which means that I cannot put them in a`{@code]`
element.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscr...@maven.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
