From 57f861c11b66cc194371692cf55d2b471eea18fd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Julian=20R=C3=BCth?= Date: Wed, 8 Nov 2023 20:25:28 +0200 Subject: [PATCH] Fix README there is no need to insist on Python 3 anymore these days. Also, technically, these are Python packages and not modules. --- README.rst | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/README.rst b/README.rst index b81f3ed..f17e6d4 100644 --- a/README.rst +++ b/README.rst @@ -1,7 +1,7 @@ Veerer ====== -Veerer is a Python module to deal with veering triangulations of surfaces and +Veerer is a Python package to deal with veering triangulations of surfaces and their associated flat structures. It can in particular be used to provide representatives of pseudo-Anosov mapping classes of surfaces. The theoretical background is based on ideas of I. Agol and F. Guéritaud, and is developed in: @@ -10,12 +10,11 @@ M. Bell, V. Delecroix, V. Gadre, R. Gutiérrez-Romo, S. Schleimer, "Coding Teichmüller flow using veering triangulations", `arXiv:1909.00890 `_. -To install the module you need Python 3. +To install this package you only need Python but additional features are +available if this package is used inside `SageMath +`_. -Additional features are available if this module is used inside -`SageMath `_. - -Computations involving polytopes are only available if the Python module +Computations involving polytopes are only available if the Python package `pplpy `_ is available. It is installed by default with SageMath, version 8.7 or above. @@ -49,9 +48,9 @@ If you use Veerer inside SageMath, the flat structure can be displayed with:: Testing ------- -To run the SageMath doctests, install the module with pip, typically:: +To run the SageMath doctests, install the package with pip, typically:: - $ sage -pip install . --user --force-reinstall + $ sage -pip install -e . and then run:: @@ -64,7 +63,7 @@ Or:: Building the documentation -------------------------- -Go to the ``docs`` repository and then do:: +Go to the ``docs`` directory and then do:: $ sage -sh $ make html @@ -78,8 +77,8 @@ to have available on your computer - rst2latex python-docutils - pdflatex - pandoc -- the Python module rst2ipynb -- the Python module nbconvert +- the Python package rst2ipynb +- the Python package nbconvert Then do::