Update for latest FPC / Delphi versions

Author: michaliskambi

src/CompilingPasDoc.asciidoc

@@ -1,58 +1,57 @@
 :doctitle: Compiling PasDoc from sources
+:sectnums:
+:toc: left
+:toclevels: 4
 
-How to compile link:index[PasDoc]?
+## Get the source code
 
-## [[fpc]] FPC
-
-The preferred http://www.freepascal.org/[FreePascal] version should always be the latest stable FPC release. Any FPC >= 2.6.0 is supported, although compilation with older versions is less extensively tested. Using the latest stable FPC is always the best option.
-
-Compile by simply executing
+First of all, get https://github.com/pasdoc/pasdoc/[our source code from GitHub]. E.g.
 
 ```
-make
+git clone https://github.com/pasdoc/pasdoc.git
 ```
 
-in the main repository directory.
-
-NOTE: You must use GNU make. Under Linux this is the standard `make`. Under Windows it is included with FPC installation (you can also get it with http://www.mingw.org/[MinGW] or http://www.cygwin.com/[Cygwin]). Under FreeBSD it's called `gmake`.
-
-### [[lazarus]] Lazarus
+## [[fpc]] Build with command-line FPC
 
-Lazarus version required is 1.0.10 or later. Using the latest stable Lazarus version is always adviced and best tested.
+You can build with command-line https://www.freepascal.org/[Free Pascal Compiler (FPC)].
 
-* You can install pasdoc components by installing `source/packages/lazarus/pasdoc_package.lpk`. This package is used by console `pasdoc` and by `pasdoc_gui`.
-* You can compile console pasdoc from Lazarus by compiling `source/console/pasdoc.lpi`.
-* You can compile `pasdoc_gui` from Lazarus by compiling `source/gui/pasdoc_gui.lpi`.
+_Requirements_: We need FPC with `Generics.Collections` support, which implies FPC >= 3.2.0.
 
-## [[delphi]] Delphi
+From the command-line, compile by simply executing
 
-In theory, the project can support even Delphi versions >= 5. However, it wasn't tested with so old Delphi versions for a long time. Using Delphi >= 11 is advised.
+```
+make
+```
 
-### [[compiling-from-the-ide-1]] Compiling from the IDE
+in the main repository directory.
 
-Open the Delphi project in `source/console/` and build as usual.
+[NOTE]
+====
+You must use _GNU make_.
 
-NOTE: The reason why the project file does not contain a list of all units including full filenames is that older versions of Delphi do not support a forward slash in paths while Kylix does not support backslashes. We may fix it, since we longer support Kylix.
+- Under Linux this is the standard `make`.
+- Under Windows it is included with FPC installation (you can also get it with http://www.mingw.org/[MinGW] or http://www.cygwin.com/[Cygwin]).
+- Under FreeBSD it's called `gmake`.
+- Under MacOS it's called `gmake` and you can install it with `brew install make` (using https://brew.sh/[Homebrew]).
+====
 
-### [[compiling-using-the-makefile-1]] Compiling using the Makefile
+### [[lazarus]] Build with Lazarus
 
-You can compile using the command
+https://www.lazarus-ide.org/[Lazarus is an IDE using FPC under the hood].
 
-```
-make build-delphi-win32
-```
+_Requirements_: Any Lazarus version that supports FPC >= 3.2.0 should be able to compile pasdoc.
 
-### [[delphi-5-specific-notes]] Delphi 5 specific notes
+- First, open and build the package with our components by installing `source/packages/lazarus/pasdoc_package.lpk`.
 
-You must do one specific thing to compile pasdoc with Delphi 5 (and not later):
+- Build the command-line PasDoc by opening the `source/console/pasdoc.lpi` project in Lazarus and compiling it.
 
-* Add "..\component\strutils" to your units search path.
+- Build the GUI PasDoc by opening the `source/gui/pasdoc_gui.lpi` project in Lazarus and compiling it.
 
-### [[using-fastmm-memory-manager]] Using FastMM memory manager
+## [[delphi]] Build with Delphi
 
-You can speed up pasdoc a little (about 17%) by using http://sourceforge.net/projects/fastmm[FastMM memory manager]. Just download FastMM, add it to your Delphi units path, and define symbol USE_FASTMM when compiling.
+_Requirements_: Any Delphi with `Generics.Collections` support should be good, which in theory means >= 2009. We actively test (using GitHub Actions) with Delphi 10 and 12 right now.
 
-This is not necessary with newer Delphi versions, as they already include FastMM.
+To build the command-line PasDoc, open the Delphi project in `source/console/` and build as usual.
 
 ## [[see-also-release-making]] See also: release making
 

src/ReleaseMaking.asciidoc

@@ -1,6 +1,11 @@
 :doctitle: Process of making new PasDoc release
+:sectnums:
+:toc: left
+:toclevels: 4
 
-Release making process:
+## Introduction
+
+This page describes the process of making a new https://github.com/pasdoc/pasdoc/releases[PasDoc release]. Unless you're a PasDoc maintainer, you probably don't care about the details described here.
 
 ## Change version number to next stable
 
@@ -77,7 +82,9 @@ For basic test of  pasdoc_gui, open the project with pasdoc's autodoc source/aut
 
 * Go to https://github.com/pasdoc/pasdoc/releases and create a new release from tag
 
-* Upload there the release. Right now Michalis has this automated by https://github.com/github-release/github-release[github-release] on https://github.com/castle-engine/castle-engine/wiki/Cloud-Builds-(Jenkins)[Castle Game Engine Jenkins infrastructure] server.
+* Upload there the release.
+
+* Mark it as "latest", make sure https://github.com/pasdoc/pasdoc/releases/latest[latest release] page links to it.
 
 ## [[final-things-to-do]] Final things to do