git: 8c922db4f3d9 - stable/14 - syscons: add deprecation notice

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Mon, 04 Nov 2024 13:55:10 UTC
The branch stable/14 has been updated by emaste:

URL: https://cgit.FreeBSD.org/src/commit/?id=8c922db4f3d9dc41f228357d391f0a899292427e

commit 8c922db4f3d9dc41f228357d391f0a899292427e
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2024-11-01 16:51:01 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2024-11-04 13:54:10 +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)
---
 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