From: Michael Smith <xmldoc@users.sourceforge.net>
Date: Mon, 4 Jul 2005 12:16:43 +0000 (+0000)
Subject: initial add
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=45963b43ec33346371dd5d4be3e3f4160a430922;p=docbook-dsssl

initial add
---

diff --git a/contrib/doc/README b/contrib/doc/README
new file mode 100644
index 000000000..a567ccb99
--- /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
index 000000000..a05355a15
--- /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