Make lines shorter (for mobile-friendliness)

Author: GaelVaroquaux

advanced/advanced_numpy/index.rst

@@ -331,8 +331,8 @@ Casting
 
 .. note::
 
-   Exact rules: see documentation:
-   http://docs.scipy.org/doc/numpy/reference/ufuncs.html#casting-rules
+   Exact rules: see `numpy documentation
+   <http://docs.scipy.org/doc/numpy/reference/ufuncs.html#casting-rules>`_
 
 
 Re-interpretation / viewing

advanced/image_processing/index.rst

@@ -38,7 +38,8 @@ arrays.
 * ``numpy``: basic array manipulation
 
 * ``scipy``: ``scipy.ndimage`` submodule dedicated to image processing
-  (n-dimensional images). See http://docs.scipy.org/doc/scipy/reference/tutorial/ndimage.html ::
+  (n-dimensional images). See the `documentation
+  <http://docs.scipy.org/doc/scipy/reference/tutorial/ndimage.html>`_::
 
     >>> from scipy import ndimage
 
@@ -425,7 +426,8 @@ Other local non-linear filters: Wiener (``scipy.signal.wiener``), etc.
 Mathematical morphology
 -----------------------
 
-See https://en.wikipedia.org/wiki/Mathematical_morphology
+See `wikipedia <https://en.wikipedia.org/wiki/Mathematical_morphology>`_
+for a definition of mathematical morphology.
 
 Probe an image with a simple shape (a **structuring element**), and
 modify this image according to how the shape locally fits or misses the
@@ -851,8 +853,8 @@ Non-regularly-spaced blocks: radial mean::
 
 Correlation function, Fourier/wavelet spectrum, etc.
 
