[Bug 285459] User-friendly documentation for alternate screen

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=285459

Graham Perrin <grahamperrin@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                URL|                            |https://github.com/freebsd/
                   |                            |freebsd-doc/blob/main/docum
                   |                            |entation/content/en/books/h
                   |                            |andbook/serialcomms/_index.
                   |                            |adoc#term

--- Comment #2 from Graham Perrin <grahamperrin@gmail.com> ---
Thanks, 

> Probably the PR is to document alternate screen in some handbooks, 
> is it right?

Correct, 

>> in the documentation portal

For end users:

* a conceptual introduction in the FreeBSD Handbook

* plus, ideally, <https://docs.freebsd.org/en/books/faq/> (something very
brief, 
  linking to the Handbook).

No mention of pseudo-terminals anywhere in the Handbook.
<https://docs.freebsd.org/en/books/handbook/serialcomms/#term> might be a good
place. 

<https://old.reddit.com/r/freebsd/comments/1dxd7bm/term_alternate_screen_buffer_xterm256color/mkg40m8/?context=1>
includes three quotes from a discussion in Matrix. If you have a Matrix ID, the
full discussion is a good example of confusion, part of which was lack of
awareness of the alternate screen.

-- 
You are receiving this mail because:
You are the assignee for the bug.