diff --git a/games/knights/README b/games/knights/README
index d8f10795bf..83b641f521 100644
--- a/games/knights/README
+++ b/games/knights/README
@@ -1,6 +1,6 @@
-Knights is a simple chess board for KDE 4.
+knights (a simple chess board for KDE 4)
 
-It is a rewrite of the KDE3 Knights. You can play againts computer engines
-that support the XBoard protocol (like GnuChess), against anouther player
-at the same computer, or on the Free Internet Chess Server. It has
-automatic rule checking and some nice animations.
+Knights is a rewrite of the KDE3 Knights. You can play against computer
+engines that support the XBoard protocol (like GnuChess), against another
+player at the same computer, or on the Free Internet Chess Server. It
+has automatic rule checking and some nice animations.
diff --git a/games/knights/knights.SlackBuild b/games/knights/knights.SlackBuild
index 6c8712f38a..d4a1f1c9f8 100644
--- a/games/knights/knights.SlackBuild
+++ b/games/knights/knights.SlackBuild
@@ -3,7 +3,7 @@
 # Slackware build script for knights
 
 # Copyright 2011, 2012  Chris Abela, Malta
-# Copyright 2014  Ryan P.C. McQuen, ryanpcmcquen@member.fsf.org, WA
+# Copyright 2014  Ryan P.C. McQuen, <email removed>, WA
 # Now maintained by B. Watson (yalhcru@gmail.com)
 #
 # All rights reserved.
@@ -25,6 +25,12 @@
 # OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 # ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
+# 20170810 bkw:
+# - install HTML docs in /usr/doc, not /usr/share/doc
+# - fix README and slack-desc typos
+# - remove long-dead homepage link from slack-desc
+# - BUILD=3
+
 # 20170309 bkw:
 # - take over maintenance
 # - i486 => i586
@@ -33,7 +39,7 @@
 
 PRGNAM=knights
 VERSION=${VERSION:-2.5.0}
-BUILD=${BUILD:-2}
+BUILD=${BUILD:-3}
 TAG=${TAG:-_SBo}
 
 if [ -z "$ARCH" ]; then
@@ -88,7 +94,7 @@ cd build
     -DMAN_INSTALL_DIR=/usr/man \
     -DBIN_INSTALL_DIR=/usr/games \
     -DCMAKE_BUILD_TYPE=Release ..
-  make  VERBOSE=1
+  make VERBOSE=1
   make install/strip DESTDIR=$PKG
 cd ..
 
@@ -97,6 +103,9 @@ cd ..
 # ...but most of the existing files there from other packages are +x,
 # not sure if KDE cares about the permissions but I'll leave it as-is.
 
+# 20170810 bkw: don't install to /usr/share/doc
+mv $PKG/usr/share/doc $PKG/usr/doc
+
 mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION
 cp -a DESIGN README* $PKG/usr/doc/$PRGNAM-$VERSION
 cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild
diff --git a/games/knights/slack-desc b/games/knights/slack-desc
index 09b05ca2c8..b2c120b2d3 100644
--- a/games/knights/slack-desc
+++ b/games/knights/slack-desc
@@ -6,14 +6,14 @@
 # customary to leave one space after the ':' except on otherwise blank lines.
 
        |-----handy-ruler------------------------------------------------------|
-knights: knights (simple chess board for KDE 4)
+knights: knights (a simple chess board for KDE 4)
+knights:
+knights: Knights is a rewrite of the KDE3 Knights. You can play against
+knights: computer engines that support the XBoard protocol (like GnuChess),
+knights: against another player at the same computer, or on the Free Internet
+knights: Chess Server. It has automatic rule checking and some nice animations.
+knights:
 knights:
-knights: It is a rewrite of the KDE3 Knights. You can play againts computer
-knights: engines that support the XBoard protocol (like GnuChess), against
-knights: anouther player at the same computer, or on the Free Internet Chess
-knights: Server. It has automatic rule checking and some nice animations.
-knights:
-knights: Homepage: http://noughmad.com/knights
 knights:
 knights:
 knights: