openlp-core team mailing list archive

[Jon Tibble <meths@xxxxxxxxxxxxxx>]

Jon Tibble has proposed merging lp:~meths/openlp/docs into lp:openlp.

Requested reviews:
  OpenLP Core (openlp-core)


Docstrings
-- 
https://code.launchpad.net/~meths/openlp/docs/+merge/28763
Your team OpenLP Core is requested to review the proposed merge of lp:~meths/openlp/docs into lp:openlp.

=== modified file 'openlp/core/lib/renderer.py'
--- openlp/core/lib/renderer.py	2010-06-10 13:17:39 +0000
+++ openlp/core/lib/renderer.py	2010-06-29 15:42:30 +0000
@@ -22,7 +22,10 @@
 # with this program; if not, write to the Free Software Foundation, Inc., 59  #
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
-
+"""
+The :mod:`renderer` module enables OpenLP to take the input from plugins and
+format it for the output display.
+"""
 import logging
 
 from PyQt4 import QtGui, QtCore

=== modified file 'openlp/plugins/alerts/__init__.py'
--- openlp/plugins/alerts/__init__.py	2010-06-10 21:30:50 +0000
+++ openlp/plugins/alerts/__init__.py	2010-06-29 15:42:30 +0000
@@ -24,5 +24,5 @@
 ###############################################################################
 """
 The :mod:`alerts` module provides the Alerts plugin for producing impromptu
-on-screen announcements during a service
+on-screen announcements during a service.
 """

=== modified file 'openlp/plugins/bibles/__init__.py'
--- openlp/plugins/bibles/__init__.py	2010-06-10 21:30:50 +0000
+++ openlp/plugins/bibles/__init__.py	2010-06-29 15:42:30 +0000
@@ -23,6 +23,6 @@
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
 """
-The :mod:`bibles' modules provides the Bible plugin to enable OpenLP to display
-scripture
+The :mod:`bibles' module provides the Bible plugin to enable OpenLP to display
+scripture.
 """

=== modified file 'openlp/plugins/custom/__init__.py'
--- openlp/plugins/custom/__init__.py	2010-03-21 23:58:01 +0000
+++ openlp/plugins/custom/__init__.py	2010-06-29 15:42:30 +0000
@@ -22,3 +22,8 @@
 # with this program; if not, write to the Free Software Foundation, Inc., 59  #
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
+"""
+The :mod:`custom` module provides the Custom plugin which allows custom,
+themed, text based items to be displayed without having to misuse another item
+type.
+"""

=== modified file 'openlp/plugins/images/__init__.py'
--- openlp/plugins/images/__init__.py	2010-03-21 23:58:01 +0000
+++ openlp/plugins/images/__init__.py	2010-06-29 15:42:30 +0000
@@ -22,3 +22,7 @@
 # with this program; if not, write to the Free Software Foundation, Inc., 59  #
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
+"""
+The :mod:`images` module provides the Images plugin.  The Images plugin
+provides the facility to display images from OpenLP.
+"""

=== modified file 'openlp/plugins/media/__init__.py'
--- openlp/plugins/media/__init__.py	2010-03-21 23:58:01 +0000
+++ openlp/plugins/media/__init__.py	2010-06-29 15:42:30 +0000
@@ -22,3 +22,9 @@
 # with this program; if not, write to the Free Software Foundation, Inc., 59  #
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
+"""
+The :mod:`media` module provides the Media plugin which allows OpenLP to
+display videos.  The media supported depends not only on the Python support
+but also extensively on the codecs installed on the underlying operating system
+being picked up and usable by Python.
+"""

=== modified file 'openlp/plugins/presentations/__init__.py'
--- openlp/plugins/presentations/__init__.py	2010-03-21 23:58:01 +0000
+++ openlp/plugins/presentations/__init__.py	2010-06-29 15:42:30 +0000
@@ -22,3 +22,7 @@
 # with this program; if not, write to the Free Software Foundation, Inc., 59  #
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
+"""
+The :mod:`presentations` module provides the Presentations plugin which allows
+OpenLP to show presentations from most popular presentation packages.
+"""

=== modified file 'openlp/plugins/remotes/__init__.py'
--- openlp/plugins/remotes/__init__.py	2010-03-21 23:58:01 +0000
+++ openlp/plugins/remotes/__init__.py	2010-06-29 15:42:30 +0000
@@ -22,3 +22,7 @@
 # with this program; if not, write to the Free Software Foundation, Inc., 59  #
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
+"""
+The :mod:`remotes` plugin allows OpenLP to be controlled from another machine
+over a network connection.
+"""

=== modified file 'openlp/plugins/songs/__init__.py'
--- openlp/plugins/songs/__init__.py	2010-03-21 23:58:01 +0000
+++ openlp/plugins/songs/__init__.py	2010-06-29 15:42:30 +0000
@@ -22,3 +22,7 @@
 # with this program; if not, write to the Free Software Foundation, Inc., 59  #
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
+"""
+The :mod:`songs` module provides the Songs plugin.  The Songs plugin provides
+the main lyric projection function of OpenLP.
+"""

=== modified file 'openlp/plugins/songusage/__init__.py'
--- openlp/plugins/songusage/__init__.py	2010-03-21 23:58:01 +0000
+++ openlp/plugins/songusage/__init__.py	2010-06-29 15:42:30 +0000
@@ -22,3 +22,8 @@
 # with this program; if not, write to the Free Software Foundation, Inc., 59  #
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
+"""
+The :mod:`songusage` module contains the Song Usage plugin.  The Song Usage
+plugin provides auditing capabilities for reporting the songs you are using to
+copyright license organisations.
+"""

=== modified file 'openlp/plugins/songusage/forms/songusagedetailform.py'
--- openlp/plugins/songusage/forms/songusagedetailform.py	2010-06-22 14:34:03 +0000
+++ openlp/plugins/songusage/forms/songusagedetailform.py	2010-06-29 15:42:30 +0000
@@ -42,7 +42,7 @@
 
     def __init__(self, parent=None):
         """
-        Constructor
+        Initialise the form
         """
         QtGui.QDialog.__init__(self, None)
         self.parent = parent

=== modified file 'openlp/plugins/songusage/lib/manager.py'
--- openlp/plugins/songusage/lib/manager.py	2010-06-22 14:34:03 +0000
+++ openlp/plugins/songusage/lib/manager.py	2010-06-29 15:42:30 +0000
@@ -22,7 +22,9 @@
 # with this program; if not, write to the Free Software Foundation, Inc., 59  #
 # Temple Place, Suite 330, Boston, MA 02111-1307 USA                          #
 ###############################################################################
-
+"""
+The :mod:`manager` module provides song usage specific database query code
+"""
 import logging
 
 from sqlalchemy.exceptions import InvalidRequestError