Formatting cleanups to prep for first pre-release

Formatting changes for release document
- Change watermark to show date of document
- Remove "Documentation" from title
- use lowercase instead of CamelCase for filename

Signed-off-by: Grant Likely <[email protected]>

Author: glikely

source/conf.py

@@ -14,6 +14,7 @@
 
 import sys
 import os
+import time
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
@@ -57,9 +58,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'0.1'
+version = u'0.1-pre1'
 # The full version, including alpha/beta/rc tags.
-release = u'0.1'
+release = u'0.1-pre1-%s' % time.strftime('%Y%m%d')
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -72,7 +73,7 @@
 # non-false value, then it is used:
 #today = ''
 # Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
+today_fmt = '%d %B %Y'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -228,7 +229,7 @@
 #'pointsize': '10pt',
 
 # Additional stuff for the LaTeX preamble.
-  'preamble': '\\usepackage{draftwatermark}\\SetWatermarkText{DRAFT v%s}'%release,
+  'preamble': '\\usepackage{draftwatermark}\\SetWatermarkScale{.45}\\SetWatermarkText{DRAFT v%s}' % release
 
 # Latex figure (float) alignment
 #'figure_align': 'htbp',
@@ -238,7 +239,7 @@
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    (master_doc, 'DevicetreeSpecification.tex', u'Devicetree Specification Documentation',
+    (master_doc, 'devicetree-specification.tex', u'Devicetree Specification',
      u'devicetree.org', 'manual'),
 ]
 
@@ -268,7 +269,7 @@
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    (master_doc, 'devicetreespecification', u'Devicetree Specification Documentation',
+    (master_doc, 'devicetree-specification', u'Devicetree Specification',
      [author], 1)
 ]
 
@@ -282,8 +283,8 @@
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-    (master_doc, 'DevicetreeSpecification', u'Devicetree Specification Documentation',
-     author, 'DevicetreeSpecification', 'One line description of project.',
+    (master_doc, 'devicetree-specification', u'Devicetree Specification',
+     author, 'DevicetreeSpecification', 'Devicetree hardware description language specification.',
      'Miscellaneous'),
 ]