From 6924114ec2186d516a1cdef9c926a3b6b36abf8d Mon Sep 17 00:00:00 2001
From: kay <kay.kim@10gen.com>
Date: Fri, 14 Sep 2012 12:13:48 -0400
Subject: [PATCH 1/2] DOCS-331 Add examples to setParameter command doc

---
 source/reference/command/setParameter.txt | 127 ++++++++++++++++------
 1 file changed, 93 insertions(+), 34 deletions(-)

diff --git a/source/reference/command/setParameter.txt b/source/reference/command/setParameter.txt
index eca3597889b..c5ba26bf0d2 100644
--- a/source/reference/command/setParameter.txt
+++ b/source/reference/command/setParameter.txt
@@ -18,39 +18,98 @@ setParameter
    Replace the ``<option>`` with one of the following options
    supported by this command:
 
-   :option integer journalCommitInterval: Specify an integer between 1
-                                          and 500 specifying the
-                                          number of milliseconds (ms)
-                                          between journal commits.
-
-   :option integer logLevel: Specify an integer between ``0`` and
-                             ``5`` signifying the verbosity of the
-                             logging, where larger is more verbose.
-
-   :option boolean notablescan: If ``true``, queries that do not
-                                using an index will fail.
-
-   :option boolean traceExceptions: If ``true``, :program:`mongod` will
-                                    log full stack traces on assertions
-                                    or errors. This parameter is only
-                                    available in version 2.1 and later.
-
-   :option boolean quiet: Enables a quiet logging mode when
-                          ``true``. Use ``false`` to disable. Quiet
-                          logging removes the following messages from
-                          the log: connection events; the
-                          :dbcommand:`drop`, :dbcommand:`dropIndexes`,
-                          :dbcommand:`diagLogging`,
-                          :dbcommand:`validate`, and
-                          :dbcommand:`clean`; and replication
-                          synchronization activity.
-
-   :option integer syncdelay: Specify the interval, in seconds,
-                              between :term:`fsyncs <fsync>` (i.e.,
-                              flushes of memory to disk). By default,
-                              :program:`mongod` will flush memory to
-                              disk every 60 seconds. Do not change
-                              this value unless you see a background
-                              flush average greater than 60 seconds.
+   :option integer journalCommitInterval: 
+   
+           Specify an integer between ``1`` and ``500`` signifying the number
+           of milliseconds (ms) between journal commits.
+
+           Consider the following example which sets the
+           :option:`journalCommitInterval` to ``200`` ms:
+                                       
+           .. code-block:: javascript
+   
+              use admin
+              db.runCommand( { setParameter: 1, journalCommitInterval: 200 } )
+                              
+   :option integer logLevel: 
+   
+           Specify an integer between ``0`` and ``5`` signifying the
+           verbosity of the logging, where ``5`` is the most verbose.
+
+           Consider the following example which sets the
+           :option:`logLevel` to ``2``:
+                                       
+           .. code-block:: javascript
+   
+              use admin
+              db.runCommand( { setParameter: 1, logLevel: 2 } )
+                                
+   :option boolean notablescan: 
+   
+           Specify whether queries must use indexes. If ``true``,
+           queries that perform a table scan instead of using an index
+           will fail.
+
+           Consider the following example which sets the
+           :option:`notablescan` to true:
+                                       
+           .. code-block:: javascript
+   
+              use admin
+              db.runCommand( { setParameter: 1, notablescan: true } )
+
+   :option boolean traceExceptions: 
+   
+           .. versionadded:: 2.1
+           
+           Specify whether to log full stack traces on assertions or
+           errors. If ``true``, :program:`mongod` will log full stack
+           traces on assertions or errors.
+
+           Consider the following example which sets the
+           :option:`traceExceptions` to true:
+                                       
+           .. code-block:: javascript
+   
+              use admin
+              db.runCommand( { setParameter: 1, traceExceptions: true } )
+
+   :option boolean quiet: 
+   
+           Specify whether to go into a quiet logging mode. If
+           ``true``, :program:`mongod` will go into a quiet logging
+           mode which will not log the following events/activities: 
+           
+              - connection events;
+              - the :dbcommand:`drop` command, the
+                :dbcommand:`dropIndexes` command, the
+                :dbcommand:`diagLogging` command, the
+                :dbcommand:`validate` command, and the
+                :dbcommand:`clean` command; and
+              - replication synchronization activities.
+
+           Consider the following example which sets the
+           :option:`quiet` to true:
+
+           .. code-block:: javascript
+   
+              use admin
+              db.runCommand( { setParameter: 1, quiet: true } )
+
+   :option integer syncdelay: 
+   
+           Specify the interval, in seconds, between :term:`fsyncs
+           <fsync>` (i.e., flushes of memory to disk). By default,
+           :program:`mongod` will flush memory to disk every 60
+           seconds. Do not change this value unless you see a
+           background flush average greater than 60 seconds.
+
+           Consider the following example which sets the
+           :option:`syncdelay` to 60:
+
+           .. code-block:: javascript
+   
+              use admin
+              db.runCommand( { setParameter: 1, syncdelay: 60 } )
 
    .. slave-ok, admin-only

