Update docs

README.md

@@ -1,4 +1,4 @@
-<p align="center"><img src="html-src/images/high_res/logo_horizontal.png" alt="StretchView" height="180px"></p>
+<p align="center"><img src="html-src/images/high_res/logo_horizontal.png" alt="PySol FC logo" height="180px"></p>
 
 # PySol Fan Club edition
 
@@ -7,7 +7,7 @@ of Card Solitaire/Patience games written in Python. Its homepage is
 https://pysolfc.sourceforge.io/.
 
 The maintenance branch of PySol FC on GitHub by [Shlomi
-Fish](http://www.shlomifish.org/) and by some other
+Fish](https://www.shlomifish.org/) and by some other
 people, has gained official status, ported the code to Python 3,
 and implemented some other enhancements.
 
@@ -27,7 +27,7 @@ can be implemented.
 
 # Screenshots
 
-![Image](<http://i.imgur.com/jQkTGwf.jpg>)
+![Screenshot of PySol FC](https://i.imgur.com/jQkTGwf.jpg)
 
 ## Requirements.
 
@@ -36,20 +36,18 @@ can be implemented.
 
 - For sound support (optional)
   - PySol-Sound-Server fork: https://github.com/shlomif/pysol-sound-server (mp3, wav, tracker music)
-  - (or: ) PyGame: http://www.pygame.org/ (mp3, ogg, wav, midi, tracker music)
+  - (or: ) PyGame: https://www.pygame.org/ (mp3, ogg, wav, midi, tracker music)
 
 - Other packages (optional):
-  - Tile (ttk): http://tktable.sourceforge.net/tile/ (0.8.0 or later)
+  - Pillow (Python Imaging Library): https://pillow.readthedocs.io/
-  - PIL (Python Imaging Library): http://www.pythonware.com/products/pil
+  - Freecell Solver: https://fc-solve.shlomifish.org/
-  - Freecell Solver: http://fc-solve.shlomifish.org/ .
+  - [Black Hole Solitaire Solver](https://www.shlomifish.org/open-source/projects/black-hole-solitaire-solver/)
-  - [Black Hole Solitaire Solver](http://www.shlomifish.org/open-source/projects/black-hole-solitaire-solver/)
 
 ## Installation.
 
-We provide an [installer for Windows](https://sourceforge.net/projects/pysolfc/files/PySolFC/) (requires Windows XP SP3 or higher)
+We provide an [installer for Windows](https://sourceforge.net/projects/pysolfc/files/PySolFC/)
-as well as an Android package on F-droid.
+(requires Windows XP SP3 or higher) as well as an
-
+[Android package on F-droid](https://f-droid.org/packages/org.lufebe16.pysolfc/).
-For installation from source, see: http://www.python.org/doc/current/inst/
 
 ### Running from source without installation.
 
@@ -189,7 +187,7 @@ python pysol.py --kivy
 ### Configuring Freecell Solver
 
 If you want to use the solver, you should configure freecell-solver
-( http://fc-solve.shlomifish.org/ ) by passing the following options
+( https://fc-solve.shlomifish.org/ ) by passing the following options
 to its CMake-based build-system:
 `-DMAX_NUM_FREECELLS=8 -DMAX_NUM_STACKS=20 -DMAX_NUM_INITIAL_CARDS_IN_A_STACK=60`.
 
@@ -239,7 +237,7 @@ To facilitate coordination about contributing to PySol, please join us for a
 real time Internet chat on
 the <a href="irc://irc.freenode.net/##pysol">##pysol</a> chat room on
 [Freenode](http://freenode.net/) (note the double
-octothorpe/hash-sign/pound-sign) .  We may set up
+octothorpe/hash-sign/pound-sign).  We may set up
 chat rooms on different services in the future.
 
 In addition, we set up a

docs/README.SOURCE

@@ -22,7 +22,7 @@ compatibility with saved games of older PySol versions (<= 3.00).
 Prerequisites
 -------------
 First of all you will need the Python development environment, which
-is freely available from http://www.python.org
+is freely available from https://www.python.org.
 
 
 Source code introduction
@@ -119,10 +119,17 @@ The toolkit layer
   of a runtime option.
 
   The preferred toolkit is Tcl/Tk using the Tkinter bindings which
-  ship with every Python installation, but a very experimental version
+  ship with every Python installation.
-  for Gnome (using the pygnome and pygtk bindings) exists as well.
 
-  A more exciting idea is to use JPython to make PySol run under a
+  The Kivy UI adapts PySol for mobile devices and is mainly used for
+  PySolFC's Android port. See README.kivy for more details.
+
+  A very experimental version for GTK+ 2 (using the pygnome and pygtk
+  bindings) did exist as well. Due to pygnome and pygtk being obsoleted,
+  a rewrite against GObject Introspection Python API would be needed
+  to make the abandoned code work with GTK+ 3 or 4.
+
+  Another exciting idea is to use JPython to make PySol run under a
   Java VM using Swing as the toolkit.
 
   Because Tkinter is the "main" interface other toolkit layers have
@@ -223,7 +230,7 @@ Contributing
 ------------
 Apart from contributing new games you can also help by improving the
 interface - e.g. some fancy statistics dialogs would be very nice.
-See the main README.md for more ideas.
+See the main README.md and CONTIRBUTING.md for more ideas.
 
 
 Have fun,