From 15ee18e027044bbd19a08167926869e65bcc5083 Mon Sep 17 00:00:00 2001
From: Jonah Graham <jonah@kichwacoders.com>
Date: Wed, 9 Nov 2022 09:57:55 -0500
Subject: [PATCH] Stop synchronizing user guides from Wiki

The primary location for these user guides is now the Git repo in HTML
format.

Part of #32
---
 BUILDING.md                                   | 13 ----
 .../User_Guide/Updating-This-Document.html    |  6 +-
 .../build-helper.xml                          | 65 -------------------
 build/org.eclipse.cdt.autotools.docs/pom.xml  | 35 ----------
 .../User_Guide/Updating-This-Document.html    |  6 +-
 .../build-helper.xml                          | 65 -------------------
 build/org.eclipse.cdt.meson.docs/pom.xml      | 35 ----------
 7 files changed, 6 insertions(+), 219 deletions(-)
 delete mode 100644 build/org.eclipse.cdt.autotools.docs/build-helper.xml
 delete mode 100644 build/org.eclipse.cdt.meson.docs/build-helper.xml

diff --git a/BUILDING.md b/BUILDING.md
index 7172b4b5619..871a098287e 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -62,19 +62,6 @@ Requires verify phase of maven to run, i.e. will not run with `mvn package` even
 Runs the production steps of the build. This profile can only be run on the CDT CI machines
 as access to Eclipse key signing server is needed to sign the jars.
 
-#### regenHelp
-
-Some of the help systems in Eclipse CDT require the `regenHelp` profile to rebuild their HTML from the source documents. For example, to regenerate the help
-for Autotools or Meson do:
-
-```
-mvn generate-resources -DuseSimrelRepo -f build/org.eclipse.cdt.meson.docs -PregenHelp
-```
-
-```
-mvn generate-resources -DuseSimrelRepo -f build/org.eclipse.cdt.autotools.docs -PregenHelp
-```
-
 #### jniheaders
 
 The `jniheaders` profile can be used on the `core/org.eclipse.cdt.core.native` and
diff --git a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Updating-This-Document.html b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Updating-This-Document.html
index be97848ade2..7e955887369 100644
--- a/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Updating-This-Document.html
+++ b/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide/Updating-This-Document.html
@@ -26,9 +26,9 @@
 			</tr>
 		</table><hr class="navigation-separator"/>
 		<h1 id="Updating_This_Document">Updating This Document</h1>
-		<p>This document is maintained in a collaborative wiki.  If you wish to update or modify this document please visit 
-
-			<a href="https://wiki.eclipse.org/CDT/Autotools/User_Guide">https://wiki.eclipse.org/CDT/Autotools/User_Guide</a>
+		<p>This document is maintained in Git. Please see provide a Pull Request following the <a
+			href="https://github.com/eclipse-cdt/cdt/blob/main/CONTRIBUTING.md">Eclipse CDT contribution guide</a> to <a
+			href="org.eclipse.cdt.autotools.docs">https://github.com/eclipse-cdt/cdt/tree/main/build/org.eclipse.cdt.autotools.docs/CDT/Autotools/User_Guide</a>
 		</p><hr class="navigation-separator"/>
 		<table class="navigation" style="width: 100%;" border="0" summary="navigation">
 			<tr>
