[Checkins] SVN: zc.queue/trunk/s Read doc files in an OS-agnostic manner.

[Zvezdan Petkovic]

Log message for revision 123830:
  Read doc files in an OS-agnostic manner.
  
  Also:
  
  - Prefer a join of the list to adding the strings of newlines.
  - Separate footnotes from the main text with a line.
  
  

Changed:
  U   zc.queue/trunk/setup.py
  U   zc.queue/trunk/src/zc/queue/queue.txt

-=-
Modified: zc.queue/trunk/setup.py
===================================================================
--- zc.queue/trunk/setup.py	2011-12-17 23:08:52 UTC (rev 123829)
+++ zc.queue/trunk/setup.py	2011-12-17 23:41:52 UTC (rev 123830)
@@ -1,7 +1,13 @@
 from setuptools import setup
 
+
+def read(*rnames):
+    return open(os.path.join(os.path.dirname(__file__), *rnames)).read()
+
+
 tests_require = ["zope.testing"]
 
+
 setup(
     name="zc.queue",
     version="1.2dev",
@@ -20,11 +26,13 @@
     ],
     tests_require=tests_require,
     extras_require=dict(
-        test=tests_require),
-    description=open('README.txt').read(),
-    long_description=(
-        open("CHANGES.txt").read() + "\n\n" +
-        open("src/zc/queue/queue.txt").read()),
+        test=tests_require,
+        ),
+    description=read('README.txt'),
+    long_description='\n\n'.join([
+        read('src', 'zc', 'queue', 'queue.txt'),
+        read('CHANGES.txt'),
+        ]),
     keywords="zope zope3",
     zip_safe=False
     )

Modified: zc.queue/trunk/src/zc/queue/queue.txt
===================================================================
--- zc.queue/trunk/src/zc/queue/queue.txt	2011-12-17 23:08:52 UTC (rev 123829)
+++ zc.queue/trunk/src/zc/queue/queue.txt	2011-12-17 23:41:52 UTC (rev 123830)
@@ -393,6 +393,9 @@
 
     >>> db.close() # cleanup
 
+
+-----
+
 .. [#why] The queue's `pull` method is actually the interesting part in why
     this constraint is used, and it becomes more so when you allow an
     arbitrary pull.  By asserting that you do not support having equal