You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by kw...@apache.org on 2025/08/03 11:29:39 UTC
(maven-scm) branch master updated (3e6a34e5e -> d5c82e157)
This is an automated email from the ASF dual-hosted git repository.
kwin pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/maven-scm.git
from 3e6a34e5e JGit: Propagate exceptions when pushing tags/branches (#1271)
new f40ae649f Move to match target converter format MARKDOWN with doxia-converter
new 3ebdedf9f Migrate to Markdown format
new d5c82e157 Further cleanup of site
The 3 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../apache/maven/scm/plugin/AbstractScmMojo.java | 4 +-
maven-scm-providers/maven-scm-provider-hg/pom.xml | 2 +-
.../maven-scm-provider-gitexe/pom.xml | 2 +-
.../maven-scm-providers-git/pom.xml | 2 +-
.../maven-scm-provider-svnexe/pom.xml | 2 +-
pom.xml | 3 +
src/site/apt/git.apt | 83 -----
src/site/apt/guide/define_provider.apt | 77 -----
src/site/apt/guide/index.apt | 37 ---
src/site/apt/guide/new_provider.apt | 255 ---------------
src/site/apt/index.apt | 42 ---
src/site/apt/local.apt | 55 ----
src/site/apt/mercurial.apt | 57 ----
src/site/apt/scm-commands.apt | 75 -----
src/site/apt/scm-url-format.apt | 47 ---
src/site/apt/scms-overview.apt | 45 ---
src/site/apt/subversion.apt | 72 ----
src/site/markdown/git.md | 79 +++++
src/site/markdown/guide/define_provider.md | 67 ++++
src/site/markdown/guide/index.md | 35 ++
src/site/markdown/guide/new_provider.md | 208 ++++++++++++
.../guide/usage.apt => markdown/guide/usage.md} | 121 ++++---
src/site/markdown/index.md | 33 ++
src/site/markdown/local.md | 52 +++
src/site/markdown/mercurial.md | 54 +++
src/site/markdown/scm-commands.md | 69 ++++
src/site/markdown/scm-url-format.md | 41 +++
src/site/markdown/scms-overview.md | 49 +++
src/site/markdown/subversion.md | 69 ++++
src/site/resources/.htaccess | 1 +
src/site/resources/images/check.gif | Bin 604 -> 0 bytes
src/site/resources/images/error.gif | Bin 633 -> 0 bytes
src/site/resources/images/forbidden.gif | Bin 613 -> 0 bytes
src/site/site.xml | 9 +-
src/site/xdoc/matrix.xml | 361 ---------------------
35 files changed, 827 insertions(+), 1281 deletions(-)
delete mode 100644 src/site/apt/git.apt
delete mode 100644 src/site/apt/guide/define_provider.apt
delete mode 100644 src/site/apt/guide/index.apt
delete mode 100644 src/site/apt/guide/new_provider.apt
delete mode 100644 src/site/apt/index.apt
delete mode 100644 src/site/apt/local.apt
delete mode 100644 src/site/apt/mercurial.apt
delete mode 100644 src/site/apt/scm-commands.apt
delete mode 100644 src/site/apt/scm-url-format.apt
delete mode 100644 src/site/apt/scms-overview.apt
delete mode 100644 src/site/apt/subversion.apt
create mode 100644 src/site/markdown/git.md
create mode 100644 src/site/markdown/guide/define_provider.md
create mode 100644 src/site/markdown/guide/index.md
create mode 100644 src/site/markdown/guide/new_provider.md
rename src/site/{apt/guide/usage.apt => markdown/guide/usage.md} (59%)
create mode 100644 src/site/markdown/index.md
create mode 100644 src/site/markdown/local.md
create mode 100644 src/site/markdown/mercurial.md
create mode 100644 src/site/markdown/scm-commands.md
create mode 100644 src/site/markdown/scm-url-format.md
create mode 100644 src/site/markdown/scms-overview.md
create mode 100644 src/site/markdown/subversion.md
create mode 100644 src/site/resources/.htaccess
delete mode 100644 src/site/resources/images/check.gif
delete mode 100644 src/site/resources/images/error.gif
delete mode 100644 src/site/resources/images/forbidden.gif
delete mode 100644 src/site/xdoc/matrix.xml
(maven-scm) 03/03: Further cleanup of site
Posted by kw...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
kwin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-scm.git
commit d5c82e1570e64d61551878137ad8ff3658cbf59c
Author: Konrad Windszus <kw...@apache.org>
AuthorDate: Sun Aug 3 13:04:00 2025 +0200
Further cleanup of site
Removal of outdated matrix. Fix links to SCM documentation sites. Link
to SCM commands from the site navigation
---
.../apache/maven/scm/plugin/AbstractScmMojo.java | 4 +-
maven-scm-providers/maven-scm-provider-hg/pom.xml | 2 +-
.../maven-scm-provider-gitexe/pom.xml | 2 +-
.../maven-scm-providers-git/pom.xml | 2 +-
.../maven-scm-provider-svnexe/pom.xml | 2 +-
pom.xml | 1 +
src/site/markdown/git.md | 2 +-
src/site/markdown/mercurial.md | 2 +-
src/site/markdown/scm-commands.md | 2 +-
src/site/markdown/scm-url-format.md | 2 +-
src/site/markdown/scms-overview.md | 26 +-
src/site/markdown/subversion.md | 2 +-
src/site/resources/.htaccess | 1 +
src/site/resources/images/check.gif | Bin 604 -> 0 bytes
src/site/resources/images/error.gif | Bin 633 -> 0 bytes
src/site/resources/images/forbidden.gif | Bin 613 -> 0 bytes
src/site/site.xml | 9 +-
src/site/xdoc/matrix.xml | 361 ---------------------
18 files changed, 37 insertions(+), 383 deletions(-)
diff --git a/maven-scm-plugin/src/main/java/org/apache/maven/scm/plugin/AbstractScmMojo.java b/maven-scm-plugin/src/main/java/org/apache/maven/scm/plugin/AbstractScmMojo.java
index c8cdda42d..9d1de33bd 100644
--- a/maven-scm-plugin/src/main/java/org/apache/maven/scm/plugin/AbstractScmMojo.java
+++ b/maven-scm-plugin/src/main/java/org/apache/maven/scm/plugin/AbstractScmMojo.java
@@ -153,7 +153,9 @@ public abstract class AbstractScmMojo extends AbstractMojo {
private Properties systemProperties;
/**
- * List of provider implementations.
+ * List of remapped provider implementations. Allows to bind a different implementation than the default one to a provider id.
+ * The key is the remapped provider id, the value is the default provider id the implementation is bound to.
+ * @see <a href="https://maven.apache.org/scm/scms-overview.html">Supported SCMs</a>
*/
@Parameter
private Map<String, String> providerImplementations;
diff --git a/maven-scm-providers/maven-scm-provider-hg/pom.xml b/maven-scm-providers/maven-scm-provider-hg/pom.xml
index a2b34992b..a3531ec8f 100644
--- a/maven-scm-providers/maven-scm-provider-hg/pom.xml
+++ b/maven-scm-providers/maven-scm-provider-hg/pom.xml
@@ -29,7 +29,7 @@
<artifactId>maven-scm-provider-hg</artifactId>
<name>Maven SCM Mercurial (Hg) Provider</name>
- <description>SCM Provider implementation for Mercurial Hg (http://www.selenic.com/mercurial/wiki/).</description>
+ <description>SCM Provider implementation for Mercurial Hg (https://www.mercurial-scm.org/) relying on the HG CLI.</description>
<contributors>
<contributor>
diff --git a/maven-scm-providers/maven-scm-providers-git/maven-scm-provider-gitexe/pom.xml b/maven-scm-providers/maven-scm-providers-git/maven-scm-provider-gitexe/pom.xml
index 816dcf7ae..23ef851c5 100644
--- a/maven-scm-providers/maven-scm-providers-git/maven-scm-provider-gitexe/pom.xml
+++ b/maven-scm-providers/maven-scm-providers-git/maven-scm-provider-gitexe/pom.xml
@@ -29,7 +29,7 @@
<artifactId>maven-scm-provider-gitexe</artifactId>
<name>Maven SCM Git Provider - Git Executable Impl.</name>
- <description>Executable implementation for SCM Git Provider.</description>
+ <description>SCM Git Provider relying on the Git CLI</description>
<dependencies>
<dependency>
diff --git a/maven-scm-providers/maven-scm-providers-git/pom.xml b/maven-scm-providers/maven-scm-providers-git/pom.xml
index 398ac7011..c190886e5 100644
--- a/maven-scm-providers/maven-scm-providers-git/pom.xml
+++ b/maven-scm-providers/maven-scm-providers-git/pom.xml
@@ -30,7 +30,7 @@
<packaging>pom</packaging>
<name>Maven SCM Git Provider - Parent</name>
- <description>SCM Provider implementation for Git (http://git.or.cz/).</description>
+ <description>SCM Provider implementation for Git (https://git-scm.com/).</description>
<modules>
<module>maven-scm-provider-git-commons</module>
diff --git a/maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svnexe/pom.xml b/maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svnexe/pom.xml
index 7e2392ce9..f2de38d0f 100644
--- a/maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svnexe/pom.xml
+++ b/maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svnexe/pom.xml
@@ -29,7 +29,7 @@
<artifactId>maven-scm-provider-svnexe</artifactId>
<name>Maven SCM Subversion Provider - SVN Executable Impl.</name>
- <description>Executable library for SCM SVN Provider.</description>
+ <description>SCM SVN Provider relying on the SVN CLI</description>
<contributors>
<contributor>
diff --git a/pom.xml b/pom.xml
index ecff8482d..80826030e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -346,6 +346,7 @@
<exclude>src/main/resources/tck/**</exclude>
<exclude>.travis.yml</exclude>
<exclude>nbactions.xml</exclude>
+ <exclude>src/site/resources/.htaccess</exclude>
</excludes>
</configuration>
</plugin>
diff --git a/src/site/markdown/git.md b/src/site/markdown/git.md
index 37fa336c5..a1887fe3a 100644
--- a/src/site/markdown/git.md
+++ b/src/site/markdown/git.md
@@ -27,7 +27,7 @@ date: 2008-08-10
## General Info
-Link: [http://git-scm.com/](http://git-scm.com/)
+Link: <https://git-scm.com/>
License: GNU General Public License v2
diff --git a/src/site/markdown/mercurial.md b/src/site/markdown/mercurial.md
index 97670523e..aa55bb03d 100644
--- a/src/site/markdown/mercurial.md
+++ b/src/site/markdown/mercurial.md
@@ -27,7 +27,7 @@ date: 2007-04-12
## General Info
-Link: [http://www.selenic.com/mercurial/wiki/](http://www.selenic.com/mercurial/wiki/)
+Link: <https://www.mercurial-scm.org/>
License: GNU General Public License
diff --git a/src/site/markdown/scm-commands.md b/src/site/markdown/scm-commands.md
index 632029f33..03a9c2672 100644
--- a/src/site/markdown/scm-commands.md
+++ b/src/site/markdown/scm-commands.md
@@ -25,7 +25,7 @@ date: 2005-12-01
<!-- http://maven.apache.org/doxia/references/apt-format.html-->
# Maven SCM Commands
-Maven SCM uses a exposes a fixed set of commands for it users. The providers for each SCM must implements those commands through the ScmProvider interface. This is an overview of all the commands:
+Maven SCM uses a exposes a fixed set of commands for it users. The providers for each SCM must implements those commands through the `ScmProvider` interface. This is an overview of all the commands:
## Add
diff --git a/src/site/markdown/scm-url-format.md b/src/site/markdown/scm-url-format.md
index 4e9a2d364..b9fd92305 100644
--- a/src/site/markdown/scm-url-format.md
+++ b/src/site/markdown/scm-url-format.md
@@ -37,5 +37,5 @@ As delimiter you can use either colon `:` or a pipe `|`, if you use a colon for
For information about supported provider IDs and the provider-specific part, see the appropriate [SCM implementation](./scms-overview.html).
-Provider IDs may be mapped with the help of the plugin parameter `providerImplementations` supported by both [maven-release-plugin](https://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html#providerImplementations) and [maven-scm-plugin](./maven-scm-plugin/checkout-mojo.html#providerImplementations).
+Provider IDs may be remapped with the help of the plugin parameter `providerImplementations` supported by both [maven-release-plugin](https://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html#providerImplementations) and [maven-scm-plugin](./maven-scm-plugin/checkout-mojo.html#providerImplementations).
diff --git a/src/site/markdown/scms-overview.md b/src/site/markdown/scms-overview.md
index 10332be3d..58852f21d 100644
--- a/src/site/markdown/scms-overview.md
+++ b/src/site/markdown/scms-overview.md
@@ -25,13 +25,25 @@ date: 2005-12-01
<!-- http://maven.apache.org/doxia/references/apt-format.html-->
# Overview of SCMs
-This is a list of all standard SCMs:
+## Standard SCM Providers
+
+These SCMs are supported with their providers shipping with maven-scm
| | | |
|:---:|:---:|:---:|
-|**SCM**|**Provider ID**|**Provider Module**|
-|[Git](./git.html)|`git`|[Git Executable Provider](./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-gitexe/index.html)|
-|[Git](./git.html)|`jgit`|[JGit Provider](./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-jgit/index.html)|
-|[Subversion](./subversion.html)|`svn`|[SVN Executable Provider](./maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svnexe/index.html)|
-|[Mercurial](./mercurial.html)|`hg`|[Mercurial \(Hg\) Provider](./maven-scm-providers/maven-scm-provider-hg/index.html)|
-|[Local](./local.html)|`local`|[Local Provider](./maven-scm-providers/maven-scm-provider-local/index.html)|
+|**SCM**|**Provider ID**|**Provider Module**|**Native Java**
+|[Git](./git.html)|`git`|[Git Executable Provider](./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-gitexe/index.html)|no
+|[Git](./git.html)|`jgit`|[JGit Provider](./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-jgit/index.html)|yes
+|[Subversion](./subversion.html)|`svn`|[SVN Executable Provider](./maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svnexe/index.html)|no
+|[Mercurial](./mercurial.html)|`hg`|[Mercurial \(Hg\) Provider](./maven-scm-providers/maven-scm-provider-hg/index.html)|no
+|[Local](./local.html)|`local`|[Local Provider](./maven-scm-providers/maven-scm-provider-local/index.html)|yes
+
+## 3rd Party SCM Providers
+
+- [maven-scm-provider-svnjava](https://github.com/olamy/maven-scm-provider-svnjava): Native Java SVN provider based on SVNKit
+
+## Related Links
+
+- [Comparison of revision control software](https://en.wikipedia.org/wiki/Comparison_of_revision_control_software)
+- [SCM Common vocabulary](https://en.wikipedia.org/wiki/Source_Code_Management#Common_vocabulary)
+- [Outdated Wiki page of Maven SCM Support Matrix](https://cwiki.apache.org/confluence/display/MAVENSCM/SCM+Matrix)
\ No newline at end of file
diff --git a/src/site/markdown/subversion.md b/src/site/markdown/subversion.md
index 7d936d05e..18e2a5882 100644
--- a/src/site/markdown/subversion.md
+++ b/src/site/markdown/subversion.md
@@ -28,7 +28,7 @@ date: 2011-05-15
## General Info
-Link: [http://subversion.apache.org/](http://subversion.apache.org/)
+Link: <https://subversion.apache.org/>
License: Apache License, Version 2\.0
diff --git a/src/site/resources/.htaccess b/src/site/resources/.htaccess
new file mode 100644
index 000000000..3b3cf75d7
--- /dev/null
+++ b/src/site/resources/.htaccess
@@ -0,0 +1 @@
+Redirect Permanent /matrix.html /scms-overview.html
\ No newline at end of file
diff --git a/src/site/resources/images/check.gif b/src/site/resources/images/check.gif
deleted file mode 100644
index 28bb99943..000000000
Binary files a/src/site/resources/images/check.gif and /dev/null differ
diff --git a/src/site/resources/images/error.gif b/src/site/resources/images/error.gif
deleted file mode 100644
index 6d68a8cc0..000000000
Binary files a/src/site/resources/images/error.gif and /dev/null differ
diff --git a/src/site/resources/images/forbidden.gif b/src/site/resources/images/forbidden.gif
deleted file mode 100644
index c6acdec60..000000000
Binary files a/src/site/resources/images/forbidden.gif and /dev/null differ
diff --git a/src/site/site.xml b/src/site/site.xml
index b6a6a153e..7a0bf5c95 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -18,9 +18,8 @@
~ under the License.
-->
-<project xmlns="http://maven.apache.org/DECORATION/1.0.0"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://maven.apache.org/DECORATION/1.0.0 http://maven.apache.org/xsd/decoration-1.0.0.xsd"
+<site xmlns="http://maven.apache.org/SITE/2.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SITE/2.0.0 https://maven.apache.org/xsd/site-2.0.0.xsd"
name="Apache Maven SCM">
<body>
@@ -35,11 +34,11 @@
<item name="Local" href="/local.html"/>
<item name="Subversion" href="/subversion.html"/>
</item>
+ <item name="SCM Commands" href="/scm-commands.html"/>
<item name="Guides" href="/guide/index.html" collapse="true">
<item name="How to use Maven SCM in my application" href="/guide/usage.html"/>
<item name="How to write a new SCM provider" href="/guide/new_provider.html"/>
</item>
- <item name="SCM Providers Matrix" href="/matrix.html"/>
<!-- According to https://issues.apache.org/jira/browse/MNGSITE-152 -->
<item name="License" href="http://www.apache.org/licenses/"/>
<item name="Download" href="download.html"/>
@@ -48,4 +47,4 @@
<menu ref="modules"/>
<menu ref="reports"/>
</body>
-</project>
+</site>
diff --git a/src/site/xdoc/matrix.xml b/src/site/xdoc/matrix.xml
deleted file mode 100644
index 8da8c6a2e..000000000
--- a/src/site/xdoc/matrix.xml
+++ /dev/null
@@ -1,361 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1" ?>
-
-<!--
-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.
--->
-
-<document>
- <properties>
- <title>Maven SCM Providers Matrix</title>
- <author email="vsiveton@apache.org">Vincent Siveton</author>
- </properties>
-
- <body>
- <section name="Maven SCM Providers Matrix">
- <p>This matrix presents all SCM providers actually supported by the Maven SCM project.</p>
- <table>
- <tbody>
- <tr>
- <th> SCM </th>
- <th> add </th>
- <th> blame </th>
- <th> branch </th>
- <th> changelog </th>
- <th> checkin </th>
- <th> checkout </th>
- <th> diff </th>
- <th> edit </th>
- <th> export </th>
- <th> list </th>
- <th> login </th>
- <th> remove </th>
- <th> status </th>
- <th> tag </th>
- <th> unedit </th>
- <th> update </th>
- <th> Pure Java </th>
- </tr>
- <tr>
- <!-- SCM -->
- <td> Git </td>
- <td>
- <!-- add -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- blame -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- branch -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- changelog -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- checkin -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- checkout -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- diff -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- edit -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- export -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- list -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- login -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- remove -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- status -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- tag -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- unedit -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- update -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- Pure Java -->
- <img src="./images/error.gif" />
- </td>
- </tr>
- <tr>
- <!-- SCM -->
- <td> Local </td>
- <td>
- <!-- add -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- blame -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- branch -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- changelog -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- checkin -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- checkout -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- diff -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- edit -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- export -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- list -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- login -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- remove -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- status -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- tag -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- unedit -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- update -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- Pure Java -->
- <img src="./images/check.gif" />
- </td>
- </tr>
- <tr>
- <!-- SCM -->
- <td> Mercurial (hg) </td>
- <td>
- <!-- add -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- blame -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- branch -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- changelog -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- checkin -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- checkout -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- diff -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- edit -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- export -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- list -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- login -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- remove -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- status -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- tag -->
- <img src="./images/error.gif" />
- </td>
- <td>
- <!-- unedit -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- update -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- Pure Java -->
- <img src="./images/error.gif" />
- </td>
- </tr>
- <tr>
- <!-- SCM -->
- <td> Subversion </td>
- <td>
- <!-- add -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- blame -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- branch -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- changelog -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- checkin -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- checkout -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- diff -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- edit -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- export -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- list -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- login -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- remove -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- status -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- tag -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- unedit -->
- <img src="./images/forbidden.gif" />
- </td>
- <td>
- <!-- update -->
- <img src="./images/check.gif" />
- </td>
- <td>
- <!-- Pure Java -->
- <img src="./images/error.gif" />
- </td>
- </tr>
- </tbody>
- </table>
-
- <p>Keys:
- <ul>
- <li><img src="./images/check.gif" />: Functional</li>
- <li><img src="./images/forbidden.gif" />: Doesn't exist in SCM tool</li>
- <li><img src="./images/error.gif" />: Not implemented</li>
- </ul>
- </p>
- </section>
-
- <section name="Related Links">
- <ul>
- <li><a href="https://cwiki.apache.org/confluence/display/MAVENSCM/SCM+Matrix">Wiki of Maven SCM Matrix</a></li>
- <li><a href="https://en.wikipedia.org/wiki/Comparison_of_revision_control_software">Comparison of revision control software</a></li>
- <li><a href="https://en.wikipedia.org/wiki/Source_Code_Management#Common_vocabulary">SCM Common vocabulary</a></li>
- </ul>
- </section>
- </body>
-</document>
(maven-scm) 01/03: Move to match target converter format MARKDOWN with doxia-converter
Posted by kw...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
kwin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-scm.git
commit f40ae649fe11bf2d2499f9302a02cbc8cc466e31
Author: Konrad Windszus <kw...@apache.org>
AuthorDate: Fri Aug 1 13:47:39 2025 +0200
Move to match target converter format MARKDOWN with doxia-converter
---
src/site/{apt/git.apt => markdown/git.md} | 0
.../{apt/guide/define_provider.apt => markdown/guide/define_provider.md} | 0
src/site/{apt/guide/index.apt => markdown/guide/index.md} | 0
src/site/{apt/guide/new_provider.apt => markdown/guide/new_provider.md} | 0
src/site/{apt/guide/usage.apt => markdown/guide/usage.md} | 0
src/site/{apt/index.apt => markdown/index.md} | 0
src/site/{apt/local.apt => markdown/local.md} | 0
src/site/{apt/mercurial.apt => markdown/mercurial.md} | 0
src/site/{apt/scm-commands.apt => markdown/scm-commands.md} | 0
src/site/{apt/scm-url-format.apt => markdown/scm-url-format.md} | 0
src/site/{apt/scms-overview.apt => markdown/scms-overview.md} | 0
src/site/{apt/subversion.apt => markdown/subversion.md} | 0
12 files changed, 0 insertions(+), 0 deletions(-)
diff --git a/src/site/apt/git.apt b/src/site/markdown/git.md
similarity index 100%
rename from src/site/apt/git.apt
rename to src/site/markdown/git.md
diff --git a/src/site/apt/guide/define_provider.apt b/src/site/markdown/guide/define_provider.md
similarity index 100%
rename from src/site/apt/guide/define_provider.apt
rename to src/site/markdown/guide/define_provider.md
diff --git a/src/site/apt/guide/index.apt b/src/site/markdown/guide/index.md
similarity index 100%
rename from src/site/apt/guide/index.apt
rename to src/site/markdown/guide/index.md
diff --git a/src/site/apt/guide/new_provider.apt b/src/site/markdown/guide/new_provider.md
similarity index 100%
rename from src/site/apt/guide/new_provider.apt
rename to src/site/markdown/guide/new_provider.md
diff --git a/src/site/apt/guide/usage.apt b/src/site/markdown/guide/usage.md
similarity index 100%
rename from src/site/apt/guide/usage.apt
rename to src/site/markdown/guide/usage.md
diff --git a/src/site/apt/index.apt b/src/site/markdown/index.md
similarity index 100%
rename from src/site/apt/index.apt
rename to src/site/markdown/index.md
diff --git a/src/site/apt/local.apt b/src/site/markdown/local.md
similarity index 100%
rename from src/site/apt/local.apt
rename to src/site/markdown/local.md
diff --git a/src/site/apt/mercurial.apt b/src/site/markdown/mercurial.md
similarity index 100%
rename from src/site/apt/mercurial.apt
rename to src/site/markdown/mercurial.md
diff --git a/src/site/apt/scm-commands.apt b/src/site/markdown/scm-commands.md
similarity index 100%
rename from src/site/apt/scm-commands.apt
rename to src/site/markdown/scm-commands.md
diff --git a/src/site/apt/scm-url-format.apt b/src/site/markdown/scm-url-format.md
similarity index 100%
rename from src/site/apt/scm-url-format.apt
rename to src/site/markdown/scm-url-format.md
diff --git a/src/site/apt/scms-overview.apt b/src/site/markdown/scms-overview.md
similarity index 100%
rename from src/site/apt/scms-overview.apt
rename to src/site/markdown/scms-overview.md
diff --git a/src/site/apt/subversion.apt b/src/site/markdown/subversion.md
similarity index 100%
rename from src/site/apt/subversion.apt
rename to src/site/markdown/subversion.md
(maven-scm) 02/03: Migrate to Markdown format
Posted by kw...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
kwin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-scm.git
commit 3ebdedf9fd783f0c53df61865f29b6968b1a3121
Author: Konrad Windszus <kw...@apache.org>
AuthorDate: Fri Aug 1 14:26:07 2025 +0200
Migrate to Markdown format
via "doxia-converter-1.4-SNAPSHOT-shaded.jar -from apt -to markdown -in
./apt -out ./markdown -gitMvInputToOutput"
Update to m-site-p 3.21.0 (leveraging Doxia 2) and Fluido Skin 2.1.0
---
pom.xml | 2 +
src/site/markdown/git.md | 124 +++++++++---------
src/site/markdown/guide/define_provider.md | 88 ++++++-------
src/site/markdown/guide/index.md | 60 +++++----
src/site/markdown/guide/new_provider.md | 201 +++++++++++------------------
src/site/markdown/guide/usage.md | 121 ++++++++---------
src/site/markdown/index.md | 67 +++++-----
src/site/markdown/local.md | 93 +++++++------
src/site/markdown/mercurial.md | 97 +++++++-------
src/site/markdown/scm-commands.md | 98 +++++++-------
src/site/markdown/scm-url-format.md | 80 ++++++------
src/site/markdown/scms-overview.md | 76 +++++------
src/site/markdown/subversion.md | 103 +++++++--------
13 files changed, 551 insertions(+), 659 deletions(-)
diff --git a/pom.xml b/pom.xml
index bb6a67a0f..ecff8482d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -175,6 +175,8 @@
<checkstyle.violation.ignore>RedundantThrows,NewlineAtEndOfFile,ParameterNumber,MethodLength,FileLength,InnerAssignment,MagicNumber</checkstyle.violation.ignore>
<checkstyle.failOnViolation>true</checkstyle.failOnViolation>
<project.build.outputTimestamp>2024-04-11T12:24:41Z</project.build.outputTimestamp>
+ <version.maven-fluido-skin>2.1.0</version.maven-fluido-skin>
+ <version.maven-site-plugin>3.21.0</version.maven-site-plugin>
</properties>
<dependencyManagement>
diff --git a/src/site/markdown/git.md b/src/site/markdown/git.md
index 29ba12517..37fa336c5 100644
--- a/src/site/markdown/git.md
+++ b/src/site/markdown/git.md
@@ -1,83 +1,79 @@
- ------
- SCM Implementation: Git
- ------
- Olivier Lamy
- ------
- 2008-08-10
- ------
-
-~~ 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.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-SCM Implementation: Git
-
-* General Info
-
- Link: {{http://git-scm.com/}}
-
- License: GNU General Public License v2
-
-* SCM URL
-
- For all URLs below, we use a colon (:) as separator. If you use a colon for one of the variables (e.g. a windows path), then use a pipe (|) as separator. The separator for the port has to be a colon in any case since this part is specified in the git URL specification. See man git-fetch.
-
--------
+---
+title: SCM Implementation: Git
+author:
+ - Olivier Lamy
+date: 2008-08-10
+---
+
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# SCM Implementation: Git
+
+## General Info
+
+Link: [http://git-scm.com/](http://git-scm.com/)
+
+License: GNU General Public License v2
+
+## SCM URL
+
+For all URLs below, we use a colon \(:\) as separator. If you use a colon for one of the variables \(e.g. a windows path\), then use a pipe \(|\) as separator. The separator for the port has to be a colon in any case since this part is specified in the git URL specification. See man git-fetch.
+
+```
scm:git:git://server_name[:port]/path_to_repository
scm:git:http://server_name[:port]/path_to_repository
scm:git:https://server_name[:port]/path_to_repository
scm:git:ssh://server_name[:port]/path_to_repository
scm:git:file://[hostname]/path_to_repository
--------
+```
- * Examples
+- Examples
--------
-scm:git:git://github.com/path_to_repository
-scm:git:http://github.com/path_to_repository
-scm:git:https://github.com/path_to_repository
-scm:git:ssh://github.com/path_to_repository
-scm:git:file://localhost/path_to_repository
--------
+ ```
+ scm:git:git://github.com/path_to_repository
+ scm:git:http://github.com/path_to_repository
+ scm:git:https://github.com/path_to_repository
+ scm:git:ssh://github.com/path_to_repository
+ scm:git:file://localhost/path_to_repository
+ ```
-* Different Fetch and Push URLs
+## Different Fetch and Push URLs
- In some cases a different URL has to be used for read and write operations. This can happen if e.g. fetch is performed via the http protocol, but writing to the repository is only possible via ssh. In this case both URLs may be written into the <developerConnection> tag. The fetch URL has to be prefixed with <<<[fetch=]>>> and the push URL with <<<[push=]>>>
+In some cases a different URL has to be used for read and write operations. This can happen if e.g. fetch is performed via the http protocol, but writing to the repository is only possible via ssh. In this case both URLs may be written into the _developerConnection_ tag. The fetch URL has to be prefixed with `[fetch=]` and the push URL with `[push=]`
- * Example:
+- Example:
--------
-<developerConnection>scm:git:[fetch=]http://mywebserver.org/path_to_repository[push=]ssh://username@otherserver:8898/~/repopath.git</developerConnection>
--------
+ ```
+ <developerConnection>scm:git:[fetch=]http://mywebserver.org/path_to_repository[push=]ssh://username@otherserver:8898/~/repopath.git</developerConnection>
+ ```
-* Working with branches
+## Working with branches
- Since version 1.3, we assume that the name of the branch in the upstream repo is the same as the name of the current local branch. So whenever you invoke a maven-scm action which has to access the upstream repository, e.g. start a release, you should be on that very branch.
+Since version 1\.3, we assume that the name of the branch in the upstream repo is the same as the name of the current local branch. So whenever you invoke a maven-scm action which has to access the upstream repository, e.g. start a release, you should be on that very branch.
- In other words: If no branch is specified manually, every git-fetch, git-pull, git-push, etc will always work on the branch in the upstream repository which has the same branch name as your current local branch
+In other words: If no branch is specified manually, every git-fetch, git-pull, git-push, etc will always work on the branch in the upstream repository which has the same branch name as your current local branch
--------
+```
git push pushUrl currentBranch:currentBranch
--------
+```
+## Provider Configuration
-* Provider Configuration
+The provider configuration is defined in `${user.home}/.scm/git-settings.xml`. For more information see the [reference guide](./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-git-commons/git-settings.html).
- The provider configuration is defined in <<<$\{user.home\}/.scm/git-settings.xml>>>.
- For more information see the {{{./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-git-commons/git-settings.html}reference guide}}.
diff --git a/src/site/markdown/guide/define_provider.md b/src/site/markdown/guide/define_provider.md
index 3e90c41f6..f064478bc 100644
--- a/src/site/markdown/guide/define_provider.md
+++ b/src/site/markdown/guide/define_provider.md
@@ -1,59 +1,48 @@
- ------
- How to define a non Apache Maven hosted implementation
- ------
- Maven Team
- ------
- 2013-09-07
- ------
+---
+title: How to define a non Apache Maven hosted implementation
+author:
+ - Maven Team
+date: 2013-09-07
+---
-~~ 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.
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# How to define a non Apache Maven hosted implementation?
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+Apache Maven supports a lot of implementations, but not all. However, with the following steps you can make Maven use this implementation for all your projects.
-How to define a non Apache Maven hosted implementation?
+## Prepare Maven
- Apache Maven supports a lot of implementations, but not all.
- However, with the following steps you can make Maven use this implementation for all your projects.
+Make the SCM implementation available for Maven by downloading the required jars and add them to Maven. If there's a `jar-with-dependencies` or a `shaded jar`, then that's the only jar required. Otherwise check the project for all transitive dependencies.
-* Prepare Maven
+- Maven 3\.x : Add jars to `%M2_HOME%/lib/ext/`
+- Maven 2\.x : Add jars to `%M2_HOME%/lib/`
- Make the SCM implementation available for Maven by downloading the required jars and add them to Maven.
- If there's a <<<jar-with-dependencies>>> or a <<<shaded jar>>>, then that's the only jar required.
- Otherwise check the project for all transitive dependencies.
-
- * Maven 3.x : Add jars to <<<%M2_HOME%/lib/ext/>>>
-
- * Maven 2.x : Add jars to <<<%M2_HOME%/lib/>>>
-
- []
+**Note:**Be aware that these jars now end up next to the root classloader of Maven. If you experience unexpected behavior, verify there's no class collision.
- <<Note:>>Be aware that these jars now end up next to the root classloader of Maven.
- If you experience unexpected behavior, verify there's no class collision.
+## Configure settings.xml
-* Configure settings.xml
+Since it is very well possible to have multiple versions of Maven next to each other, the preferred `settings.xml` to adjust is the instance with the additional jars.
- Since it is very well possible to have multiple versions of Maven next to each other,
- the preferred <<<settings.xml>>> to adjust is the instance with the additional jars.
-
- <<<%M2_HOME%/conf/settings.xml>>>
-
-------------------------------------------
+`%M2_HOME%/conf/settings.xml`
+
+```
<settings>
...
<profiles>
@@ -72,6 +61,7 @@ How to define a non Apache Maven hosted implementation?
</activeProfiles>
</settings>
-------------------------------------------
+```
+
+From now on when this Maven instance is used, it will always use the specified SCM provider implementation.
- From now on when this Maven instance is used, it will always use the specified SCM provider implementation.
diff --git a/src/site/markdown/guide/index.md b/src/site/markdown/guide/index.md
index 815bbf01a..d4c05d3e4 100644
--- a/src/site/markdown/guide/index.md
+++ b/src/site/markdown/guide/index.md
@@ -1,37 +1,35 @@
- ------
- Guides
- ------
- Maven Team
- ------
- 2007-03-12
- ------
+---
+title: Guides
+author:
+ - Maven Team
+date: 2007-03-12
+---
-~~ 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.
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# Guides
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+## [How to use Maven SCM in my application?](./usage.html)
-Guides
+This [document](./usage.html) describe API usage for a SCM client.
-* {{{./usage.html}How to use Maven SCM in my application?}}
+## [How to write a new SCM provider?](./new_provider.html)
- This {{{./usage.html}document}} describe API usage for a SCM client.
+This [document](./new_provider.html) describe step by step the implementation of a new SCM provider.
-* {{{./new_provider.html}How to write a new SCM provider?}}
-
- This {{{./new_provider.html}document}} describe step by step the implementation of a new SCM provider.
diff --git a/src/site/markdown/guide/new_provider.md b/src/site/markdown/guide/new_provider.md
index e770a8796..e02594b45 100644
--- a/src/site/markdown/guide/new_provider.md
+++ b/src/site/markdown/guide/new_provider.md
@@ -1,71 +1,49 @@
- ------
- How to write a new SCM provider
- ------
- Maven Team
- ------
- 2007-03-27
- ------
-
-~~ 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.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-How to write a new SCM provider?
-
-* What are the steps to write a new Maven SCM provider?
-
- * Define allowed scm urls for this provider
-
- * Create a class that extends <<<org.apache.maven.scm.provider.ScmProviderRepository>>>
- or <<<org.apache.maven.scm.provider.ScmProviderRepositoryWithHost>>>, this class
- is the corresponding bean of the scm url
-
- * Create a class that extends <<<org.apache.maven.scm.provider.AbstractScmProvider>>>.
- This class parse the scm url and link all scm commands methods to their
- implementations. Important methods are <<<makeProviderScmRepository()>>>
- and <<<validateScmUrl()>>>
-
- * Implement all commands and link them in the scm provider class created in
- the step above
-
- * For each command, implement junit tests that test the command line format
-
- * For each command, implement TCK tests
-
- * Test the release plugin with the new provider. For that, you must add the
- dependency to the release plugin and run it
-
- * Add the dependency to Continuum libs and test the provider with a sample
- project
-
- * Update the site
-
- []
-
- In the next section, we'll see all the steps in details to write a new
- Maven SCM provider.
-
-* Create a new Maven project for the provider
-
- Your project need to use some jars from the Maven SCM framework. Add them to your POM.
-
-+------------------------------------------+
+---
+title: How to write a new SCM provider
+author:
+ - Maven Team
+date: 2007-03-27
+---
+
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# How to write a new SCM provider?
+
+## What are the steps to write a new Maven SCM provider?
+
+- Define allowed scm urls for this provider
+- Create a class that extends `org.apache.maven.scm.provider.ScmProviderRepository` or `org.apache.maven.scm.provider.ScmProviderRepositoryWithHost`, this class is the corresponding bean of the scm url
+- Create a class that extends `org.apache.maven.scm.provider.AbstractScmProvider`. This class parse the scm url and link all scm commands methods to their implementations. Important methods are `makeProviderScmRepository()` and `validateScmUrl()`
+- Implement all commands and link them in the scm provider class created in the step above
+- For each command, implement junit tests that test the command line format
+- For each command, implement TCK tests
+- Test the release plugin with the new provider. For that, you must add the dependency to the release plugin and run it
+- Add the dependency to Continuum libs and test the provider with a sample project
+- Update the site
+
+In the next section, we'll see all the steps in details to write a new Maven SCM provider.
+
+## Create a new Maven project for the provider
+
+Your project need to use some jars from the Maven SCM framework. Add them to your POM.
+
+```unknown
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
@@ -99,17 +77,15 @@ How to write a new SCM provider?
</plugins>
</build>
</project>
-+------------------------------------------+
+```
- The Sisu Maven Plugin will generate the components meta-data file used by the
- DI to discover them inject them to SCM manager.
+The Sisu Maven Plugin will generate the components meta-data file used by the DI to discover them inject them to SCM manager.
-* Create an SCM Provider Repository class
+## Create an SCM Provider Repository class
- This class will contain all SCM information about your SCM connection
- (user, password, host, port, path...).
+This class will contain all SCM information about your SCM connection \(user, password, host, port, path...\).
-+------------------------------------------+
+```unknown
package org.apache.maven.scm.provider.myprovider.repository;
import org.apache.maven.scm.provider.ScmProviderRepository;
@@ -118,23 +94,17 @@ public class MyScmProviderRepository
extends ScmProviderRepository
{
}
-+------------------------------------------+
+```
- Before you add more information to this class, you can look at the
- <<<ScmProviderRepository>>> sub-classes, if they are already implemented.
+Before you add more information to this class, you can look at the `ScmProviderRepository` sub-classes, if they are already implemented.
-* Create the Provider class
+## Create the Provider class
- This class is the central point of the provider. The Maven SCM framework will
- know only this class in the provider, so this class must validate the scm
- url, populate the <<<ScmProviderRepository>>> and provide all commands
- supported by your provider. We start with a basic class, then we'll add
- commands to it when we implement them.
+This class is the central point of the provider. The Maven SCM framework will know only this class in the provider, so this class must validate the scm url, populate the `ScmProviderRepository` and provide all commands supported by your provider. We start with a basic class, then we'll add commands to it when we implement them.
- Before you start to write your SCM provider, you must define the SCM URLs you
- want to support.
+Before you start to write your SCM provider, you must define the SCM URLs you want to support.
-+------------------------------------------+
+```unknown
package org.apache.maven.scm.provider.myprovider;
import org.apache.maven.scm.provider.myprovider.repository.MyScmProviderRepository;
@@ -169,21 +139,15 @@ public class MyScmProvider
return providerRepository;
}
}
-+------------------------------------------+
+```
- The JSR330 annotations will be used by the Sisu Maven Plugin,
- declared in the POM, to generate component meta-data.
- Generally, we use the string just after <scm:> in the scm URL as the
- <provider_name>.
+The JSR330 annotations will be used by the Sisu Maven Plugin, declared in the POM, to generate component meta-data. Generally, we use the string just after _scm:_ in the scm URL as the _provider\_name_.
-* Commands implementation
+## Commands implementation
- When you write a new SCM command, you must extend base classes for the
- Maven SCM framework. We have one base command for each command supported by
- Maven SCM and each command have an <<<execute>>> method that return an SCM
- result.
+When you write a new SCM command, you must extend base classes for the Maven SCM framework. We have one base command for each command supported by Maven SCM and each command have an `execute` method that return an SCM result.
-+------------------------------------------+
+```unknown
package org.apache.maven.scm.provider.myprovider.command.checkout;
import org.apache.maven.scm.command.checkout.AbstractCheckOutCommand;
@@ -202,15 +166,13 @@ public class MyCheckoutCommand
return result;
}
}
-+------------------------------------------+
+```
-* Allow the command in the SCM provider
+## Allow the command in the SCM provider
- Now that your command is implemented, you need to add it in your SCM provider
- (<<<MyScmProvider>>>). Open the provider class and override the method that
- relates to your command.
+Now that your command is implemented, you need to add it in your SCM provider \(`MyScmProvider`\). Open the provider class and override the method that relates to your command.
-+------------------------------------------+
+```unknown
public class MyScmProvider
extends AbstractScmProvider
{
@@ -224,32 +186,23 @@ public class MyScmProvider
return (CheckOutScmResult) command.execute( repository.getProviderRepository(), fileSet, params );
}
}
-+------------------------------------------+
-
-* Provider Tests
+```
-** Automated tests
+## Provider Tests
- To be sure your provider works as expected, you must implement some tests.
- You can implement two levels of tests:
+### Automated tests
- * Simple JUnit tests that use your command directly and test that the command
- line you launch in your SCM command is correct
+To be sure your provider works as expected, you must implement some tests. You can implement two levels of tests:
- * Implementation of the TCK. The TCK provides a set of tests that validate
- that your implementation is compatible with the Maven SCM framework. The
- TCK requires access to the SCM tool.
+- Simple JUnit tests that use your command directly and test that the command line you launch in your SCM command is correct
+- Implementation of the TCK. The TCK provides a set of tests that validate that your implementation is compatible with the Maven SCM framework. The TCK requires access to the SCM tool.
+### Other tests
-** Other tests
+You can do manual tests in the real world with the Maven SCM Plugin, the Maven Release Plugin, the Maven Changelog Plugin and Continuum.
- You can do manual tests in the real world with the Maven SCM Plugin,
- the Maven Release Plugin, the Maven Changelog Plugin and Continuum.
+It's important to test your SCM provider with these tools, because they are used by users that will use your provider.
- It's important to test your SCM provider with these tools, because they are
- used by users that will use your provider.
+## Document your provider
-* Document your provider
+Now that your provider works fine, you must document it \(which scm URLs are supported, which commands are supported...\). You can use the same template that is used by the other providers.
- Now that your provider works fine, you must document it (which scm URLs are
- supported, which commands are supported...). You can use the same template
- that is used by the other providers.
diff --git a/src/site/markdown/guide/usage.md b/src/site/markdown/guide/usage.md
index be9af836f..756998d03 100644
--- a/src/site/markdown/guide/usage.md
+++ b/src/site/markdown/guide/usage.md
@@ -1,42 +1,37 @@
- ------
- How to use Maven SCM in my application
- ------
- Maven Team
- ------
- 2007-03-26
- ------
-
-~~ 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.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-How to use Maven SCM in my application?
-
-* Create an SCM Manager
-
-** With Plexus IOC
-
- With {{{http://codehaus-plexus.github.io/}Plexus}}, it's very easy to use Maven SCM
- because it injects all dependencies in fields, so you only have to write
- minimal code.
-
-+------------------------------------------+
+---
+title: How to use Maven SCM in my application
+author:
+ - Maven Team
+date: 2007-03-26
+---
+
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# How to use Maven SCM in my application?
+
+## Create an SCM Manager
+
+### With Plexus IOC
+
+With [Plexus](http://codehaus-plexus.github.io/), it's very easy to use Maven SCM because it injects all dependencies in fields, so you only have to write minimal code.
+
+```unknown
import org.apache.maven.scm.manager.ScmManager;
public class MyApp
@@ -56,15 +51,13 @@ public class MyApp
{
return scmManager;
}
-+------------------------------------------+
+```
+### Without Plexus IOC
-** Without Plexus IOC
+Without Plexus, you must add all your SCM providers in the manager and that will require more work. You can use the basic SCM manager or write your own:
- Without Plexus, you must add all your SCM providers in the manager and that
- will require more work. You can use the basic SCM manager or write your own:
-
-+------------------------------------------+
+```unknown
import org.apache.maven.scm.manager.BasicScmManager;
public class MyApp
@@ -85,14 +78,13 @@ public class MyApp
{
return scmManager;
}
-+------------------------------------------+
+```
-* Run a SCM command
+## Run a SCM command
- Before you call a command, the SCM manager needs an <<<ScmRepository>>>. This
- object contains all the information about the SCM connection.
+Before you call a command, the SCM manager needs an `ScmRepository`. This object contains all the information about the SCM connection.
-+------------------------------------------+
+```unknown
public ScmRepository getScmRepository( String scmUrl )
throw Exception
{
@@ -111,11 +103,11 @@ public class MyApp
throw new Exception( "Error while connecting to the repository", ex );
}
}
-+------------------------------------------+
+```
-** Checkout command
+### Checkout command
-+------------------------------------------+
+```unknown
public void checkOut( ScmRepository scmRepository, File workingDirectory )
throws ScmException
{
@@ -149,11 +141,11 @@ public class MyApp
System.out.println( " " + file.getPath() );
}
}
-+------------------------------------------+
+```
-** Update command
+### Update command
-+------------------------------------------+
+```unknown
public void update( ScmRepository scmRepository, File workingDirectory )
throws ScmException
{
@@ -179,14 +171,13 @@ public class MyApp
System.out.println( " " + file.getPath() );
}
}
-+------------------------------------------+
+```
-* The checkResult method
+## The checkResult method
- In each sample command code, we use the <<<checkResult>>> method, it isn't
- required but can be useful if something failed in the command execution.
+In each sample command code, we use the `checkResult` method, it isn't required but can be useful if something failed in the command execution.
-+------------------------------------------+
+```unknown
public void checkResult( ScmResult result )
throws Exception
{
@@ -204,9 +195,9 @@ public class MyApp
"Command failed." + StringUtils.defaultString( result.getProviderMessage() ) );
}
}
-+------------------------------------------+
+```
+
+## Sample code
-* Sample code
+The code above is available here: [Maven SCM client](http://svn.apache.org/repos/asf/maven/scm/trunk/maven-scm-client/).
- The code above is available here:
- {{{http://svn.apache.org/repos/asf/maven/scm/trunk/maven-scm-client/}Maven SCM client}}.
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index f2c9c1184..927aa3150 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -1,42 +1,33 @@
- ------
- Home
- ------
- Wim Deblauwe
- ------
- 2013-10-27
- ------
+---
+title: Home
+author:
+ - Wim Deblauwe
+date: 2013-10-27
+---
-~~ 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.
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# Maven SCM
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+Maven SCM supports Maven plugins \(for example [maven-release-plugin](https://maven.apache.org/plugins/maven-release-plugin/)\) and other tools by providing them with [a common API](./maven-scm-api/apidocs) for source code management operations. You can look at [the list of SCMs](./scms-overview.html) for more information on using Maven SCM with your favorite SCM tool.
-Maven SCM
+In addition, Maven SCM provides two tools to directly use it:
- Maven SCM supports Maven plugins (for example
- {{{https://maven.apache.org/plugins/maven-release-plugin/}maven-release-plugin}})
- and other tools by providing them with {{{./maven-scm-api/apidocs}a common API}} for
- source code management operations. You can look at
- {{{./scms-overview.html}the list of SCMs}} for more information on using
- Maven SCM with your favorite SCM tool.
-
- In addition, Maven SCM provides two tools to directly use it:
-
- * {{{./maven-scm-plugin}<<<maven-scm-plugin>>>}}: a Maven plugin, where each SCM command is implemented as a plugin goal,
-
- * {{{./maven-scm-client}<<<maven-scm-client>>>}}: a simple SCM command line tool.
+- [`maven-scm-plugin`](./maven-scm-plugin): a Maven plugin, where each SCM command is implemented as a plugin goal,
+- [`maven-scm-client`](./maven-scm-client): a simple SCM command line tool.
diff --git a/src/site/markdown/local.md b/src/site/markdown/local.md
index f9d7e031b..2b855f976 100644
--- a/src/site/markdown/local.md
+++ b/src/site/markdown/local.md
@@ -1,55 +1,52 @@
- ------
- SCM Implementation: File System
- ------
- Wim Deblauwe
- ------
- 2005-12-01
- ------
-
-~~ 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.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-SCM Implementation: File System
-
-* General Info
-
- Link: -
-
- License: -
-
-* SCM URL
-
- For all URLs below, we use a colon (:) as separator. If you use a colon for one of the variables (e.g. a windows path), then use a pipe (|) as separator.
-
--------
+---
+title: SCM Implementation: File System
+author:
+ - Wim Deblauwe
+date: 2005-12-01
+---
+
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# SCM Implementation: File System
+
+## General Info
+
+Link: -
+
+License: -
+
+## SCM URL
+
+For all URLs below, we use a colon \(:\) as separator. If you use a colon for one of the variables \(e.g. a windows path\), then use a pipe \(|\) as separator.
+
+```
scm:local<delimiter>path_to_repository<delimiter>module_name
--------
+```
- <path_to_repository>: The absolute or relative path to the parent directory of your pom.xml
+_path\_to\_repository_: The absolute or relative path to the parent directory of your pom.xml
- <module_name>: The name of the directory that contains your pom.xml
+_module\_name_: The name of the directory that contains your pom.xml
+## Examples
-* Examples
-
--------
+```
scm:local:/usr/modules:my_module
scm:local|C:/javaprojects|my_module
--------
+```
+
diff --git a/src/site/markdown/mercurial.md b/src/site/markdown/mercurial.md
index 255a8602d..97670523e 100644
--- a/src/site/markdown/mercurial.md
+++ b/src/site/markdown/mercurial.md
@@ -1,57 +1,54 @@
- ------
- SCM Implementation: Mercurial (hg)
- ------
- Ryan Daum
- ------
- 2007-04-12
- ------
-
-~~ 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.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-SCM Implementation: Mercurial
-
-* General Info
-
- Link: {{http://www.selenic.com/mercurial/wiki/}}
-
- License: GNU General Public License
-
- "Mercurial: a fast, lightweight Source Control Management system designed for efficient handling of very large distributed projects."
-
- This provider supports version 0.9.2 and greater of Mercurial.
-
-* SCM URL
-
- Path or url to the branch location.
- Supported protocols: HTTP, HTTPS, FILE, and local path.
-
--------
+---
+title: SCM Implementation: Mercurial (hg)
+author:
+ - Ryan Daum
+date: 2007-04-12
+---
+
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# SCM Implementation: Mercurial
+
+## General Info
+
+Link: [http://www.selenic.com/mercurial/wiki/](http://www.selenic.com/mercurial/wiki/)
+
+License: GNU General Public License
+
+"Mercurial: a fast, lightweight Source Control Management system designed for efficient handling of very large distributed projects."
+
+This provider supports version 0\.9\.2 and greater of Mercurial.
+
+## SCM URL
+
+Path or url to the branch location. Supported protocols: HTTP, HTTPS, FILE, and local path.
+
+```
scm:hg:url_to_repository/local_repository_directory
--------
+```
-* Examples
+## Examples
--------
+```
scm:hg:http://host/v3
scm:hg:file://C:/dev/project/v3 (windows drive)
scm:hg:file:///home/smorgrav/dev/project/v3 (linux drive)
scm:hg:/home/smorgrav/dev/project/v3 (local directory)
--------
+```
+
diff --git a/src/site/markdown/scm-commands.md b/src/site/markdown/scm-commands.md
index 2f577749a..632029f33 100644
--- a/src/site/markdown/scm-commands.md
+++ b/src/site/markdown/scm-commands.md
@@ -1,75 +1,69 @@
- ------
- SCM Commands
- ------
- Wim Deblauwe
- ------
- 2005-12-01
- ------
+---
+title: SCM Commands
+author:
+ - Wim Deblauwe
+date: 2005-12-01
+---
-~~ 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.
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# Maven SCM Commands
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+Maven SCM uses a exposes a fixed set of commands for it users. The providers for each SCM must implements those commands through the ScmProvider interface. This is an overview of all the commands:
-Maven SCM Commands
+## Add
- Maven SCM uses a exposes a fixed set of commands for it users. The providers for each SCM must implements those commands through
- the ScmProvider interface. This is an overview of all the commands:
+Adds a new file to the source control system
-* Add
+## Changelog
- Adds a new file to the source control system
+Produces a list of changed \(a new version has been put in the system\) files. This list can then be used to display the latest changes or the developer\(s\) who did the latest changes.
-* Changelog
+## Checkin
- Produces a list of changed (a new version has been put in the system) files. This list can then be used to display the latest changes
- or the developer(s) who did the latest changes.
+Save the changes you have done into the repository. This will create a new version of the file or directory in the repository.
-* Checkin
+## Checkout
- Save the changes you have done into the repository. This will create a new version of the file or
- directory in the repository.
+Copy \(part of\) the contents of the source control system to a certain location on your local machine. It should be possible to scm operations in that location.
-* Checkout
+## Edit
- Copy (part of) the contents of the source control system to a certain location on your local machine. It should be possible to scm operations in that location.
+Mark a file as editable with the source control system. This is used in source control systems where you look at read-only files and you need to make them not read-only anymore before you can edit them. In some scm's this means that no other user can then do an edit at the same time.
-* Edit
+## Diff
- Mark a file as editable with the source control system. This is used in source control systems where you look at read-only files
- and you need to make them not read-only anymore before you can edit them. In some scm's this means that no other user can then do an edit at the same time.
+TODO
-* Diff
+## Remove
- TODO
+Removes a file from the source control system
-* Remove
+## Status
- Removes a file from the source control system
+Gives a list of files that still need some source control operation \(files that still need to be added, files that are in edit mode, ...\)
-* Status
+## Tag
- Gives a list of files that still need some source control operation (files that still need to be added, files that are in edit mode, ...)
+Tags \(label in some scm's\) a source tree with a certain tag. This allows to make reproducable builds later by checking out the source code that has this tag.
-* Tag
+## Update
- Tags (label in some scm's) a source tree with a certain tag. This allows to make reproducable builds later by checking out the source code that has this tag.
+Updates the checkout'ed source code to the latest state in the source control repository.
-* Update
-
- Updates the checkout'ed source code to the latest state in the source control repository.
diff --git a/src/site/markdown/scm-url-format.md b/src/site/markdown/scm-url-format.md
index b2c543bb6..4e9a2d364 100644
--- a/src/site/markdown/scm-url-format.md
+++ b/src/site/markdown/scm-url-format.md
@@ -1,47 +1,41 @@
- ------
- SCM URL format
- ------
- Emmanuel Venisse
- ------
- 2005-06-05
- ------
-
-~~ 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.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-SCM URL Format
-
-* SCM URL
-
- The general format for a SCM URL is
-
--------
+---
+title: SCM URL format
+author:
+ - Emmanuel Venisse
+date: 2005-06-05
+---
+
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# SCM URL Format
+
+## SCM URL
+
+The general format for a SCM URL is
+
+```
scm:<provider id><delimiter><provider-specific part>
--------
+```
- As delimiter you can use either colon <<<:>>> or a pipe <<<|>>>, if you use a
- colon for one of the variables (e.g. a Windows path).
+As delimiter you can use either colon `:` or a pipe `|`, if you use a colon for one of the variables \(e.g. a Windows path\).
- For information about supported provider IDs and the provider-specific part,
- see the appropriate {{{./scms-overview.html}SCM implementation}}.
+For information about supported provider IDs and the provider-specific part, see the appropriate [SCM implementation](./scms-overview.html).
+
+Provider IDs may be mapped with the help of the plugin parameter `providerImplementations` supported by both [maven-release-plugin](https://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html#providerImplementations) and [maven-scm-plugin](./maven-scm-plugin/checkout-mojo.html#providerImplementations).
- Provider IDs may be mapped with the help of the plugin parameter <<<providerImplementations>>> supported
- by both {{{https://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html#providerImplementations}maven-release-plugin}}
- and {{{./maven-scm-plugin/checkout-mojo.html#providerImplementations}maven-scm-plugin}}.
diff --git a/src/site/markdown/scms-overview.md b/src/site/markdown/scms-overview.md
index 8e3117324..10332be3d 100644
--- a/src/site/markdown/scms-overview.md
+++ b/src/site/markdown/scms-overview.md
@@ -1,45 +1,37 @@
- ------
- Overview of SCMs
- ------
- Wim Deblauwe
- ------
- 2005-12-01
- ------
+---
+title: Overview of SCMs
+author:
+ - Wim Deblauwe
+date: 2005-12-01
+---
-~~ 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.
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# Overview of SCMs
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+This is a list of all standard SCMs:
-Overview of SCMs
-
- This is a list of all standard SCMs:
-
-*-----*-------------*-----------------*
-| <<SCM>> | <<Provider ID>> | <<Provider Module>> |
-*-----*-------------*-----------------*
-| {{{./git.html}Git}} | <<<git>>> | {{{./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-gitexe/index.html}Git Executable Provider}} |
-*-----*-------------*-----------------*
-| {{{./git.html}Git}} | <<<jgit>>> | {{{./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-jgit/index.html}JGit Provider}} |
-*-----*-------------*-----------------*
-| {{{./subversion.html}Subversion}} | <<<svn>>> | {{{./maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svnexe/index.html}SVN Executable Provider}} |
-*-----*-------------*-----------------*
-| {{{./mercurial.html}Mercurial}} | <<<hg>>> | {{{./maven-scm-providers/maven-scm-provider-hg/index.html}Mercurial (Hg) Provider}} |
-*-----*-------------*-----------------*
-| {{{./local.html}Local}} | <<<local>>> | {{{./maven-scm-providers/maven-scm-provider-local/index.html}Local Provider}} |
-*-----*-------------*-----------------*
+| | | |
+|:---:|:---:|:---:|
+|**SCM**|**Provider ID**|**Provider Module**|
+|[Git](./git.html)|`git`|[Git Executable Provider](./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-gitexe/index.html)|
+|[Git](./git.html)|`jgit`|[JGit Provider](./maven-scm-providers/maven-scm-providers-git/maven-scm-provider-jgit/index.html)|
+|[Subversion](./subversion.html)|`svn`|[SVN Executable Provider](./maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svnexe/index.html)|
+|[Mercurial](./mercurial.html)|`hg`|[Mercurial \(Hg\) Provider](./maven-scm-providers/maven-scm-provider-hg/index.html)|
+|[Local](./local.html)|`local`|[Local Provider](./maven-scm-providers/maven-scm-provider-local/index.html)|
diff --git a/src/site/markdown/subversion.md b/src/site/markdown/subversion.md
index 0f3f43815..7d936d05e 100644
--- a/src/site/markdown/subversion.md
+++ b/src/site/markdown/subversion.md
@@ -1,72 +1,69 @@
- ------
- SCM Implementation: Subversion
- ------
- Wim Deblauwe
- Olivier Lamy
- ------
- 2011-05-15
- ------
-
-~~ 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.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-SCM Implementation: Subversion
-
-* General Info
-
- Link: {{http://subversion.apache.org/}}
-
- License: Apache License, Version 2.0
-
-* SCM URL
-
- For all URLs below, we use a colon (:) as separator. If you use a colon for one of the variables (e.g. a windows path), then use a pipe (|) as separator.
-
--------
+---
+title: SCM Implementation: Subversion
+author:
+ - Wim Deblauwe
+ - Olivier Lamy
+date: 2011-05-15
+---
+
+<!-- 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.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# SCM Implementation: Subversion
+
+## General Info
+
+Link: [http://subversion.apache.org/](http://subversion.apache.org/)
+
+License: Apache License, Version 2\.0
+
+## SCM URL
+
+For all URLs below, we use a colon \(:\) as separator. If you use a colon for one of the variables \(e.g. a windows path\), then use a pipe \(|\) as separator.
+
+```
scm:svn:svn://[username[:password]@]server_name[:port]/path_to_repository
scm:svn:svn+ssh://[username@]server_name[:port]/path_to_repository
scm:svn:file://[hostname]/path_to_repository
scm:svn:http://[username[:password]@]server_name[:port]/path_to_repository
scm:svn:https://[username[:password]@]server_name[:port]/path_to_repository
--------
+```
-* Examples
+## Examples
--------
+```
scm:svn:file:///svn/root/module
scm:svn:file://localhost/path_to_repository
scm:svn:file://my_server/path_to_repository
scm:svn:http://svn.apache.org/svn/root/module
scm:svn:https://username@svn.apache.org/svn/root/module
scm:svn:https://username:password@svn.apache.org/svn/root/module
--------
+```
-* Provider Configuration
+## Provider Configuration
- The provider configuration is defined in <<<$\{user.home\}/.scm/svn-settings.xml>>>.
- For more information see the {{{./maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svn-commons/svn-settings.html}reference guide}}.
+The provider configuration is defined in `${user.home}/.scm/svn-settings.xml`. For more information see the [reference guide](./maven-scm-providers/maven-scm-providers-svn/maven-scm-provider-svn-commons/svn-settings.html).
-** Configuration directory
+### Configuration directory
- You can define the subversion configuration directory ('--config-dir' svn global option) in the provider configuration file or with 'maven.scm.svn.config_directory' command line parameter.
+You can define the subversion configuration directory \('--config-dir' svn global option\) in the provider configuration file or with 'maven.scm.svn.config\_directory' command line parameter.
--------
+```
mvn -Dmaven.scm.svn.config_directory=your_configuration_directory scm:update
--------
+```
+