diff --git a/build/org.eclipse.cdt.autotools.docs/build-helper.xml b/build/org.eclipse.cdt.autotools.docs/build-helper.xml
deleted file mode 100644
index 17fa72e1d7e..00000000000
--- a/build/org.eclipse.cdt.autotools.docs/build-helper.xml
+++ /dev/null
@@ -1,65 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
-    Copyright (c) 2012, 2018 Red Hat, Inc.
-    This program and the accompanying materials
-    are made available under the terms of the Eclipse Public License 2.0
-    which accompanies this distribution, and is available at
-    https://www.eclipse.org/legal/epl-2.0/
-    
-    SPDX-License-Identifier: EPL-2.0
-   
-    Contributors:
-        Red Hat - initial API and implementation
- -->
-<project name="org.eclipse.cdt.autotools.docs" default="all">
-    <description>
-            Generate Eclipse help content for the CDT autotools user guide
-    </description>
-
-	<property name="autotools.help.doc.url.base" value="https://wiki.eclipse.org"/>
-	<property name="autotools.wiki.url.base" value="${autotools.help.doc.url.base}/CDT/Autotools"/>
-	<property name="imageFolder" value="images"/>
-
-	<target name="all" description="Generate Eclipse help content for the CDT Autotools user guide">
-		<mediawiki-to-eclipse-help wikiBaseUrl="${autotools.help.doc.url.base}" title="Autotools Plug-in User Guide" formatoutput="true" dest="." templateExcludes="*eclipseproject*">
-
-			<path name="CDT/Autotools/User_Guide" title="Autotools Plug-in User Guide" generateToc="false"/>
-			<stylesheet url="book.css" />
-			<pageAppendum>
-= Updating This Document =
-				
-This document is maintained in a collaborative wiki.  If you wish to update or modify this document please visit 
-https://wiki.eclipse.org/CDT/Autotools/User_Guide
-            </pageAppendum>
-		</mediawiki-to-eclipse-help>
-		<replace file="CDT/Autotools/User_Guide/User-Guide.html" token="{{#eclipseproject:tools.cdt}}" value=""/>
-	    <antcall target="test" />
-	</target>
-
-	<target name="test" description="verify that all of the HTML files are well-formed XML">
-		<echo level="info">
-Validating help content XML and HTML files: The Eclipse help system expects well-formed XML
-			
-If validation fails it is because either:
-			
-* the userguide source code is poorly formed, or
-* the WikiText MediaWiki parser has a bug
-			
-Problems with userguide source are usually caused by improper use of HTML markup in the MediaWiki source,
-or inadvertently starting a line with a space character (in MediaWiki this starts a preformatted block)
-		</echo>
-
-		<!-- 
-		Don't bother with DTD validation: we only care if the files are well-formed.
-		We therefore provide an empty DTD 
-		-->
-		<echo file="tmp/__empty.dtd" message="" />
-		<xmlvalidate lenient="true">
-			<fileset dir="CDT">
-				<include name="**/*.html" />
-			</fileset>
-			<dtd publicid="-//W3C//DTD XHTML 1.0 Transitional//EN" location="${basedir}/tmp/__empty.dtd" />
-		</xmlvalidate>
-		<delete dir="tmp"/>
-	</target>
-</project>
diff --git a/build/org.eclipse.cdt.autotools.docs/pom.xml b/build/org.eclipse.cdt.autotools.docs/pom.xml
index 88e5b6c4241..dc6f395604a 100644
--- a/build/org.eclipse.cdt.autotools.docs/pom.xml
+++ b/build/org.eclipse.cdt.autotools.docs/pom.xml
@@ -87,41 +87,6 @@
 				</plugins>
 			</build>
 		</profile>
-		<profile>
-			<id>regenHelp</id>
-			<build>
-				<plugins>
-					<plugin>
-						<artifactId>maven-antrun-plugin</artifactId>
-						<executions>
-							<execution>
-								<id>helpdocs</id>
-								<phase>generate-resources</phase>
-								<configuration>
-									<target>
-										<taskdef classpathref="maven.plugin.classpath"
-											resource="org/eclipse/mylyn/wikitext/mediawiki/ant/tasks.properties" />
-										<taskdef classpathref="maven.plugin.classpath"
-											resource="org/eclipse/mylyn/wikitext/ant/tasks.properties" />
-										<ant antfile="build-helper.xml" target="all" />
-									</target>
-								</configuration>
-								<goals>
-									<goal>run</goal>
-								</goals>
-							</execution>
-						</executions>
-						<dependencies>
-							<dependency>
-								<groupId>org.eclipse.mylyn.docs</groupId>
-								<artifactId>org.eclipse.mylyn.wikitext.mediawiki.ant</artifactId>
-								<version>3.0.25</version>
-							</dependency>
-						</dependencies>
-					</plugin>
-				</plugins>
-			</build>
-		</profile>
 		<profile>
 			<id>fake-doc</id>
 			<activation>
diff --git a/build/org.eclipse.cdt.meson.docs/CDT/Meson/User_Guide/Updating-This-Document.html b/build/org.eclipse.cdt.meson.docs/CDT/Meson/User_Guide/Updating-This-Document.html
index 8db463650cf..e45b2ee6c32 100644
--- a/build/org.eclipse.cdt.meson.docs/CDT/Meson/User_Guide/Updating-This-Document.html
+++ b/build/org.eclipse.cdt.meson.docs/CDT/Meson/User_Guide/Updating-This-Document.html
@@ -26,9 +26,9 @@
 			</tr>
 		</table><hr class="navigation-separator"/>
 		<h1 id="Updating_This_Document">Updating This Document</h1>
-		<p>This document is maintained in a collaborative wiki.  If you wish to update or modify this document please visit 
-
-			<a href="https://wiki.eclipse.org/CDT/Meson/User_Guide">https://wiki.eclipse.org/CDT/Meson/User_Guide</a>
+		<p>This document is maintained in Git. Please see provide a Pull Request following the <a
+			href="https://github.com/eclipse-cdt/cdt/blob/main/CONTRIBUTING.md">Eclipse CDT contribution guide</a> to <a
+			href="org.eclipse.cdt.autotools.docs">https://github.com/eclipse-cdt/cdt/tree/main/build/org.eclipse.cdt.meson.docs/CDT/Meson/User_Guide/</a>
 		</p><hr class="navigation-separator"/>
 		<table class="navigation" style="width: 100%;" border="0" summary="navigation">
 			<tr>
