git: abb0d7d36693 - main - make.conf: DOC_LANG and PRINTERDEVICE clarifications in man and example

[Ceri Davies]

The branch main has been updated by ceri (doc committer):

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

commit abb0d7d36693d32631a4631631369e30387c3227
Author:     Ceri Davies <ceri at FreeBSD.org>
AuthorDate: 2021-06-14 08:53:34 +0000
Commit:     Ceri Davies <ceri at FreeBSD.org>
CommitDate: 2021-06-14 08:53:34 +0000

    make.conf: DOC_LANG and PRINTERDEVICE clarifications in man and example
---
 share/examples/etc/make.conf |  8 ++++----
 share/man/man5/make.conf.5   | 18 +++++++-----------
 2 files changed, 11 insertions(+), 15 deletions(-)

diff --git a/share/examples/etc/make.conf b/share/examples/etc/make.conf
index bd8ca5d2cb4c..c40a35c0f868 100644
--- a/share/examples/etc/make.conf
+++ b/share/examples/etc/make.conf
@@ -143,8 +143,8 @@
 #WITHOUT_MANCOMPRESS=t
 #
 #
-# Default format for system documentation, depends on your printer.
-# Set this to "ascii" for simple printers or screen.
+# Default format for system documentation in share/doc, depends on
+# your printer.  Set this to "ascii" for simple printers or screen.
 #
 #PRINTERDEVICE=	ps
 #
@@ -196,9 +196,9 @@
 #
 # Documentation
 #
-# The list of languages and encodings to build and install.
+# The list of languages to build and install.
 #
-#DOC_LANG=	en_US.ISO8859-1 ru_RU.KOI8-R
+#DOC_LANG=	en ru
 #
 #
 # sendmail
diff --git a/share/man/man5/make.conf.5 b/share/man/man5/make.conf.5
index b8bb71ddc165..5885d9476d71 100644
--- a/share/man/man5/make.conf.5
+++ b/share/man/man5/make.conf.5
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 11, 2021
+.Dd June 14, 2021
 .Dt MAKE.CONF 5
 .Os
 .Sh NAME
@@ -613,20 +613,16 @@ The value assigned is the highest optimization value used.
 The following list provides a name and short description for variables
 that are used when building documentation.
 .Bl -tag -width ".Va PRINTERDEVICE"
-.It Va DISTDIR
-.Pq Vt str
-Where distfiles are kept.
-Normally, this is
-.Pa distfiles
-in
-.Va PORTSDIR .
 .It Va DOC_LANG
 .Pq Vt str
-The list of languages and encodings to build and install.
+The list of languages to build and install when building documentation
+in
+.Pa /usr/doc .
 .It Va PRINTERDEVICE
 .Pq Vt str
-The default format for system documentation, depends on your
-printer.
+The default format for system documentation in
+.Pa /usr/src/share/doc ,
+depends on your printer.
 This can be set to
 .Dq Li ascii
 for simple printers, or