set_rcvar() function use?

[Pavel Timofeev]

Hello, dear community. I'm confused, please, help me.

There is a rc.subr function which was buried[1] and resurrected[2] after a
couple of years in almost the same form.

I don't know what happened behind the scenes, but I have a question.
Is it a preferable way to define a rc.conf variable these days in rc
scripts (again/over and over)?

If it is then I'd like to propose changes to FreeBSD porters handbook page
where basic rc script is described[3]
<https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/rc-scripts.html>

Also rc.subr(8) man page is missing set_rcvar() function description. BTW
it's missing a lot more functions description from rc.subr (are missing
functions for internal use only?)

If it's not then tell me please what it was resurrected for. Just curious
and for the record. I maintain several ports and want to know what is
considered the right/preferable way to write rc scripts.

[1]
https://lists.freebsd.org/pipermail/freebsd-current/2012-January/031246.html
     https://svnweb.freebsd.org/base?view=revision&revision=230099
     https://svnweb.freebsd.org/base?view=revision&revision=230103
     https://svnweb.freebsd.org/base?view=revision&revision=230105
[2] https://svnweb.freebsd.org/base?view=revision&revision=272393
[3]
https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/rc-scripts.html

<https://svnweb.freebsd.org/base?view=revision&revision=272393>