Improve the README ahead of publishing to pip v2.0.1
authorAlexander Vasarab <alexander@wylark.com>
Sun, 21 Jun 2020 02:45:57 +0000 (19:45 -0700)
committerAlexander Vasarab <alexander@wylark.com>
Sun, 21 Jun 2020 03:04:41 +0000 (20:04 -0700)
README.md
munter/__init__.py

index a61f2d91784f90f7a83d482c230143d49bb76cca..03f49c5d12b0cf893ba6bbeb4f8ac3db39e81a7e 100644 (file)
--- a/README.md
+++ b/README.md
@@ -13,14 +13,38 @@ estimates is your own fault.
 Installation
 ------------
 
-There is no installation and there are no dependencies external to the Python
-standard library.
+If you use pip, then simply `pip install munter.py`.
+
+If you don't use pip, then download the source code and unpack it into
+its own directory. You can invoke it directly via `python munter.py
+[options]`.
 
 How to use it
 -------------
 
+For detailed information, see:
+
 `./munter.py --help`
 
+The program supports both imperial and metric, and has four "travel
+modes" at this time: uphill, flat, downhill, bushwhacking.
+
+By default, the output will be the time in hours and minutes of the
+specified leg. If you prefer, you can use the `-p` switch to get a
+"prettier" output.
+
+### Use as a library
+
+You can also use Munter.py programmatically from Python, like so:
+
+`import munter`  
+`est = munter.time_calc(3.2, 2300, 'uphill', 'imperial')`
+
+This will store a value like "3.04095" in the `est` variable.
+
+Workflow
+--------
+
 My workflow involves planning my tour using tools like ArcGIS or CalTopo. Then,
 I take the stats between each leg (distance, vertical gain/loss) of the tour
 and run them through Munter.py and thence record its output to my field
@@ -45,6 +69,10 @@ Future plans
 Version History
 ---------------
 
+- 2.0.1 (Jun 2020)
+
+  README improvement
+
 - 2.0.0 (Jun 2020)
 
   Packaged for distribution as a standalone program (and library).
index 3f7363914589e306588060abc8943a9ceb1189d3..f5c46cbe837193518777d3000dd5aed1605a3411 100755 (executable)
@@ -1,3 +1,3 @@
 """Main package for Munter.py"""
-__version__ = "2.0.0"
+__version__ = "2.0.1"
 from .munter import time_calc