svn commit: r53618 - in head/en_US.ISO8859-1/books/handbook: bsdinstall config eresources kernelconfig

[Ed Maste]

On Wed, 20 Nov 2019 at 13:12, Ed Maste <emaste at freebsd.org> wrote:
>
> Author: emaste (src committer)
> Date: Wed Nov 20 18:12:25 2019
> New Revision: 53618
> URL: https://svnweb.freebsd.org/changeset/doc/53618
>
> Log:
>   excise ia64 from the handbook
>
>   ia64 was last supported in 10.4.  No currently supported version of
>   FreeBSD supports ia64.

I really wanted to get rid of the obsolete references to ia64 as a
first step, but going through this also identified several places
where we missed adding new architectures; I'll comment on them (and
other notes) below.

> Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml
> ==============================================================================

At least arm64 should be added to the Minimum Hardware Requirements
section, as arm64 servers are available and installable the same way
as amd64 (e.g. UEFI boot from a USB stick or cdrom image and run
bsdinstall). The powerpc description in this section needs updating
too.

Later on we need to add a booting on arm64 section to go with the
existing Booting on i386 and amd64 etc. (also those fail to mention
UEFI so more updating needed).

> @@ -2710,8 +2698,8 @@ Starting sshd.</screen>
>      <para>If the system hangs while probing hardware during boot, or
>        it behaves strangely during install, <acronym>ACPI</acronym> may
>        be the culprit.  &os; makes extensive use of the system
> -      <acronym>ACPI</acronym> service on the &arch.i386;,
> -      &arch.amd64;, and ia64 platforms to aid in system configuration
> +      <acronym>ACPI</acronym> service on the &arch.i386; and
> +      &arch.amd64; platforms to aid in system configuration

Need to add arm64 to the list of ACPI-using platforms. We should
probably remove advice about disabling ACPI.

> Modified: head/en_US.ISO8859-1/books/handbook/config/chapter.xml
> ==============================================================================
> --- head/en_US.ISO8859-1/books/handbook/config/chapter.xml      Wed Nov 20 17:43:36 2019        (r53617)
> +++ head/en_US.ISO8859-1/books/handbook/config/chapter.xml      Wed Nov 20 18:12:25 2019        (r53618)
> @@ -3005,7 +3005,7 @@ kern.maxvnodes: 100000</screen>
>        </indexterm>
>
>        <para><acronym>ACPI</acronym> is present in all modern computers
> -       that conform to the ia32 (x86), ia64 (Itanium), and amd64
> +       that conform to the ia32 (x86) and amd64

More ACPI mentions

> Modified: head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml
> ==============================================================================
> --- head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml  Wed Nov 20 17:43:36 2019        (r53617)
> +++ head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml  Wed Nov 20 18:12:25 2019        (r53618)
> @@ -411,12 +411,6 @@
>             </row>
>
>             <row>
> -             <entry>&a.ia64.name;</entry>
> -             <entry>Porting &os; to &intel;'s upcoming IA64
> -               systems</entry>
> -           </row>

It's worth keeping the mailing list archive for historical reasons I
suppose, but it doesn't need to be listed here and doesn't need to
accept new mail. I'll follow up with postmaster.

> Modified: head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml
> ==============================================================================
> --- head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml        Wed Nov 20 17:43:36 2019        (r53617)
> +++ head/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml        Wed Nov 20 18:12:25 2019        (r53618)
> @@ -254,7 +254,7 @@ ath_hal(4)               - Atheros Hardware Access Lay
>        <filename>/usr/src/sys</filename>.  This directory contains a
>        number of subdirectories, including those which represent the
>        following supported architectures: <filename>amd64</filename>,
> -      <filename>i386</filename>, <filename>ia64</filename>,
> +      <filename>i386</filename>,
>        <filename>powerpc</filename>, and
>        <filename>sparc64</filename>.

arm, arm64, mips missing in this list.

>        that may run older applications.  Platforms that gained support
> -      after &os; 4.X, such as ia64 and &sparc64;, do not require
> +      after &os; 4.X, such as &sparc64;, do not require
>        this option.</para>

Since it seems sparc64 will be removed in the near future we should
choose a different "after 4.x" architecture.