---------------------------------------
- Note in particular two files - INSTALL.txt and DIAGNOSIS.txt
- You should also pay close attention to all the files with a
- .txt extension.
+---- ----------------------
+
+ The Samba documentation for the 2.0 release has had all the man pages
+ converted to YODL source format. Because of this the man pages
+ are now available in both traditional man page format (in
+ the doc/manpages directory) and in HTML format (in the
+ docs/htmldocs directory).
+
+ The text documentation files have been moved into a
+ docs/textdocs directory and are in the (slow) process
+ of being converted to YODL source format to allow them
+ to be easily converted to HTML/SGML.
+
+ Note in particular two files - docs/textdocs/<your OS>_INSTALL.txt
+ and docs/textdocs/DIAGNOSIS.txt.
+
+ There is the potential for there to be many *INSTALL.txt files, one
+ for each OS that Samba supports. However we are moving all this into
+ the new structure. For now, most people will be using UNIX_INSTALL.txt.
+
+ Please pay close attention to all the files with a .txt extension
+ in the docs/textdocs directory. Most problems can be solved by reference
+ to the two files mentioned.