docs: change to markdown (README, LICENSE, INSTALL) (#298)

Author: jmckenna

.github/workflows/build-windows.yml

@@ -86,11 +86,12 @@ jobs:
             $env:PROJ_LIB = "$sdkprefix\bin\proj9\share"
             .\mapcache_seed.exe -c "${{github.workspace}}\build\mapcache.xml" -t global --force -z 0,1
             Copy-Item -Path "${{github.workspace}}\build\global\GoogleMapsCompatible\00\000\000\000\000\000\000.jpg" -Destination "${{github.workspace}}\seed.jpg"
-            $match = (.\gdal\apps\gdalinfo.exe -checksum "${{github.workspace}}\seed.jpg" | Select-String -CaseSensitive -Pattern "Checksum=21336" -Quiet)
+            .\gdal\apps\gdalinfo.exe -checksum "${{github.workspace}}\seed.jpg"
+            $match = (.\gdal\apps\gdalinfo.exe -checksum "${{github.workspace}}\seed.jpg" | Select-String -CaseSensitive -Pattern "Checksum=21411" -Quiet)
             if ( $match ) {
-              "Success"
+              "Success: matched checksum for seed.jpg"
             } else {
-              "Failure: Did not get expected checksum"
+              "Failure: Did not get expected checksum for seed.jpg"
               exit 1
             }
             $env:MAPCACHE_CONFIG_FILE = "${{github.workspace}}\build\mapcache.xml"
@@ -99,11 +100,12 @@ jobs:
             $env:QUERY_STRING = ""
             Start-Process -FilePath ".\mapcache.fcgi.exe" -RedirectStandardOutput "${{github.workspace}}\fcgi.jpg" -NoNewWindow -Wait
             perl.exe -0777 -pi -e 'binmode ARGV;binmode ARGVOUT;s/[A-Z][a-z][-:; ,\/=A-Za-z0-9\r\n]*//' "${{github.workspace}}\fcgi.jpg"
-            $match = (.\gdal\apps\gdalinfo.exe -checksum "${{github.workspace}}\fcgi.jpg" | Select-String -CaseSensitive -Pattern "Checksum=21336" -Quiet)
+            .\gdal\apps\gdalinfo.exe -checksum "${{github.workspace}}\fcgi.jpg"
+            $match = (.\gdal\apps\gdalinfo.exe -checksum "${{github.workspace}}\fcgi.jpg" | Select-String -CaseSensitive -Pattern "Checksum=21411" -Quiet)
             if ( $match ) {
-              "Success"
+              "Success: matched checksum for fcgi.jpg"
             } else {
-              "Failure: Did not get expected checksum"
+              "Failure: Did not get expected checksum for fcgi.jpg"
               exit 1
             }
 

INSTALL

@@ -0,0 +1,19 @@
+Unix compilation instructions
+-----------------------------
+
+MapCache now builds with CMake. It seems much happier if it can find apxs, which 
+means you might need apache2-prefork installed (on ubuntu `apt-get install apache2-prefork-dev`).
+
+```
+  cd mapcache
+  mkdir build
+  cd build
+  cmake ..
+  make
+  sudo make install
+```
+
+Detailed instructions and configuration options are maintained in the MapCache 
+documentation :
+
+https://mapserver.org/mapcache/install.html

INSTALL.md

@@ -0,0 +1,24 @@
+MapCache Licensing
+==================
+
+Copyright (c) 2008-2023 Open Source Geospatial Foundation.  
+Copyright (c) 1996-2008 Regents of the University of Minnesota.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies of this Software or works derived from this Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+

LICENSE

@@ -0,0 +1,27 @@
+MapCache
+========
+
+[![Build Status](https://travis-ci.org/MapServer/mapcache.svg?branch=main)](https://travis-ci.org/MapServer/mapcache)
+[![Appveyor Build Status](https://ci.appveyor.com/api/projects/status/7al5utxjh83ig71v?svg=true)](https://ci.appveyor.com/project/mapserver/mapcache)
+
+Summary
+-------
+
+MapCache is a server that implements tile caching to speed up access to WMS layers. 
+The primary objectives are to be fast and easily deployable, while offering the 
+essential features (and more!) expected from a tile caching solution.
+
+For more  information and complete documentation please 
+visit:
+
+  https://mapserver.org/mapcache/
+  
+Questions relating to MapCache use and development can be asked on the 
+MapServer mailing lists:
+
+  https://mapserver.org/community/lists.html  
+  
+License
+-------
+
+See [LICENSE.md](LICENSE.md)