To be very clear, the docs should state the following:
1. For sharing with Windows clients, the share type must be set to Windows [Samba]
2. For sharing with Unix clients, the share type must be set to UNIX [NFS]
3. For sharing with Macintosh (or other AFP) clients, the type must be set to Mac [AFP]
Sharing a single dataset to multiple client types is NOT supported as the differences in the various file locking and permission semantics across these different operating systems may cause data corruption (in the case of lock contention) or unexpected permissions behavior. When the Windows type is used, Unix permission changes are in fact disallowed (chown/chmod does not work) as those changes would also cause the loss of important Windows ACLs.
If you must share the same dataset across heterogenous operating systems, then pick the same sharing protocol. Unix machines are capable of speaking SMB, and Windows machines are capable (albeit poorly) of speaking NFS. Macintosh clients can do any of the above (and are quite happy to use NFS or SMB as well as AFP)
[...]
We've been down this road before, and we got a lot of tickets from users who hung themselves trying to do this. Those users are, indeed, holding it wrong and can accomplish their goals using the more modern methods - they don't need to return their boxes to the bad old days when Samba lied and pretended to offer Unix permissions to Windows clients.