Rewrite the platform Tier definitions.

Rewrite the prose description of Tiers to be structured as bullet
lists of guarantees to users from the Project, guarantees to
developers from the Project, and obligations on developers.

This includes definitions of userland and kernel ABIs as well as
documenting our current practice of ABI stability.

The committments for ports are still vague and will require further
refinement.

Move the Tier status of architectures out of the committers guide and
into a table on the platforms page the website listing the Tier for
each architecture across currently supported stable branches as well
as the projected Tiers for the next stable branch (in this case,
13.x).  The table also lists individual TARGET_ARCH values to permit
more granularity in Tier definitions (e.g. hard-float vs soft-float).

Update the Unsupported Platforms table to only list removed
architectures and include the last supported release of these
architectures.  This required adding anchors for relevant releases on
the releases page.

Reviewed by:	bcr
Discussed with:	developers@
Differential Revision:	https://reviews.freebsd.org/D22439
This commit is contained in:
John Baldwin 2019-11-21 17:38:49 +00:00
parent a29c43d60a
commit 2df62d170d
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=53619
3 changed files with 429 additions and 177 deletions

View file

@ -13,96 +13,186 @@
<body class="navinclude.developers">
<p>If you have comments about a port, or wish to provide feedback to
the developers, send it to the relevant mailing list.</p>
<h2>Supported Platforms</h2>
<p>Here is a list of platforms that FreeBSD currently supports.</p>
<p>Here is a list of platforms supported by FreeBSD.</p>
<table>
<table class="tblbasic">
<thead>
<tr>
<td>Platform</td>
<td>Mailing List</td>
<td><a href="https://www.freebsd.org/doc/en_US.ISO8859-1/articles/committers-guide/archs.html">Support Tier</a></td>
<td>Platform Name</td>
<td>TARGET_ARCH</td>
<td>11.x <a href="&base;/doc/en_US.ISO8859-1/articles/committers-guide/archs.html">Support Tier</a></td>
<td>12.x <a href="&base;/doc/en_US.ISO8859-1/articles/committers-guide/archs.html">Support Tier</a></td>
<td>Projected 13.x <a href="&base;/doc/en_US.ISO8859-1/articles/committers-guide/archs.html">Support Tier</a></td>
</tr>
</thead>
<tbody>
<tr>
<td><a href="amd64.html">amd64 (x86-64)</a></td>
<td><a href="mailto:freebsd-amd64@FreeBSD.org">freebsd-amd64@FreeBSD.org</a></td>
<td>64-bit x86</td>
<td><a href="amd64.html">amd64</a></td>
<td>Tier 1</td>
<td>Tier 1</td>
<td>Tier 1</td>
</tr>
<tr>
<td><a href="arm.html">ARM64</a></td>
<td><a href="mailto:freebsd-arm@FreeBSD.org">freebsd-arm@FreeBSD.org</a></td>
<td>Tier 2</td>
</tr>
<tr>
<td><a href="arm.html">ARM</a></td>
<td><a href="mailto:freebsd-arm@FreeBSD.org">freebsd-arm@FreeBSD.org</a></td>
<td>Tier 2</td>
</tr>
<tr>
<td><a href="i386.html">i386 (IA-32)</a></td>
<td><a href="mailto:freebsd-current@FreeBSD.org">freebsd-current@FreeBSD.org</a></td>
<td>32-bit x86</td>
<td><a href="i386.html">i386</a></td>
<td>Tier 1</td>
<td>Tier 1</td>
<td>Tier 1</td>
</tr>
<tr>
<td><a href="mips.html">MIPS</a></td>
<td><a href="mailto:freebsd-mips@FreeBSD.org">freebsd-mips@FreeBSD.org</a></td>
<td>PC98</td>
<td><a href="pc98.html">pc98</a></td>
<td>Tier 2</td>
<td>Tier 4</td>
<td>Tier 4</td>
</tr>
<tr>
<td>64-bit ARMv8</td>
<td><a href="arm.html">aarch64</a></td>
<td>Tier 2</td>
<td>Tier 2</td>
<td>Tier 2</td>
</tr>
<tr>
<td>32-bit ARMv4/5</td>
<td><a href="arm.html">arm</a></td>
<td>Tier 2</td>
<td>Tier 2</td>
<td>Tier 4</td>
</tr>
<tr>
<td>32-bit big-endian ARM</td>
<td><a href="arm.html">armeb</a></td>
<td>Tier 2</td>
<td>Tier 4</td>
<td>Tier 4</td>
</tr>
<tr>
<td>32-bit ARMv6</td>
<td><a href="arm.html">armv6</a></td>
<td>Tier 2</td>
<td>Tier 2</td>
<td>Tier 2</td>
</tr>
<tr>
<td>32-bit ARMv7</td>
<td><a href="arm.html">armv7</a></td>
<td><a href="#n-armv7">*1</a></td>
<td>Tier 2</td>
<td>Tier 2</td>
</tr>
<tr>
<td>32-bit MIPS soft-float</td>
<td><a href="mips.html">mips, mipsel</a></td>
<td>Tier 3</td>
<td>Tier 2</td>
<td>Tier 4 <a href="#n-gcc4">*2</a></td>
</tr>
<tr>
<td><a href="ppc.html">PowerPC (ppc)</a></td>
<td><a href="mailto:freebsd-ppc@FreeBSD.org">freebsd-ppc@FreeBSD.org</a></td>
<td>32-bit MIPS hard-float</td>
<td><a href="mips.html">mipshf, mipselhf</a></td>
<td></td>
<td>Tier 2</td>
<td>Tier 4 <a href="#n-gcc4">*2</a></td>
</tr>
<tr>
<td>32-bit MIPS n32</td>
<td><a href="mips.html">mipsn32</a></td>
<td>Tier 3</td>
<td>Tier 2</td>
<td>Tier 4 <a href="#n-gcc4">*2</a></td>
</tr>
<tr>
<td>64-bit MIPS soft-float</td>
<td><a href="mips.html">mips64, mips64el</a></td>
<td>Tier 3</td>
<td>Tier 2</td>
<td>Tier 4 <a href="#n-gcc4">*2</a></td>
</tr>
<tr>
<td>64-bit MIPS hard-float</td>
<td><a href="mips.html">mips64hf, mips64elhf</a></td>
<td></td>
<td>Tier 2</td>
<td>Tier 4 <a href="#n-gcc4">*2</a></td>
</tr>
<tr>
<td>32-bit PowerPC</td>
<td><a href="ppc.html">powerpc</a></td>
<td>Tier 2</td>
<td>Tier 2</td>
<td>Tier 4 <a href="#n-gcc4">*2</a></td>
</tr>
<tr>
<td>32-bit PowerPC with SPE</td>
<td><a href="ppc.html">powerpcspe</a></td>
<td></td>
<td>Tier 2</td>
<td>Tier 4 <a href="#n-gcc4">*2</a></td>
</tr>
<tr>
<td>64-bit PowerPC</td>
<td><a href="ppc.html">powerpc64</a></td>
<td>Tier 2</td>
<td>Tier 2</td>
<td>Tier 4 <a href="#n-gcc4">*2</a></td>
</tr>
<tr>
<td>64-bit RISC-V</td>
<td><a href="https://wiki.freebsd.org/riscv">riscv64,
riscv64sf</a></td>
<td></td>
<td>Tier 3</td>
<td>Tier 2</td>
</tr>
<tr>
<td>64-bit SPARCv9</td>
<td><a href="sparc.html">sparc64</a></td>
<td><a href="mailto:freebsd-sparc@FreeBSD.org">freebsd-sparc@FreeBSD.org</a></td>
<td>Tier 2</td>
<td>Tier 2</td>
<td>Tier 4 <a href="#n-gcc4">*2</a></td>
</tr>
</tbody>
</table>
<h3>Notes</h3>
<ol>
<li><a name="n-armv7"></a>armv7 platforms were supported by
armv6 prior to 12.0.</li>
<li><a name="n-gcc4"></a>These platforms will be transitioned to
Tier 4 for 13.0 unless their default toolchain is changed away
from GCC 4.2.1.</li>
</ol>
<h2>Unsupported Platforms</h2>
<table>
<p>These platforms were supported by older versions of FreeBSD.</p>
<table class="tblbasic">
<thead>
<tr>
<td>Project Page</td>
<td>Mailing List</td>
<td><a href="https://www.freebsd.org/doc/en_US.ISO8859-1/articles/committers-guide/archs.html">Support Tier</a></td>
<td>Platform Name</td>
<td>TARGET_ARCH</td>
<td>Last Supported Release</td>
</tr>
</thead>
<tbody>
<tr>
<td><a href="alpha.html">FreeBSD/alpha Project</a></td>
<td><a href="mailto:freebsd-alpha@FreeBSD.org">freebsd-alpha@FreeBSD.org</a></td>
<td>Tier 4 (support discontinued as of 7.0R)</td>
<td>Alpha</td>
<td><a href="alpha.html">alpha</a></td>
<td><a href="&base;/releases/index.html#rel6-4">6.4</a></td>
</tr>
<tr>
<td><a href="ia64/index.html">FreeBSD/ia64 Project</a></td>
<td><a href="mailto:freebsd-ia64@FreeBSD.org">freebsd-ia64@FreeBSD.org</a></td>
<td>Tier 2 through FreeBSD 10. Unsupported after.</td>
</tr>
<tr>
<td><a href="https://wiki.freebsd.org/riscv">FreeBSD/RISC-V Project</a></td>
<td><a href="mailto:freebsd-riscv@FreeBSD.org">freebsd-riscv@FreeBSD.org</a></td>
<td>Tier 3 beginning in FreeBSD 12</td>
</tr>
<tr>
<td><a href="pc98.html">FreeBSD/pc98 Project</a></td>
<td><a href="mailto:re-pc98@FreeBSD.org">re-pc98@FreeBSD.org</a></td>
<td>Tier 2 until FreeBSD 11. Unsupported after.</td>
<td>Intel IA-64</td>
<td><a href="ia64/index.html">ia64</a></td>
<td><a href="&base;/releases/index.html#rel10-4">10.4</a></td>
</tr>
</tbody>
</table>
<p>For general architecture questions, mail <a href="mailto:freebsd-arch@FreeBSD.org">freebsd-arch@FreeBSD.org</a></p>
</body>
</html>