[Samba] online man pages outdated (latest is 4.17)

[Rowland Penny]

On Sun, 10 Nov 2024 18:20:33 +0100
Kees van Vloten via samba <samba at lists.samba.org> wrote:

> 
> Op 10-11-2024 om 18:10 schreef Rowland Penny via samba:
> > On Sun, 10 Nov 2024 17:46:56 +0100
> > Kees van Vloten via samba <samba at lists.samba.org> wrote:
> >
> >> Hi Samba team,
> >>
> >> In the release notes of 4.21 a new setting "sync machine password
> >> script" is mentioned and  it says "Check in smb.conf(5)", so that
> >> is what I am trying to do...
> >>
> >> When I browse to
> >> https://www.samba.org/samba/docs/current/man-html/smb.conf.5.html,
> >> it turns out that above parameter is not mentioned on this page.
> >>
> >>
> >> My guess is that something is broken in the release scripting.
> >> When I go to the page https://www.samba.org/samba/docs/man/, at
> >> the top of the page there is a list of released versions.
> >> It reads: " current 4.17 4.16 4.15 4.14 4.13 4.12 4.11 4.10 4.9 4.8
> >> 4.7 4.6 4.5 4.4 4.3 4.2 4.1 4.0 3.6 3.5 3.4 3.3 3.2", this makes me
> >> think that the delivery of man-pages failed as of 4.18 and
> >> "current" is in fact 4.17.
> >>
> >>
> >> I would be very handy to have 4.21 man-pages here as well.
> >>
> >> Can somebody have a look at the delivery process for these docs?
> >>
> >>
> >> - Kees.
> >>
> >>
> > Thanks for pointing that out, I cannot fix it, but I am sure someone
> > will.
> >
> > I have to ask though, what is wrong with opening a terminal on the
> > Samba server, typing 'man smb.conf' and pressing 'Enter' ?
> 
> You can only do that after upgrading to a version, and since I use 
> Ansible to do that I have to adapt the code before hand. If I don't I
> am quite certain something will not work as it did on some machines.

Yes, that would be a valid reason ;-)

> 
> Another reason is that a webbrowser is a lot more user friendly than 
> "man" on the commandline. But I understand opinions vary on this
> topic :-)

You could always do what I do, 'man smb.conf > smbconf.txt' and then
open smbconf.txt in your favourite editor.

Rowland