slachiewicz opened a new pull request, #1363:
URL: https://github.com/apache/maven-site-plugin/pull/1363

   Brings the plugin's usage, FAQ, migration and example pages in line with 
master ahead of 3.23.0.
   
   Several pages stated behavior that no longer holds:
   
   - Deploying: only `file:` URLs work out of the box. The HTTP Wagon that 
ships with Maven cannot copy a directory, and WebDAV needs 
`wagon-webdav-jackrabbit`. The error quoted on the protocol page no longer 
exists, so the page now shows the real messages.
   - FAQ: the project `<url>` is used to relativize site descriptor links 
(`relativizeSiteLinks`), so the plugin does use it. Entities declared in a 
DOCTYPE work only when their value is a character reference; plain-text 
entities render empty, with or without validation.
   - Migration: a 3.22.x to 3.23.0 section covers the Maven 3.9.0 floor, 
`site:run` on the JDK HTTP server, and `-D` properties in the site descriptor. 
The Maven 2 and Doxia 1.1 notes are folded into one section that keeps their 
anchors, and the Velocity 1.5 downgrade advice is gone.
   - Configuring reports: the part that repeats the site guide is now a link to 
it; the report set example uses current plugin versions.
   - `site:run` and `site:auto-refresh`: documents `host`, `-Dport=0`, and that 
`auto-refresh` does not watch in batch mode.
   
   This PR does not touch `index.md.vm`, `site.xml` or `README.md`, which open 
PRs change.
   
   Verified: `site:run`, `site:stage`, `site:deploy` (file, scp, http, dav), 
`site:auto-refresh`, `moduleExcludes` and `-D` interpolation on a scratch 
project with 3.23.0-SNAPSHOT → log lines quoted on the pages are from those 
runs; no anchor of the live pages disappears.
   
   ---
   
   To make clear that you license your contribution under
   the [Apache License Version 2.0, January 
2004](https://www.apache.org/licenses/LICENSE-2.0)
   check one of the following:
   
   - [x] I hereby declare this contribution to be licensed under the [Apache 
License Version 2.0, January 2004](https://www.apache.org/licenses/LICENSE-2.0)
   - [x] I hereby declare that I have filed an [Apache Individual Contributor 
License Agreement](https://www.apache.org/licenses/icla.pdf).
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to