maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Paul Millar (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (MCOMPILER-334) Missing configuration documentation
Date Thu, 05 Apr 2018 07:39:00 GMT

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

Paul Millar commented on MCOMPILER-334:
---------------------------------------

Yes, that's exactly the information I was after.

Sorry, it was completely unclear to me that the configuration options are goal-specific. 
Options appear to be mostly specified at the generic level (i.e., not within goal-specific
execution blocks).  For example, almost all the given examples are like this.

If I may suggest, perhaps dropping a throw-away sentence in the usage page might help point
other similarly confused people in the right direction.

In any case, feel free to close this ticket.

> Missing configuration documentation
> -----------------------------------
>
>                 Key: MCOMPILER-334
>                 URL: https://issues.apache.org/jira/browse/MCOMPILER-334
>             Project: Maven Compiler Plugin
>          Issue Type: Improvement
>    Affects Versions: 3.5.1
>            Reporter: Paul Millar
>            Priority: Minor
>
> The [Usage page|https://maven.apache.org/plugins/maven-compiler-plugin/usage.html] should
provide information on how to use this plugin.  However, there is almost no mention of the
available configuration options on this page.
> The navigation panel provides links to several example scenarios: [Compile Using A Different
JDK|https://maven.apache.org/plugins/maven-compiler-plugin/examples/compile-using-different-jdk.html],
[Compile Using -source and -target javac Options|https://maven.apache.org/plugins/maven-compiler-plugin/examples/set-compiler-source-and-target.html],
etc.  These are (no doubt) very helpful for people solving those specific problems.  However,
there is apparently no page that provides the authoritative description of available configuration
options.
> Please add a page that provides a list of available configuration options, their expected
formats, the default value (if that option is not specified), and the semantics if the value
is specified.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Mime
View raw message