initial add

diff --git a/contrib/doc/README b/contrib/doc/README
new file mode 100644 (file)
index 0000000..a567ccb
--- /dev/null
+++ b/contrib/doc/README
@@ -0,0 +1,7 @@
+$Id$
+
+The purpose of this directory is to hold contributed documentation
+about authoring and publishing DocBook documents.
+
+Plan for now is just to add a separate subdirectory for each doc
+author or doc project that contributes anything.

diff --git a/contrib/doc/michael.smith/refentry.notes.txt b/contrib/doc/michael.smith/refentry.notes.txt
new file mode 100644 (file)
index 0000000..a05355a
--- /dev/null
+++ b/contrib/doc/michael.smith/refentry.notes.txt
@@ -0,0 +1,48 @@
+$Id$
+
+This is simply a list of standard and commonly used section
+heading names for "top level" (.SH) sections in man pages (which
+correspond to Refsect1 element in DocBook.
+
+* all of the section heading names in this first set are verbatim
+* from the man(7) man page, with the exception of added "plurals";
+* e.g., "AUTHORS"
+
+  DESCRIPTION
+  RETURN VALUE
+  RETURN VALUES
+  EXIT STATUS
+  OPTIONS
+  USAGE
+  EXAMPLE
+  EXAMPLES
+  FILES
+  ENVIRONMENT
+  DIAGNOSTICS
+  SECURITY
+  CONFORMING TO
+  NOTES
+  BUGS
+  AUTHOR
+  AUTHORS
+  SEE ALSO
+
+* all of the following in this next set are from the groff_mdoc(7)
+* man page
+
+  LIBRARY
+  IMPLEMENTATION NOTES
+  COMPATIBILITY
+  ERRORS
+  STANDARDS
+  HISTORY
+
+* Though none of the following are standard, they all seem to be
+* used fairly commonly.
+
+  REPORTING BUGS
+  ENVIRONMENT VARIABLES
+  COPYRIGHT
+  LICENSE
+  VERSION
+  EXIT STATUS