diff --git a/build/org.eclipse.cdt.meson.docs/build-helper.xml b/build/org.eclipse.cdt.meson.docs/build-helper.xml
deleted file mode 100644
index d013909f9a3..00000000000
--- a/build/org.eclipse.cdt.meson.docs/build-helper.xml
+++ /dev/null
@@ -1,65 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
-    Copyright (c) 2018 Red Hat, Inc.
-    This program and the accompanying materials
-    are made available under the terms of the Eclipse Public License 2.0
-    which accompanies this distribution, and is available at
-    https://www.eclipse.org/legal/epl-2.0/
-    
-    SPDX-License-Identifier: EPL-2.0
-   
-    Contributors:
-        Red Hat - initial API and implementation
- -->
-<project name="org.eclipse.cdt.meson.docs" default="all">
-    <description>
-            Generate Eclipse help content for the CDT meson user guide
-    </description>
-
-	<property name="meson.help.doc.url.base" value="http://wiki.eclipse.org"/>
-	<property name="meson.wiki.url.base" value="${meson.help.doc.url.base}/CDT/Meson"/>
-	<property name="imageFolder" value="images"/>
-
-	<target name="all" description="Generate Eclipse help content for the CDT Meson user guide">
-		<mediawiki-to-eclipse-help wikiBaseUrl="${meson.help.doc.url.base}" title="Meson Plug-in User Guide" formatoutput="true" dest="." templateExcludes="*eclipseproject*">
-
-			<path name="CDT/Meson/User_Guide" title="Meson Plug-in User Guide" generateToc="false"/>
-			<stylesheet url="book.css" />
-			<pageAppendum>
-= Updating This Document =
-				
-This document is maintained in a collaborative wiki.  If you wish to update or modify this document please visit 
-https://wiki.eclipse.org/CDT/Meson/User_Guide
-            </pageAppendum>
-		</mediawiki-to-eclipse-help>
-		<replace file="CDT/Meson/User_Guide/User-Guide.html" token="{{#eclipseproject:tools.cdt}}" value=""/>
-	    <antcall target="test" />
-	</target>
-
-	<target name="test" description="verify that all of the HTML files are well-formed XML">
-		<echo level="info">
-Validating help content XML and HTML files: The Eclipse help system expects well-formed XML
-			
-If validation fails it is because either:
-			
-* the userguide source code is poorly formed, or
-* the WikiText MediaWiki parser has a bug
-			
-Problems with userguide source are usually caused by improper use of HTML markup in the MediaWiki source,
-or inadvertently starting a line with a space character (in MediaWiki this starts a preformatted block)
-		</echo>
-
-		<!-- 
-		Don't bother with DTD validation: we only care if the files are well-formed.
-		We therefore provide an empty DTD 
-		-->
-		<echo file="tmp/__empty.dtd" message="" />
-		<xmlvalidate lenient="true">
-			<fileset dir="CDT">
-				<include name="**/*.html" />
-			</fileset>
-			<dtd publicid="-//W3C//DTD XHTML 1.0 Transitional//EN" location="${basedir}/tmp/__empty.dtd" />
-		</xmlvalidate>
-		<delete dir="tmp"/>
-	</target>
-</project>
diff --git a/build/org.eclipse.cdt.meson.docs/pom.xml b/build/org.eclipse.cdt.meson.docs/pom.xml
index 3473800753b..1365b72d9c9 100644
--- a/build/org.eclipse.cdt.meson.docs/pom.xml
+++ b/build/org.eclipse.cdt.meson.docs/pom.xml
@@ -87,41 +87,6 @@
 				</plugins>
 			</build>
 		</profile>
-		<profile>
-			<id>regenHelp</id>
-			<build>
-				<plugins>
-					<plugin>
-						<artifactId>maven-antrun-plugin</artifactId>
-						<executions>
-							<execution>
-								<id>helpdocs</id>
-								<phase>generate-resources</phase>
-								<configuration>
-									<target>
-										<taskdef classpathref="maven.plugin.classpath"
-											resource="org/eclipse/mylyn/wikitext/mediawiki/ant/tasks.properties" />
-										<taskdef classpathref="maven.plugin.classpath"
-											resource="org/eclipse/mylyn/wikitext/ant/tasks.properties" />
-										<ant antfile="build-helper.xml" target="all" />
-									</target>
-								</configuration>
-								<goals>
-									<goal>run</goal>
-								</goals>
-							</execution>
-						</executions>
-						<dependencies>
-							<dependency>
-								<groupId>org.eclipse.mylyn.docs</groupId>
-								<artifactId>org.eclipse.mylyn.wikitext.mediawiki.ant</artifactId>
-								<version>3.0.23</version>
-							</dependency>
-						</dependencies>
-					</plugin>
-				</plugins>
-			</build>
-		</profile>
 		<profile>
 			<id>fake-doc</id>
 			<activation>