[GitHub] [maven] michael-o commented on a change in pull request #463: Extend mvn help text for various features of Maven 4.0.0

2021-04-05 Thread GitBox


michael-o commented on a change in pull request #463:
URL: https://github.com/apache/maven/pull/463#discussion_r607034802



##
File path: maven-embedder/src/main/java/org/apache/maven/cli/CLIManager.java
##
@@ -121,11 +121,11 @@ public CLIManager()
 options.addOption( Option.builder( Character.toString( QUIET ) 
).longOpt( "quiet" ).desc( "Quiet output - only show errors" ).build() );
 options.addOption( Option.builder( Character.toString( DEBUG ) 
).longOpt( "debug" ).desc( "Produce execution debug output" ).build() );
 options.addOption( Option.builder( Character.toString( ERRORS ) 
).longOpt( "errors" ).desc( "Produce execution error messages" ).build() );
-options.addOption( Option.builder( Character.toString( NON_RECURSIVE ) 
).longOpt( "non-recursive" ).desc( "Do not recurse into sub-projects" ).build() 
);
+options.addOption( Option.builder( Character.toString( NON_RECURSIVE ) 
).longOpt( "non-recursive" ).desc( "Do not recurse into sub-projects. When used 
together with -pl, do not recurse into sub-projects of selected aggregators" 
).build() );
 options.addOption( Option.builder( Character.toString( 
UPDATE_SNAPSHOTS ) ).longOpt( "update-snapshots" ).desc( "Forces a check for 
missing releases and updated snapshots on remote repositories" ).build() );
-options.addOption( Option.builder( Character.toString( 
ACTIVATE_PROFILES ) ).longOpt( "activate-profiles" ).desc( "Comma-delimited 
list of profiles to activate" ).hasArg().build() );
+options.addOption( Option.builder( Character.toString( 
ACTIVATE_PROFILES ) ).longOpt( "activate-profiles" ).desc( "Comma-delimited 
list of profiles to activate. Prefixing a profile with ! excludes it, and ? 
marks it as optional" ).hasArg().build() );

Review comment:
   OK guys, let's add as-is and re-review as a whole later.




-- 
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.

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org




[GitHub] [maven] michael-o commented on a change in pull request #463: Extend mvn help text for various features of Maven 4.0.0

2021-04-02 Thread GitBox


michael-o commented on a change in pull request #463:
URL: https://github.com/apache/maven/pull/463#discussion_r606207118



##
File path: maven-embedder/src/main/java/org/apache/maven/cli/CLIManager.java
##
@@ -121,11 +121,11 @@ public CLIManager()
 options.addOption( Option.builder( Character.toString( QUIET ) 
).longOpt( "quiet" ).desc( "Quiet output - only show errors" ).build() );
 options.addOption( Option.builder( Character.toString( DEBUG ) 
).longOpt( "debug" ).desc( "Produce execution debug output" ).build() );
 options.addOption( Option.builder( Character.toString( ERRORS ) 
).longOpt( "errors" ).desc( "Produce execution error messages" ).build() );
-options.addOption( Option.builder( Character.toString( NON_RECURSIVE ) 
).longOpt( "non-recursive" ).desc( "Do not recurse into sub-projects" ).build() 
);
+options.addOption( Option.builder( Character.toString( NON_RECURSIVE ) 
).longOpt( "non-recursive" ).desc( "Do not recurse into sub-projects. When used 
together with -pl, do not recurse into sub-projects of selected aggregators" 
).build() );
 options.addOption( Option.builder( Character.toString( 
UPDATE_SNAPSHOTS ) ).longOpt( "update-snapshots" ).desc( "Forces a check for 
missing releases and updated snapshots on remote repositories" ).build() );
-options.addOption( Option.builder( Character.toString( 
ACTIVATE_PROFILES ) ).longOpt( "activate-profiles" ).desc( "Comma-delimited 
list of profiles to activate" ).hasArg().build() );
+options.addOption( Option.builder( Character.toString( 
ACTIVATE_PROFILES ) ).longOpt( "activate-profiles" ).desc( "Comma-delimited 
list of profiles to activate. Prefixing a profile with ! excludes it, and ? 
marks it as optional" ).hasArg().build() );

Review comment:
   I would rather write: ...with an exclamation mark (!) ex, and 
question mark (?) marks it...

##
File path: maven-embedder/src/main/java/org/apache/maven/cli/CLIManager.java
##
@@ -136,9 +136,9 @@ public CLIManager()
 options.addOption( Option.builder( FAIL_FAST ).longOpt( "fail-fast" 
).desc( "Stop at first failure in reactorized builds" ).build() );
 options.addOption( Option.builder( FAIL_AT_END ).longOpt( 
"fail-at-end" ).desc( "Only fail the build afterwards; allow all non-impacted 
builds to continue" ).build() );
 options.addOption( Option.builder( FAIL_NEVER ).longOpt( "fail-never" 
).desc( "NEVER fail the build, regardless of project result" ).build() );
-options.addOption( Option.builder( RESUME ).longOpt( "resume" ).desc( 
"Resume reactor from the last failed project, using the resume.properties file 
in the build directory " ).build() );
+options.addOption( Option.builder( RESUME ).longOpt( "resume" ).desc( 
"Resume reactor from the last failed project, using the resume.properties file 
in the build directory" ).build() );
 options.addOption( Option.builder( RESUME_FROM ).longOpt( 
"resume-from" ).hasArg().desc( "Resume reactor from specified project" 
).build() );
-options.addOption( Option.builder( PROJECT_LIST ).longOpt( "projects" 
).desc( "Comma-delimited list of specified reactor projects to build instead of 
all projects. A project can be specified by [groupId]:artifactId or by its 
relative path" ).hasArg().build() );
+options.addOption( Option.builder( PROJECT_LIST ).longOpt( "projects" 
).desc( "Comma-delimited list of specified reactor projects to build instead of 
all projects. A project can be specified by [groupId]:artifactId or by its 
relative path. Prefixing a project with ! excludes it, and ? marks it as 
optional" ).hasArg().build() );

Review comment:
   Same here




-- 
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.

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org