-One example with mathematical morphology: **granulometry**
-(https://en.wikipedia.org/wiki/Granulometry_%28morphology%29)
+One example with mathematical morphology: `granulometry
+<https://en.wikipedia.org/wiki/Granulometry_%28morphology%29>`_
 
 ::
 

packages/scikit-image/index.rst

@@ -333,7 +333,8 @@ Enhances contrast in large almost uniform regions.
 Mathematical morphology
 -----------------------
 
-See https://en.wikipedia.org/wiki/Mathematical_morphology
+See `wikipedia <https://en.wikipedia.org/wiki/Mathematical_morphology>`_
+for an introduction on mathematical morphology.
 
 Probe an image with a simple shape (a **structuring element**), and
 modify this image according to how the shape locally fits or misses the
@@ -723,9 +724,11 @@ Example: detecting corners using Harris detector ::
     :target: auto_examples/plot_features.html
     :align: center
 
-(this example is taken from
-http://scikit-image.org/docs/stable/auto_examples/plot_corner.html)
+(this example is taken from the `plot_corner
+<http://scikit-image.org/docs/stable/auto_examples/plot_corner.html>`_
+example in scikit-image)
 
 Points of interest such as corners can then be used to match objects in
-different images, as described in
-http://scikit-image.org/docs/stable/auto_examples/plot_matching.html
+different images, as described in the `plot_matching 
+<http://scikit-image.org/docs/stable/auto_examples/plot_matching.html>`_
+example of scikit-image.

packages/traits/index.rst

@@ -24,14 +24,13 @@ The Traits project allows you to simply add validation, initialization, delegati
 
 .. topic:: Requirements
 
-    * Python 2.6 or 2.7 (www.python.org)
-    * Either wxPython (http://www.wxpython.org/), 
-      PyQt (https://riverbankcomputing.com/software/pyqt/intro) or
-      PySide (https://pyside.github.io/docs/pyside/)
-    * Numpy and Scipy (http://www.scipy.org)
-    * Enthought Tool Suite 3.x or higher (http://code.enthought.com/projects)
-    * All required software can be obtained by installing the EPD Free
-      (https://store.enthought.com/)
+    * Either `wxPython <http://www.wxpython.org>`_, 
+      `PyQt <https://riverbankcomputing.com/software/pyqt/intro>`_ or
+      `PySide <https://pyside.github.io/docs/pyside/>`_
+    * Numpy and Scipy
+    * `Enthought Tool Suite <http://code.enthought.com/projects>`_
+    * All required software can be obtained by installing the `EPD Free
+      <https://store.enthought.com/>`_
 
 
 .. contents:: Tutorial content
@@ -216,10 +215,10 @@ Every trait does validation when the user tries to set its content:
     reservoir.max_storage = '230'
     ---------------------------------------------------------------------------
     TraitError                                Traceback (most recent call last)
-    /Users/dpinte/projects/scipy-lecture-notes/advanced/traits/<ipython-input-7-979bdff9974a> in <module>()
+    .../scipy-lecture-notes/advanced/traits/<ipython-input-7-979bdff9974a> in <module>()
     ----> 1 reservoir.max_storage = '230'
 
-    /Users/dpinte/projects/ets/traits/traits/trait_handlers.pyc in error(self, object, name, value)
+    .../traits/trait_handlers.pyc in error(self, object, name, value)
         166         """
         167         raise TraitError( object, name, self.full_info( object, name, value ),
     --> 168                           value )
@@ -429,8 +428,7 @@ TraitsUI Item, the ChacoPlotItem:
 
 .. seealso:: References
 
-    * ETS repositories: https://github.com/enthought
-    * Traits manual: http://docs.enthought.com/traits/traits_user_manual/index.html
-    * Traits UI manual: http://docs.enthought.com/traitsui/traitsui_user_manual/index.html 
-
+    * `ETS repositories <https://github.com/enthought>`_
+    * `Traits manual <http://docs.enthought.com/traits/traits_user_manual/index.html>`_
+    * `Traits UI manual <http://docs.enthought.com/traitsui/traitsui_user_manual/index.html>`_
     * Mailing list : enthought-dev@enthought.com

packages/traits/reservoir_evolution.py

@@ -21,7 +21,7 @@ class ReservoirEvolution(HasTraits):
 
     month = Property(depends_on='stock')
 
-    ### Traits view ##########################################################
+    ### Traits view ###########
     traits_view = View(
         Item('name'),
         Group(
@@ -31,7 +31,7 @@ class ReservoirEvolution(HasTraits):
         resizable = True
     )
 
-    ### Traits properties ####################################################
+    ### Traits properties #####
     def _get_stock(self):
         """
         fixme: should handle cases where we go over the max storage

packages/traits/reservoir_state_property.py

@@ -24,10 +24,10 @@ class ReservoirState(HasTraits):
             desc='Spillage [hm3]', depends_on=['storage', 'inflows', 'release']
         )
 
-    ### Private traits. ######################################################
+    ### Private traits.
     _storage = Float
 
-    ### Traits property implementation. ######################################
+    ### Traits property implementation.
     def _get_storage(self):
         new_storage = self._storage - self.release + self.inflows
         return min(new_storage, self.max_storage)

packages/traits/reservoir_state_property_ontraitchange.py

@@ -25,10 +25,10 @@ class ReservoirState(HasTraits):
         )
 
 
-    ### Private traits. ######################################################
+    ### Private traits. ##########
     _storage = Float
 
-    ### Traits property implementation. ######################################
+    ### Traits property implementation.
     def _get_storage(self):
         new_storage = self._storage - self.release + self.inflows
         return min(new_storage, self.max_storage)

packages/traits/reservoir_state_property_view.py

@@ -25,7 +25,7 @@ class ReservoirState(HasTraits):
             desc='Spillage [hm3]', depends_on=['storage', 'inflows', 'release']
         )
 
-    ### Traits view ##########################################################
+    ### Traits view
     traits_view = View(
         Group(
             VGroup(Item('name'), Item('storage'), Item('spillage'),
@@ -35,10 +35,10 @@ class ReservoirState(HasTraits):
         )
     )
 
-    ### Private traits. ######################################################
+    ### Private traits.
     _storage = Float
 
-    ### Traits property implementation. ######################################
+    ### Traits property implementation.
     def _get_storage(self):
         new_storage = self._storage - self.release + self.inflows
         return min(new_storage, self.max_storage)

packages/traits/reservoir_state_static_listener.py

@@ -26,7 +26,7 @@ def print_state(self):
                 self.spillage)
         print '-' * 79
 
-    ### Traits listeners #####################################################
+    ### Traits listeners ###########
     def _release_changed(self, new):
         """When the release is higher than zero, warn all the inhabitants of
         the valley.