From 8bbbd0e774f33cb16c5b8f4b0561ede09215b4df Mon Sep 17 00:00:00 2001
From: Andrzej Jarmoniuk <gh@jarmoniuk.nl>
Date: Sun, 23 Oct 2022 18:48:56 +0200
Subject: [PATCH] #725: Migrate Update Parent to Markdown

---
 src/site/apt/examples/update-parent.apt     | 70 ---------------------
 src/site/markdown/examples/update-parent.md | 66 +++++++++++++++++++
 2 files changed, 66 insertions(+), 70 deletions(-)
 delete mode 100644 src/site/apt/examples/update-parent.apt
 create mode 100644 src/site/markdown/examples/update-parent.md

diff --git a/src/site/apt/examples/update-parent.apt b/src/site/apt/examples/update-parent.apt
deleted file mode 100644
index 476a201ee..000000000
--- a/src/site/apt/examples/update-parent.apt
+++ /dev/null
@@ -1,70 +0,0 @@
- ~~ 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.
-
- -----
- Update Parent
- -----
- Stephen Connolly
- ------
- 2008-09-02
- ------
-
-Update Parent
-
-  Here's an example:
-
----
-svn checkout http://svn.codehaus.org/mojo/tags/xmlbeans-maven-plugin-2.3.1 xmlbeans-maven-plugin
-cd xmlbeans-maven-plugin
-mvn versions:update-parent
----
-
-  Which produces the following output:
-
----
-[INFO] Scanning for projects...
-...
-[INFO] ------------------------------------------------------------------------
-[INFO] Building Maven XML Beans Plugin
-[INFO]    task-segment: [versions:update-parent]
-[INFO] ------------------------------------------------------------------------
-[INFO] [versions:update-parent]
-...
-[INFO] artifact org.codehaus.mojo:mojo: checking for updates from codehaus.org
-[INFO] artifact org.codehaus.mojo:mojo: checking for updates from central
-[INFO] Updating parent from 14 to 17
-[INFO] ------------------------------------------------------------------------
-[INFO] BUILD SUCCESSFUL
-[INFO] ------------------------------------------------------------------------
-[INFO] Total time: 24 seconds
-[INFO] Finished at: Thu Aug 14 15:17:04 IST 2008
-[INFO] Final Memory: 9M/166M
-[INFO] ------------------------------------------------------------------------
----
-
-  You can restrict the versions to be considered:
-
----
-mvn versions:update-parent "-DparentVersion=[14,16)"
----
-
-  Note that, by default, -SNAPSHOT versions are ignored. You can force snapshots to be 
-  included with the allowSnapshots parameter:
-
----
-mvn versions:update-parent -DallowSnapshots=true
----
diff --git a/src/site/markdown/examples/update-parent.md b/src/site/markdown/examples/update-parent.md
new file mode 100644
index 000000000..a1e86c501
--- /dev/null
+++ b/src/site/markdown/examples/update-parent.md
@@ -0,0 +1,66 @@
+title: Update Parent
+author: Stephen Connolly
+date: 2008-09-02
+
+<!---
+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
+  https://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.
+-->
+
+# Update Parent
+
+Here's an example:
+
+```shell
+svn checkout http://svn.codehaus.org/mojo/tags/xmlbeans-maven-plugin-2.3.1 xmlbeans-maven-plugin
+cd xmlbeans-maven-plugin
+mvn versions:update-parent
+```
+
+Which produces the following output:
+
+```log
+[INFO] Scanning for projects...
+...
+[INFO] ------------------------------------------------------------------------
+[INFO] Building Maven XML Beans Plugin
+[INFO]    task-segment: [versions:update-parent]
+[INFO] ------------------------------------------------------------------------
+[INFO] [versions:update-parent]
+...
+[INFO] artifact org.codehaus.mojo:mojo: checking for updates from codehaus.org
+[INFO] artifact org.codehaus.mojo:mojo: checking for updates from central
+[INFO] Updating parent from 14 to 17
+[INFO] ------------------------------------------------------------------------
+[INFO] BUILD SUCCESSFUL
+[INFO] ------------------------------------------------------------------------
+[INFO] Total time: 24 seconds
+[INFO] Finished at: Thu Aug 14 15:17:04 IST 2008
+[INFO] Final Memory: 9M/166M
+[INFO] ------------------------------------------------------------------------
+```
+
+You can restrict the versions to be considered:
+
+```shell
+mvn versions:update-parent "-DparentVersion=[14,16)"
+```
+
+Note that, by default, -SNAPSHOT versions are ignored. You can force snapshots to be 
+included with the allowSnapshots parameter:
+
+```shell
+mvn versions:update-parent -DallowSnapshots=true
+```