Index: ADME.md
===================================================================
--- README.md	(revision 241b6178782e52c76291ae3fa61f45536027e19e)
+++ 	(revision )
@@ -1,75 +1,0 @@
-Sasmodels
-=========
-
-Theory models for small angle scattering.
-
-The models provided are usable directly in the bumps fitting package and
-in the sasview analysis package.  If OpenCL is available, the models will
-run much faster.  If not, then precompiled versions will be included with
-the distributed package.  New models can be added if OpenCL or a C compiler
-is available.
-
-Example
--------
-
-The example directory contains a radial+tangential data set for an oriented
-rod-like shape.
-
-The data is loaded by sas.dataloader from the sasview package, so sasview
-is needed to run the example.
-
-To run the example, you need sasview, sasmodels and bumps.  Assuming these
-repositories are installed side by side, change to the sasmodels/example
-directory and enter::
-
-    PYTHONPATH=..:../../sasview/src ../../bumps/run.py fit.py \
-        cylinder --preview
-
-See bumps documentation for instructions on running the fit.  With the
-python packages installed, e.g., into a virtual environment, then the
-python path need not be set, and the command would be::
-
-    bumps fit.py cylinder --preview
-
-The fit.py model accepts up to two arguments.  The first argument is the
-model type, which has been defined for cylinder, capped_cylinder,
-core_shell_cylinder, ellipsoid, triaxial_ellipsoid and lamellar.  The
-second argument is view, which can be radial or tangential.  To fit
-both radial and tangential simultaneously, use the word "both".
-
-Notes
------
-
-cylinder.c + cylinder.py is the cylinder model with renamed variables and
-sld scaled by 1e6 so the numbers are nicer.  The model name is "cylinder"
-
-cylinder_clone.c + cylinder_clone.py is the cylinder model using the
-same interface as the sasview, including calling the model CylinderModel,
-so that it can be used as a drop-in replacement for the sasview cylinder
-model.
-
-lamellar.py is an example of a single file model with embedded C code.
-
-Note: may want to rename form_volume to calc_volume and Iq/Iqxy to
-calc_Iq/calc_Iqxy in model interface. Similarly ER/VR go to calc_ER/calc_VR.
-
-Note: It is possible to translate python code automatically to opencl, using
-something like numba, clyther, shedskin or pypy, so maybe the kernel functions
-could be implemented without any C syntax.
-
-Note: angular dispersion in theta is probably not calculated correctly, but
-is left this way for compatibility with sasview.
-
-Magnetism hasn't been implemented yet.  We may want a separate Imagnetic
-calculator with the extra parameters and calculations.   We should
-return all desired spin states together so we can share the work of
-computing the form factors for the different magnetic contrasts.  This
-will mean extending the data handler to support multiple cross sections
-in the same data set.
-
-Need to implement an example kernel directly in python.  Polydispersity
-loops should be generated automatically as they are for the OpenCL models.
-The kernels should be vectorized across Q.  These will need vectorized
-versions of numerical quadrature if we want to get reasonable performance.
-
-[![Travis-CI Build Status](https://travis-ci.org/SasView/sasmodels.svg?branch=master)](https://travis-ci.org/SasView/sasmodels)
Index: README.rst
===================================================================
--- README.rst	(revision e78d4cac9aa98631ba23685b37431d395d60aaa8)
+++ README.rst	(revision e78d4cac9aa98631ba23685b37431d395d60aaa8)
@@ -0,0 +1,55 @@
+Sasmodels
+=========
+
+Theory models for small angle scattering.
+
+The models provided are usable directly in the bumps fitting package and
+in the sasview analysis package.  If OpenCL is available, the models will
+run much faster.  If not, then precompiled versions will be included with
+the distributed package.  New models can be added if OpenCL or a C compiler
+is available.
+
+Example
+-------
+
+The example directory contains a radial+tangential data set for an oriented
+rod-like shape.
+
+The data is loaded by sas.dataloader from the sasview package, so sasview
+is needed to run the example.
+
+To run the example, you need sasview, sasmodels and bumps.  Assuming these
+repositories are installed side by side, change to the sasmodels/example
+directory and enter::
+
+    PYTHONPATH=..:../../sasview/src ../../bumps/run.py fit.py \
+        cylinder --preview
+
+See bumps documentation for instructions on running the fit.  With the
+python packages installed, e.g., into a virtual environment, then the
+python path need not be set, and the command would be::
+
+    bumps fit.py cylinder --preview
+
+The fit.py model accepts up to two arguments.  The first argument is the
+model type, which has been defined for cylinder, capped_cylinder,
+core_shell_cylinder, ellipsoid, triaxial_ellipsoid and lamellar.  The
+second argument is view, which can be radial or tangential.  To fit
+both radial and tangential simultaneously, use the word "both".
+
+Notes
+-----
+
+cylinder.c + cylinder.py is the cylinder model with renamed variables and
+sld scaled by 1e6 so the numbers are nicer.  The model name is "cylinder"
+
+lamellar.py is an example of a single file model with embedded C code.
+
+Magnetism hasn't been implemented yet.  We may want a separate Imagnetic
+calculator with the extra parameters and calculations.   We should
+return all desired spin states together so we can share the work of
+computing the form factors for the different magnetic contrasts.  This
+will mean extending the data handler to support multiple cross sections
+in the same data set.
+
+`Travis-CI Build Status <https://travis-ci.org/SasView/sasmodels.svg?branch=master)](https://travis-ci.org/SasView/sasmodels>`_
