Minor doc fixes.

Former-commit-id: 7f89933e1a12c4ece9454f349de6a3211e806579 [formerly e2578eb]
Former-commit-id: 74e15e1b8b43c844aed9984448af574d2fe0f052

Author: shyuep

pymatgen/analysis/bond_valence.py

@@ -142,19 +142,6 @@ class BVAnalyzer(object):
     3) The oxidation states are then ranked in order of decreasing probability
     and the oxidation state combination that result in a charge neutral cell
     is selected.
-
-    Args:
-        symm_tol (float): Symmetry tolerance used to determine which sites are
-            symmetrically equivalent. Set to 0 to turn off symmetry.
-        max_radius (float): Maximum radius in Angstrom used to find nearest
-            neighbors.
-        max_permutations (int): The maximum number of permutations of
-            oxidation states to test.
-        distance_scale_factor:
-            A scale factor to be applied. This is useful for scaling
-            distances, esp in the case of calculation-relaxed structures
-            which may tend to under (GGA) or over bind (LDA). The default
-            of 1.015 works for GGA. For experimental structure, set this to 1.
     """
 
     CHARGE_NEUTRALITY_TOLERANCE = 0.00001
@@ -164,6 +151,8 @@ def __init__(self, symm_tol=0.1, max_radius=4, max_permutations=100000,
                  charge_neutrality_tolerance=CHARGE_NEUTRALITY_TOLERANCE,
                  forbidden_species=None):
         """
+        Initializes the BV analyzer, with useful defaults.
+
         Args:
             symm_tol:
                 Symmetry tolerance used to determine which sites are

pymatgen/phasediagram/plotter.py

@@ -51,12 +51,12 @@ def pd_plot_data(self):
 
         Returns:
             (lines, stable_entries, unstable_entries):
-                - lines is a list of list of coordinates for lines in the PD.
-                - stable_entries is a {coordinate : entry} for each stable node
-                  in the phase diagram. (Each coordinate can only have one
-                  stable phase)
-                - unstable_entries is a {entry: coordinates} for all unstable
-                  nodes in the phase diagram.
+            - lines is a list of list of coordinates for lines in the PD.
+            - stable_entries is a {coordinate : entry} for each stable node
+              in the phase diagram. (Each coordinate can only have one
+              stable phase)
+            - unstable_entries is a {entry: coordinates} for all unstable
+              nodes in the phase diagram.
         """
         pd = self._pd
         entries = pd.qhull_entries
@@ -576,12 +576,12 @@ def order_phase_diagram(lines, stable_entries, unstable_entries, ordering):
 
     Returns:
         (newlines, newstable_entries, newunstable_entries):
-            - newlines is a list of list of coordinates for lines in the PD.
-            - newstable_entries is a {coordinate : entry} for each stable node
-              in the phase diagram. (Each coordinate can only have one
-              stable phase)
-            - newunstable_entries is a {entry: coordinates} for all unstable
-              nodes in the phase diagram.
+        - newlines is a list of list of coordinates for lines in the PD.
+        - newstable_entries is a {coordinate : entry} for each stable node
+        in the phase diagram. (Each coordinate can only have one
+        stable phase)
+        - newunstable_entries is a {entry: coordinates} for all unstable
+        nodes in the phase diagram.
     """
     yup = -1000.0
     xleft = 1000.0