svn commit: r367678 - head/usr.sbin/freebsd-update

[Rodney W. Grimes]

> Author: 0mp (doc,ports committer)
> Date: Sat Nov 14 13:07:41 2020
> New Revision: 367678
> URL: https://svnweb.freebsd.org/changeset/base/367678
> 
> Log:
>   Document the PAGER environment variable
>   
>   Sometimes users want to use freebsd-update(8) in a non-interactive way and
>   what they often miss is that they have to set PAGER to cat(1) in order to
>   avoid interactive prompts from less(1).

Which was caused by the change of invoking more(1) as less(1) causing
this regression, as when invoked as more(1) it falls off the end of
empty input and causes no such interactive prompt.

Setting PAGER to more(1) also fixes this.

>   
>   MFC after:	4 weeks
> 
> Modified:
>   head/usr.sbin/freebsd-update/freebsd-update.8
> 
> Modified: head/usr.sbin/freebsd-update/freebsd-update.8
> ==============================================================================
> --- head/usr.sbin/freebsd-update/freebsd-update.8	Sat Nov 14 12:02:50 2020	(r367677)
> +++ head/usr.sbin/freebsd-update/freebsd-update.8	Sat Nov 14 13:07:41 2020	(r367678)
> @@ -25,7 +25,7 @@
>  .\"
>  .\" $FreeBSD$
>  .\"
> -.Dd September 24, 2019
> +.Dd November 14, 2020
>  .Dt FREEBSD-UPDATE 8
>  .Os
>  .Sh NAME
> @@ -193,6 +193,20 @@ System", since if the system has been tampered with
>  it cannot be trusted to operate correctly.
>  If you intend to use this command for intrusion-detection
>  purposes, make sure you boot from a secure disk (e.g., a CD).
> +.El
> +.Sh ENVIRONMENT
> +.Bl -tag -width "PAGER"
> +.It Ev PAGER
> +The pager program used to present various reports during the execution.
> +.Po
> +Default:
> +.Dq Pa /usr/bin/less .
> +.Pc
> +.Pp
> +.Ev PAGER
> +can be set to
> +.Dq cat
> +when a non-interactive pager is desired.
>  .El
>  .Sh FILES
>  .Bl -tag -width "/etc/freebsd-update.conf"
> 

-- 
Rod Grimes                                                 rgrimes at freebsd.org