Documentation overhaul: markdown ports verified against the source, P10 S2S reference

INSTALL

@@ -7,8 +7,8 @@ ircu - INSTALL
 
 Compiling and installing ircu should be a fairly straightforward process,
 if you have obtained this software as a (.tar.gz) package, please consider
-using CVS (described below). Using CVS will make updating your installation
-much easier. 
+using git (described below). Using git will make updating your installation
+much easier.
 
 After obtaining the latest version of the ircu source code, change into the
 source directory (ircu2.10.xx.yy), and run "./configure". To see the various
@@ -40,22 +40,14 @@ compiled during "make" and installed to $PREFIX/bin/convert-conf.
 
 Good Luck!
 
-RETRIEVING IRCU VIA CVS
+RETRIEVING IRCU VIA GIT
 
-The recommended way to get the ircu package now is to use CVS.  CVS makes
-upgrades a lot less painful and lets you get the latest package.
+The recommended way to get the ircu package is to clone the git
+repository:
+# git clone https://github.com/UndernetIRC/ircu2.git
 
-The first thing you need to do is login to the cvs server:
-# cvs -d :pserver:anonymous@cvs.undernet.org:/cvsroot/undernet-ircu login
-
-(we recommend that you cut and paste the above line to use it :)
-When it prompts you for a password hit enter since there isn't one.
-
-To check out the the last development version of ircu, use:
-# cvs -d :pserver:anonymous@cvs.undernet.org:/cvsroot/undernet-ircu co -P ircu2.10
-The latest stable version has a tag name that depends on the version
-number; see doc/readme.cvs for details.
-
-To update your source tree to the latest version, run "cvs update -dP" from within the
-ircu2.10 directory. For more information, see http://coder-com.undernet.org.
+The default branch (main) is used for development; the current
+release series lives on u2_10_12_branch and releases are tagged.
+To update your source tree to the latest version, run "git pull"
+from within the ircu2 directory.
 

RELEASE.NOTES

@@ -37,7 +37,7 @@ from ircd-hybrid) that avoids some of the complications from using
 the full libresolv or adns libraries.
 
 The server can query an IAUTH external authorization server.  The
-protocol is described in doc/readme.iauth.  This allows an external
+protocol is described in doc/readme.iauth.md.  This allows an external
 program to accept or reject any client that connects to the server
 and allows that external program to assign an account stamp to the
 incoming user.

configure.ac

@@ -547,13 +547,13 @@ AC_MSG_CHECKING([if chroot operation is desired])
 AC_ARG_WITH([chroot],
 [  --with-chroot=dir       Specify that the server will be operated under
                           a different root directory given by dir.  See
-                          doc/readme.chroot for more information.],
+                          doc/history/readme.chroot for more information.],
 [unet_cv_with_chroot=$with_chroot],
 [AC_CACHE_VAL(unet_cv_with_chroot,
 [unet_cv_with_chroot=no])])
 
 if test x"$unet_cv_with_chroot" = xyes; then
-    AC_MSG_ERROR([--with-chroot given with no directory.  See doc/readme.chroot.])
+    AC_MSG_ERROR([--with-chroot given with no directory.  See doc/history/readme.chroot.])
 fi
 
 # Ensure there are no trailing /'s to mess us up

doc/example.conf

@@ -628,7 +628,7 @@ Kill
 # then TLS fingerprint and ciphers are used.  If "tls fingerprint" is
 # present, the other server must use a certificate with that fingerprint.
 # If "tls ciphers" is present, it is given to the TLS library to restrict
-# or prioritize particular algorithms.  (See TLS_CIPHERS in readme.features
+# or prioritize particular algorithms.  (See TLS_CIPHERS in readme.features.md
 # for details.)
 #
 # TLS trust for outbound server links is configured per Connect block.
@@ -704,7 +704,7 @@ Connect {
 # [crule]
 #
 # For an advanced, real-time rule-based routing decision making system
-# you can use crule blocks. For more information, see doc/readme.crules.
+# you can use crule blocks. For more information, see doc/readme.crules.md.
 # If more than one server mask is present in a single crule, the rule
 # applies to all servers.
 # CRULE
@@ -839,7 +839,7 @@ Operator {
 #  # want WebIRC ports to also be hidden.
 #  WebIRC = yes;
 #  # Setting tls ciphers affects which TLS cipher suites are allowed on
-#  # this port.  See TLS_CIPHERS in readme.features for more details.
+#  # this port.  See TLS_CIPHERS in readme.features.md for more details.
 #  tls ciphers = "";
 #  tls cacertfile = "/etc/ircd/network-ca.pem";
 #  tls cacertdir = "/etc/ircd/trust/";
@@ -1079,15 +1079,15 @@ IPCheck {
 # are listed below, and at the bottom is how to set logging.
 #
 # A Special Thanks to Kev for writing the documentation of F:lines.  It can
-# be found at doc/readme.features and the logging documentation can be
-# found at doc/readme.log.  The defaults used by the Undernet network are
+# be found at doc/readme.features.md and the logging documentation can be
+# found at doc/readme.log.md.  The defaults used by the Undernet network are
 # below.
 #
 features
 {
 # These log features are the only way to get certain error messages
 # (such as when the server dies from being out of memory).  For more
-# explanation of how they work, see doc/readme.log.
+# explanation of how they work, see doc/readme.log.md.
  "LOG" = "SYSTEM" "FILE" "ircd.log";
  "LOG" = "SYSTEM" "LEVEL" "CRIT";
 #  "DOMAINNAME"="<obtained from /etc/resolv.conf by ./configure>";

doc/features.txt

@@ -8,7 +8,7 @@ numeric replies should be added here too.
 Extended Who information: (WHOX)
  Version: unknown, but at least 2.10.07+
 
- This is described in the file 'readme.who'
+ This is described in the file 'readme.who.md'
 
 USERIP:
  Version: unknown, but at least 2.10.07+
@@ -140,7 +140,7 @@ User modes:
       undernet service bots (X/W/UWorld etc)
   +g: List channel HACK:'s
   +s: Server messages - takes a parameter of which masks to send, see
-      'snomask.html' for more details. (2.10.0+)
+      'snomask.md' for more details. (2.10.0+)
   +R: Block unauthenticated users.  PRIVMSG, NOTICE and INVITE from users
       that are not authenticated to a registered account are blocked.
       PRIVMSG and INVITE are rejected with ERR_NEEDREGGEDNICK (477);