ctubbsii commented on code in PR #595: URL: https://github.com/apache/maven-apache-parent/pull/595#discussion_r4041421007
########## docs/src/site/markdown/index.md.vm: ########## @@ -0,0 +1,178 @@ +<!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you 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. +--> + +# Apache Software Foundation Parent POM + +This project consists of a POM that contains settings that are likely to be useful to any Apache project that is building and releasing code with Maven. By using this project as a parent, a project gets these settings. + +Most projects will want to override some of these settings. + +The following is a list of the items configured in this POM: + +- Top-level project properties: + - **license**: [Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0.txt). + - **organization**: ${project.organization.name} + - **url**: [`https://www.apache.org/`](https://www.apache.org/). You should override this. + - **repositories**: Optional: the pom adds the Apache snapshot repository ([`https://repository.apache.org/snapshots`](https://repository.apache.org/snapshots)). This only happens if the `apache.snapshots` property is set (set via CLI), or the `use-apache-snapshots` profile is active. + - **distributionManagement**: The POM sets up for releases to the Apache Nexus instance at [`https://repository.apache.org/service/local/staging/deploy/maven2`](https://repository.apache.org/service/local/staging/deploy/maven2) and snapshots to [`https://repository.apache.org/content/repositories/snapshots`](https://repository.apache.org/content/repositories/snapshots). + Note that there are `distMgmt(Releases|Snapshots)(Name|Url)` POM properties (`distMgmtReleasesName`, `distMgmtReleasesUrl`, `distMgmtSnapshotsName` and `distMgmtSnapshotsUrl`) that you can override to change the names and locations. + - **mailingLists**: The POM sets up generic Apache announcement lists. You should override this. + - **javaVersion**: Java version used for compilation, default value is **$context.get("javaVersion")**. + + You can override this property in your project POM to set different Java version for compilation. + + The `javaVersion` property is used to set the `maven.compiler.*` properties, so they should not be set directly in your project POM. + + They will be set automatically according to the JDK used for the project build: + + - for JDK 8 and older + + ```unknown Review Comment: These ```` ```unknown ```` lines should be ```` ```xml ```` -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
