Document things a bit more!

README.txt

@@ -5,3 +5,11 @@
 |_|  |_|\__,_|_|\__|_|_.__/ \__,_|_|_(_|_)
 
 Run commands across a set of hosts interactively!
+=================================================
+
+Basic configuration file is in multiball.cfg.example in the distribution. Customize to your liking. Host list is loaded from,
+by default, your ssh configuration (assuming you have a specific ssh configuration for your all hosts like Autonomic has). You
+can also use arbitrary host lists (documented in configuration file).
+
+
+Planned features, see __main__.py's comments.

multiball.cfg.example

@@ -1,9 +1,19 @@
 [config]
+# The path to the file to store history in.
 history=multiball.history
+
+# A comma-separated list of sshconfigs, but really only the first one matters due to a bug.
 sshconfigs=~/.ssh/config
+
+# Bare host lists, one host per line.
+#hostlists=example.txt,example2.txt
 hostlists=
 
 [startup]
+# Commands which run at startup. Not really supported yet. For building aliases and things.
+
+
+### Below are commands, which are a mini-script to execute several commands in a row.
 
 [cmd.upgrade]
 /unsafe

multiball/__main__.py

@@ -21,8 +21,6 @@
 # - allow scripts that use -safe to prompt for safety / restore safety after running
 
 
-
-
 import argparse
 import datetime
 import fnmatch

pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 [project]
 name = "multiball"
 dynamic = ["version"]
-description = "Run commands accross a set of hosts interactively."
+description = "Multi-host parallel execution shell with powerful features."
 authors = [{name = "Cassowary", email="cassowary@riseup.net"}]
 dependencies = ["tqdm", "yaml-1.3", "prompt_toolkit", "fabric2"]
 requires-python = ">=3.8"