git: 2bc5b1d60512 - releng/14.2 - syscons: add deprecation notice

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Tue, 05 Nov 2024 04:20:31 UTC
The branch releng/14.2 has been updated by emaste:

URL: https://cgit.FreeBSD.org/src/commit/?id=2bc5b1d605125ee5dcd262339e3854678ff9acb7

commit 2bc5b1d605125ee5dcd262339e3854678ff9acb7
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2024-11-01 16:51:01 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2024-11-05 04:19:33 +0000

    syscons: add deprecation notice
    
    syscons(4) is not compatible with UEFI, does not support UTF-8, and is
    Giant-locked.  There is no specific timeline yet for removing it, but
    support for the Giant lock is expected to go away in one or two major
    release cycles.  Add a deprecation notice to avoid surprises, and help
    ensure that any material deficiencies in vt(4) become known.
    
    Reviewed by:    manu, markj, imp
    Sponsored by:   The FreeBSD Foundation
    Differential Revision: https://reviews.freebsd.org/D47396
    
    (cherry picked from commit fc2a3ec6fe6aa00d9be0c293c38e0ef9ac7e2b64)
    (cherry picked from commit 8c922db4f3d9dc41f228357d391f0a899292427e)
    
    Approved by:    re (cperciva)
---
 share/man/man4/syscons.4 | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/share/man/man4/syscons.4 b/share/man/man4/syscons.4
index 19ecd5e3746e..7e31680ced3f 100644
--- a/share/man/man4/syscons.4
+++ b/share/man/man4/syscons.4
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 25, 2022
+.Dd November 2, 2024
 .Dt SYSCONS 4
 .Os
 .Sh NAME
@@ -69,6 +69,14 @@ In
 In
 .Pa /boot/loader.conf :
 .Cd kern.vty=sc
+.Sh DEPRECATION NOTICE
+The
+.Nm
+console is deprecated, and will be removed in a future version of
+.Fx .
+Users are advised to migrate to the
+.Xr vt 4
+console instead.
 .Sh DESCRIPTION
 The
 .Nm