The Samba-Bugzilla – Bug 4723
remove "Using samba" html documentation/book from 3.0 releases
Last modified: 2010-01-20 06:21:07 UTC
a user read the "Using samba" html documentation/book and now reported a bug that capter 6 the logging options are not correct.
Only in samba-3.0.25a/docs/htmldocs/index.html there is the info:
"Using Samba, Second Edition is a comprehensive guide to Samba administration. It covers all versions of Samba from 2.0 to 2.2, including selected features from an alpha version of 3.0, as well as the SWAT graphical configuration tool. Updated for Windows 2000, ME, and XP, the book also explores Samba's new role as a primary domain controller and domain member server, its support for the use of Windows NT/2000/XP authentication and filesystem security on the host Unix system, and accessing shared files and printers from Unix clients."
If you go directly into using_samba/ or use the online version on samba.org there is not this information.
I would suggest to remove this documentation from the 3.0.x releases or at least to add an information about the version like its done in the manpage
"This man page is correct for version 3.0 of the Samba suite."
I'm not happy to ask for this removal of this good book but if its outdated and confuses the user it makes sense IMHO.
Whats your opinion about this?
I'll remove the 2ed once I have the HTML files from the 3rd
ed. to replace them. I'll ping Andy @ O'Reilly again about this.
I'm afraid that "Using Samba" is still the 2nd edition, even in 3.3.0
Isn't there any possibility to provide the 3rd edition, as Jerry mentioned back in 2007?
As the 3rd edition is not available yet, we shouldn't ship 3.5 with the old version. Are there any objections?
*** Bug 7002 has been marked as a duplicate of this bug. ***
Using Samba 2nd edition will not be included in the 3.5 tarballs.
Closing out bug report.