From: W. Trevor King <wking@drexel.edu>
Date: Sat, 23 Jan 2010 16:40:11 +0000 (-0500)
Subject: Reorganized documentation to clean doc/ for user-readable files
X-Git-Tag: 1.0.0~59^2~43^2~9
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=04cd30589f138704e9cf88ee37f6549733cbe7e1;p=be.git

Reorganized documentation to clean doc/ for user-readable files
---

diff --git a/Makefile b/Makefile
index 0388933..ad78ccb 100644
--- a/Makefile
+++ b/Makefile
@@ -27,7 +27,7 @@ SHELL = /bin/bash
 PATH = /usr/bin:/bin
 
 # Directories with semantic meaning
-DOC_DIR := doc
+DOC_DIR := doc/src
 
 # Variables that will be extended by module include files
 GENERATED_FILES := libbe/_version.py build
diff --git a/README b/README
index 031ae13..428ca86 100644
--- a/README
+++ b/README
@@ -21,3 +21,10 @@ To create bugs, use "be new $DESCRIPTION".  To comment on bugs, you
 can can use "be comment $BUG_ID".  To close a bug, use "be close
 $BUG_ID" or "be status $BUG_ID fixed".  For more commands, see "be
 help".  You can also look at the usage examples in test_usage.sh.
+
+Documentation
+=============
+
+If "be help" isn't scratching your itch, there's also
+  * doc/tutorial        (a gentle introduction to BE)
+  * doc/README.dev      (a guide to hacking BE)
diff --git a/doc/SPAM b/doc/spam
similarity index 100%
rename from doc/SPAM
rename to doc/spam
diff --git a/doc/be.1.sgml b/doc/src/be.1.sgml
similarity index 100%
rename from doc/be.1.sgml
rename to doc/src/be.1.sgml
diff --git a/doc/module.mk b/doc/src/module.mk
similarity index 98%
rename from doc/module.mk
rename to doc/src/module.mk
index 960f7c0..ea4eacc 100644
--- a/doc/module.mk
+++ b/doc/src/module.mk
@@ -23,7 +23,7 @@
 
 # Makefile module for documentation
 
-MODULE_DIR := doc
+MODULE_DIR := doc/src
 
 MANPAGES = be.1
 manpage_files = $(patsubst %,${MODULE_DIR}/%,${MANPAGES})
diff --git a/doc/tutorial b/doc/tutorial
new file mode 100644
index 0000000..1333ed7
--- /dev/null
+++ b/doc/tutorial
@@ -0,0 +1 @@
+TODO
diff --git a/setup.py b/setup.py
index 9c3c080..2bb724c 100755
--- a/setup.py
+++ b/setup.py
@@ -21,6 +21,6 @@ setup(
               'libbe.util'],
     scripts=['be'],
     data_files=[
-        ('share/man/man1', ['doc/be.1']),
+        ('share/man/man1', ['doc/src/be.1']),
         ]
     )