summaryrefslogtreecommitdiffstatshomepage
path: root/manuals.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-03-22 08:52:27 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-03-22 08:52:27 +0000
commitada70fb8e9b388b782565c73a5b8ccc20a22d190 (patch)
treef1cb520bc3aea81d9f6588241aa432b9fa9f55fe /manuals.7
parentcef427b7b44922753d803c4b2af56b03e0abdcc0 (diff)
downloadmandoc-ada70fb8e9b388b782565c73a5b8ccc20a22d190.tar.gz
mandoc-ada70fb8e9b388b782565c73a5b8ccc20a22d190.tar.zst
mandoc-ada70fb8e9b388b782565c73a5b8ccc20a22d190.zip
More documentation clarification.
Diffstat (limited to 'manuals.7')
-rw-r--r--manuals.739
1 files changed, 39 insertions, 0 deletions
diff --git a/manuals.7 b/manuals.7
new file mode 100644
index 00000000..049c9380
--- /dev/null
+++ b/manuals.7
@@ -0,0 +1,39 @@
+.Dd $Mdocdate: March 22 2009 $
+.Dt "Writing Unix Documentation" paper
+.Os
+.Sh NAME
+.Nm Writing Unix Documentation
+.Nd a guide to writing Unix manuals
+.Sh DESCRIPTION
+ <h1>
+ Writing Unix Documentation
+ </h1>
+
+ <p>
+ <span class="attn">A utility without documentation is of no utility at all.</span>
+ </p>
+
+ <p>
+ A system component's documentation describes the utility of that component, whether it's a device
+ driver, an executable or, most importantly, a game. Although there are plenty of documents available on
+ how to <i>read</i> Unix documents, or where to find them, few focus on how to <i>write</i> them.
+ </p>
+
+ <p>
+ This document serves as a reference guide to writing Unix documentation. If you add something to your
+ operating system, whether it's a new file format or directory structure or device driver, it needs
+ documentation.
+ </p>
+ </td>
+ </tr>
+ <tr>
+ <td>
+ <div class="foot">
+ Copyright &#169; 2009 Kristaps D&#382;onsons, $Date: 2009/03/22 08:52:27 $
+ </div>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </body>
+</html>