All parameters need to be documented in the smb.conf manpage for a release.
Do we have docs on creating the docs? :)
Sure! /query jelmer Then type help ;)
Writing smb.conf documentation should not have changed significantly. Just edit the files in docs-xml/smbdotconf. "make undocumented" lists all undocumented parameters: 'directory' is not documented 'privatedirectory' is not documented 'rootdir' is not documented 'root' is not documented 'user' is not documented 'users' is not documented 'group' is not documented 'writeok' is not documented 'writable' is not documented 'createmode' is not documented 'directorymode' is not documented 'onlyguest' is not documented 'public' is not documented 'allowhosts' is not documented 'denyhosts' is not documented 'debuglevel' is not documented 'timestamplogs' is not documented 'maxprotocol' is not documented 'protocol' is not documented 'minprotocol' is not documented 'clientmaxprotocol' is not documented 'clientminprotocol' is not documented 'unicode' is not documented 'cldapport' is not documented 'dgramport' is not documented 'nbtport' is not documented 'krb5port' is not documented 'kpasswdport' is not documented 'webport' is not documented 'rpcbigendian' is not documented 'printcap' is not documented 'printok' is not documented 'printer' is not documented 'casesignames' is not documented 'preferedmaster' is not documented 'browsable' is not documented 'ldappasswordsync' is not documented 'autoservices' is not documented 'lockdir' is not documented 'ntpsigndsocketdirectory' is not documented 'default' is not documented 'socketaddress' is not documented 'afstokenlifetime' is not documented 'lognttokencommand' is not documented 'exec' is not documented 'vfsobject' is not documented 'winbinduid' is not documented 'winbindgid' is not documented 'winbinddsocketdirectory' is not documented 'winbinddprivilegedsocketdirectory' is not documented 'winbindsealedpipes' is not documented 'allowdnsupdates' is not documented 'dnsforwarder' is not documented 'dnsupdatecommand' is not documented 'nsupdatecommand' is not documented 'rndccommand' is not documented 'sambakcccommand' is not documented 'serverservices' is not documented 'dcerpcendpointservers' is not documented 'spnupdatecommand' is not documented 'sharebackend' is not documented 'ntvfshandler' is not documented 'tlsenabled' is not documented 'tlskeyfile' is not documented 'tlscertfile' is not documented 'tlscafile' is not documented 'tlscrlfile' is not documented 'tlsdhparamsfile' is not documented
And what exactly do I put into these files? "Not changed" doesn't really help if you've never written a manpage entry before. What do the parameters in <samba:parameter> mean? I assume "context" means "share" or "global", but what's the rest? If I have a list of allowed enum values, what do I put into "type", and what is "advanced" and "developer"?
(In reply to comment #5) > And what exactly do I put into these files? "Not changed" doesn't really help > if you've never written a manpage entry before. a simple recipe: I (and I guess most others) just take a similar man page xml file and do copy/paste the skeleton (or the whole file) see which tags are being used for what and adopt the content :-)
I think this is fixed: commit 6461f02229ebf1bcac31f182f51042fa32877eb8 Author: Jelmer Vernooij <jelmer@samba.org> Date: Fri Sep 28 21:25:50 2012 -0700 smb.conf(5): Add basic documentation for 'nsupdate command'. (cherry picked from commit aad30c062fd176fa15994a44a0178d51764cdbf7) commit a2090ad3f8c06ef66ddfbb123e7fd1e6eff278c3 Author: Jelmer Vernooij <jelmer@samba.org> Date: Fri Sep 28 10:35:06 2012 -0700 smb.conf(5): Add basic documentation for 'allow dns updates'. (cherry picked from commit 68fdcaa6b7f69c622df958413ee3809e56861c04) commit b484ad5aca8a78e0405b2aa168dd86a85223b6c0 Author: Jelmer Vernooij <jelmer@samba.org> Date: Fri Sep 28 10:31:08 2012 -0700 smb.conf(5): Add basic documentation for 'rndc command'. (cherry picked from commit b0b0266aa70721ebfea8dbc2602e81984a3b6023) commit 20e41e6bfaab2d38d904729754f83db25e7bf1dc Author: Jelmer Vernooij <jelmer@samba.org> Date: Fri Sep 28 10:16:08 2012 -0700 smb.conf(5): Add basic documentation for 'dns update command'. (cherry picked from commit 4ccea7f86796070ae6dbf404aa93ad4e5a7ae66e) commit 7a1584e353c729721d9c1825b22d30636f9ea62f Author: Jelmer Vernooij <jelmer@samba.org> Date: Thu Sep 27 13:38:31 2012 -0700 smb.conf(5): Add basic documentation for 'dns forwarder'. (cherry picked from commit e9d91cd4a133d7acb377341282230f99f5e10a12