From d3ba9f3dbc046e319e2dd374de7458daec0c1bcf Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Thu, 6 Aug 2026 19:44:54 +0200 Subject: [PATCH 1/2] Rename the site documents ahead of converting them A pure rename, so that git records it and `git log --follow` and `git blame` still reach the history of each page after the conversion that follows. The content is still APT at this point and the site does not build between the two commits. --- src/site/{apt/index.apt => markdown/index.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename src/site/{apt/index.apt => markdown/index.md} (100%) 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 From 083e5b9aadf35ddbbabaca18625b76011fa6dbb7 Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Thu, 6 Aug 2026 19:44:54 +0200 Subject: [PATCH 2/2] Port the index page from APT to Markdown Converted with doxia-converter and then cleaned up by hand: - <<>> becomes backticks, <> becomes **bold**, {{{url}text}} becomes [text](url) - the ASF license header becomes a single block HTML comment - the page needs no Velocity, so it is a plain .md and the title, which was ${project.name}, is now spelled out Verified by building the site before and after: the rendered page is unchanged apart from / becoming / and quotes in prose picking up the Markdown module's typographic substitution. --- src/site/markdown/index.md | 89 +++++++++++++++----------------------- 1 file changed, 34 insertions(+), 55 deletions(-) diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md index 76f890b1f..85796bcb9 100644 --- a/src/site/markdown/index.md +++ b/src/site/markdown/index.md @@ -1,55 +1,34 @@ - ------ - Plexus Compiler - ------ - Hervé Boutemy - ------ - 2012-05-08 - ------ - -~~ 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 - -Plexus Compiler - - Plexus Compiler is a Plexus component to use different compilers through a uniform API. - - It is composed by: - - * {{{./plexus-compiler-api/}<<>>}}: the API to use compilers, - - * {{{./plexus-compiler-manager/}<<>>}}: a manager to choose a compiler, - - * {{{./plexus-compilers/}<<>>}}: different compilers - - * {{{./plexus-compilers/plexus-compiler-aspectj/}<<>>}}: AspectJ compiler, <> <<>> and <<>> - - * {{{./plexus-compilers/plexus-compiler-csharp/}<<>>}}: C#/Mono compiler, <> <<>> - - * {{{./plexus-compilers/plexus-compiler-eclipse/}<<>>}}: Eclipse compiler, <> <<>> and <<>> - - * {{{./plexus-compilers/plexus-compiler-javac/}<<>>}}: javac compiler, <> <<>> - - * {{{./plexus-compilers/plexus-compiler-javac-errorprone/}<<>>}}: javac compiler with {{{https://errorprone.info}error-prone}} static analysis checks enabled, <> <<>> - - [] - - * {{{./plexus-compiler-test/}<<>>}}: a test harness. - - [] + + +# Plexus Compiler + +Plexus Compiler is a Plexus component to use different compilers through a uniform API. + +It is composed by: + +- [`plexus-compiler-api`](./plexus-compiler-api/): the API to use compilers, +- [`plexus-compiler-manager`](./plexus-compiler-manager/): a manager to choose a compiler, +- [`plexus-compilers`](./plexus-compilers/): different compilers + - [`plexus-compiler-aspectj`](./plexus-compilers/plexus-compiler-aspectj/): AspectJ compiler, **requires** `JDK 17+` and `Maven 3.9.6+` + - [`plexus-compiler-csharp`](./plexus-compilers/plexus-compiler-csharp/): C#/Mono compiler, **requires** `JDK 8+` + - [`plexus-compiler-eclipse`](./plexus-compilers/plexus-compiler-eclipse/): Eclipse compiler, **requires** `JDK 17+` and `Maven 3.9.6+` + - [`plexus-compiler-javac`](./plexus-compilers/plexus-compiler-javac/): javac compiler, **requires** `JDK 8+` + - [`plexus-compiler-javac-errorprone`](./plexus-compilers/plexus-compiler-javac-errorprone/): javac compiler with [error-prone](https://errorprone.info) static analysis checks enabled, **requires** `JDK 11+` +- [`plexus-compiler-test`](./plexus-compiler-test/): a test harness.