From 310bc7155cf5c3bf01596de7ec910d2bd4bc3be8 Mon Sep 17 00:00:00 2001
From: kay <kay.kim@10gen.com>
Date: Fri, 14 Sep 2012 15:30:00 -0400
Subject: [PATCH 2/2] DOCS-331 add setParameter examples

---
 source/reference/command/setParameter.txt | 88 +++++++++++++++--------
 1 file changed, 58 insertions(+), 30 deletions(-)

diff --git a/source/reference/command/setParameter.txt b/source/reference/command/setParameter.txt
index c5ba26bf0d2..e068a74b252 100644
--- a/source/reference/command/setParameter.txt
+++ b/source/reference/command/setParameter.txt
@@ -18,98 +18,126 @@ setParameter
    Replace the ``<option>`` with one of the following options
    supported by this command:
 
-   :option integer journalCommitInterval: 
-   
+   :option integer journalCommitInterval:
+           
            Specify an integer between ``1`` and ``500`` signifying the number
            of milliseconds (ms) between journal commits.
 
            Consider the following example which sets the
-           :option:`journalCommitInterval` to ``200`` ms:
-                                       
+           ``journalCommitInterval`` to ``200`` ms:
+
            .. code-block:: javascript
-   
+
               use admin
               db.runCommand( { setParameter: 1, journalCommitInterval: 200 } )
-                              
-   :option integer logLevel: 
-   
+
+           .. seealso::
+
+              :setting:`journalCommitInterval`.
+
+   :option integer logLevel:
+
            Specify an integer between ``0`` and ``5`` signifying the
            verbosity of the logging, where ``5`` is the most verbose.
 
            Consider the following example which sets the
-           :option:`logLevel` to ``2``:
-                                       
+           ``logLevel`` to ``2``:
+
            .. code-block:: javascript
-   
+
               use admin
               db.runCommand( { setParameter: 1, logLevel: 2 } )
-                                
+
+           .. seealso::
+
+              :setting:`verbose`.
+
    :option boolean notablescan: 
-   
+
            Specify whether queries must use indexes. If ``true``,
            queries that perform a table scan instead of using an index
            will fail.
 
            Consider the following example which sets the
-           :option:`notablescan` to true:
-                                       
+           ``notablescan`` to true:
+
            .. code-block:: javascript
-   
+
               use admin
               db.runCommand( { setParameter: 1, notablescan: true } )
 
+           .. seealso::
+
+              :setting:`notablescan`.
+
+
    :option boolean traceExceptions: 
-   
+
            .. versionadded:: 2.1
-           
+
            Specify whether to log full stack traces on assertions or
            errors. If ``true``, :program:`mongod` will log full stack
            traces on assertions or errors.
 
            Consider the following example which sets the
-           :option:`traceExceptions` to true:
-                                       
+           ``traceExceptions`` to true:
+
            .. code-block:: javascript
-   
+
               use admin
               db.runCommand( { setParameter: 1, traceExceptions: true } )
 
-   :option boolean quiet: 
-   
+           .. seealso::
+
+              :setting:`traceExceptions`.
+
+   :option boolean quiet:
+
            Specify whether to go into a quiet logging mode. If
            ``true``, :program:`mongod` will go into a quiet logging
            mode which will not log the following events/activities: 
-           
+
               - connection events;
+
               - the :dbcommand:`drop` command, the
                 :dbcommand:`dropIndexes` command, the
                 :dbcommand:`diagLogging` command, the
                 :dbcommand:`validate` command, and the
                 :dbcommand:`clean` command; and
+
               - replication synchronization activities.
 
            Consider the following example which sets the
-           :option:`quiet` to true:
+           ``quiet`` to true:
 
            .. code-block:: javascript
-   
+
               use admin
               db.runCommand( { setParameter: 1, quiet: true } )
 
+           .. seealso::
+
+              :setting:`quiet`.
+
    :option integer syncdelay: 
-   
-           Specify the interval, in seconds, between :term:`fsyncs
+
+           Specify the interval in seconds between :term:`fsyncs
            <fsync>` (i.e., flushes of memory to disk). By default,
            :program:`mongod` will flush memory to disk every 60
            seconds. Do not change this value unless you see a
            background flush average greater than 60 seconds.
 
            Consider the following example which sets the
-           :option:`syncdelay` to 60:
+           ``syncdelay`` to ``60`` seconds:
 
            .. code-block:: javascript
-   
+
               use admin
               db.runCommand( { setParameter: 1, syncdelay: 60 } )
 
+           .. seealso::
+
+              :setting:`syncdelay`.
+
+
    .. slave-ok, admin-only