Replace all occurences of PLATFORMS file with reference to the ARM

The conf.py exclude_patterns now includes platforms.rst to avoid
problems with redefining labels:
https://github.com/sphinx-doc/sphinx/issues/1668#issuecomment-71376208

Plain-text README file was regenerated using commands from v9.16
Makefile.

(cherry-picked from commit 920a2e730b)

HISTORY

@@ -39,9 +39,9 @@ built. Very old versions of OpenSSL are no longer supported. Cryptography
 is now mandatory: building BIND without DNSSEC is no longer supported.
 
 Special code to support certain legacy operating systems has also been
-removed; see the file PLATFORMS.md for details of supported platforms. In
-addition to OpenSSL, BIND now requires support for IPv6, threads, and
-standard atomic operations provided by the C compiler.
+removed; see the doc/arm/platforms.rst file for details of supported
+platforms. In addition to OpenSSL, BIND now requires support for IPv6,
+threads, and standard atomic operations provided by the C compiler.
 
 BIND 9.12
 

HISTORY.md

@@ -47,7 +47,7 @@ Cryptography is now mandatory: building BIND without DNSSEC is no
 longer supported.
 
 Special code to support certain legacy operating systems has also
-been removed; see the file [PLATFORMS.md](PLATFORMS.md) for details
+been removed; see the [doc/arm/platforms.rst](platforms) file for details
 of supported platforms. In addition to OpenSSL, BIND now requires
 support for IPv6, threads, and standard atomic operations provided
 by the C compiler.

README

@@ -51,7 +51,8 @@ the file CHANGES. See below for details on the CHANGES file format.
 For up-to-date versions and release notes, see https://www.isc.org/
 download/.
 
-For information about supported platforms, see PLATFORMS.
+For information about supported platforms, see the "Supported Platforms"
+section in the BIND 9 Administrator Reference Manual.
 
 Reporting bugs and getting help
 

README.md

@@ -62,7 +62,9 @@ CHANGES file format.
 For up-to-date versions and release notes, see
 [https://www.isc.org/download/](https://www.isc.org/download/).
 
-For information about supported platforms, see [PLATFORMS](PLATFORMS.md).
+For information about supported platforms, see the
+["Supported Platforms"](doc/arm/platforms.rst) section in the BIND 9
+Administrator Reference Manual.
 
 ### <a name="help"/> Reporting bugs and getting help
 

doc/arm/conf.py

@@ -150,6 +150,7 @@ exclude_patterns = [
     'logging-cattegories.rst',
     'managed-keys.rst',
     'pkcs11.rst',
+    'platforms.rst',
     'plugins.rst'
     ]
 

doc/arm/notes.rst

@@ -34,23 +34,7 @@ proceed in the unstable 9.17 branch.
 Supported Platforms
 -------------------
 
-To build on Unix-like systems, BIND requires support for POSIX.1c
-threads (IEEE Std 1003.1c-1995), the Advanced Sockets API for IPv6
-(:rfc:`3542`), and standard atomic operations provided by the C
-compiler.
-
-The libuv asynchronous I/O library and the OpenSSL cryptography library
-must be available for the target platform. A PKCS#11 provider can be
-used instead of OpenSSL for Public Key cryptography (i.e., DNSSEC
-signing and validation), but OpenSSL is still required for general
-cryptography operations such as hashing and random number generation.
-
-More information can be found in the ``PLATFORMS.md`` file that is
-included in the source distribution of BIND 9. If your compiler and
-system libraries provide the above features, BIND 9 should compile and
-run. If that is not the case, the BIND development team will generally
-accept patches that add support for systems that are still supported by
-their respective vendors.
+See the :ref:`supported_os` section in the :ref:`Requirements` chapter.
 
 Download
 --------

doc/arm/platforms.rst

@@ -9,6 +9,8 @@
 .. See the COPYRIGHT file distributed with this work for additional
 .. information regarding copyright ownership.
 
+.. _supported_os:
+
 Supported platforms
 -------------------
 

doc/arm/requirements.rst

@@ -9,7 +9,7 @@
 .. See the COPYRIGHT file distributed with this work for additional
 .. information regarding copyright ownership.
 
-.. Requirements:
+.. _Requirements:
 
 BIND Resource Requirements
 ==========================
@@ -70,6 +70,4 @@ much memory or CPU power as in the first alternative, but this has the
 disadvantage of making many more external queries, as none of the name
 servers share their cached data.
 
-.. _supported_os:
-
 .. include:: platforms.rst