From 68c5f93ea6f880f3d59da48831fa97d70589af47 Mon Sep 17 00:00:00 2001
From: Franklin Wei <git@fwei.tk>
Date: Sat, 3 Jun 2017 22:01:17 -0400
Subject: puzzles: update manual entry

Change-Id: I9c53eaa217ec8cd36ce3de4eaa1237c78bb0c1ea
---
 manual/plugins/main.tex        |  4 ++--
 manual/plugins/puzzles.tex     |  7 -------
 manual/plugins/sgt-puzzles.tex | 29 +++++++++++++++++++++++++++++
 3 files changed, 31 insertions(+), 9 deletions(-)
 delete mode 100644 manual/plugins/puzzles.tex
 create mode 100644 manual/plugins/sgt-puzzles.tex

(limited to 'manual/plugins')

diff --git a/manual/plugins/main.tex b/manual/plugins/main.tex
index cc3d9380ab..540a0efe5c 100644
--- a/manual/plugins/main.tex
+++ b/manual/plugins/main.tex
@@ -72,8 +72,6 @@ text files%
 
 \opt{lcd_bitmap}{\input{plugins/pong.tex}}
 
-\opt{lcd_bitmap}{\input{plugins/puzzles.tex}}
-
 \opt{lcd_bitmap}{\input{plugins/reversi.tex}}
 
 \opt{lcd_bitmap}{\input{plugins/robotfindskitten.tex}}
@@ -82,6 +80,8 @@ text files%
 
 \opt{lcd_bitmap}{\input{plugins/rockblox1d.tex}}
 
+\opt{lcd_bitmap}{\input{plugins/sgt-puzzles.tex}}
+
 \opt{lcd_bitmap}{\input{plugins/sliding.tex}}
 
 \opt{lcd_bitmap}{\input{plugins/snake.tex}}
diff --git a/manual/plugins/puzzles.tex b/manual/plugins/puzzles.tex
deleted file mode 100644
index 5ce2c5ab63..0000000000
--- a/manual/plugins/puzzles.tex
+++ /dev/null
@@ -1,7 +0,0 @@
-\subsection{Puzzles}
-\screenshot{plugins/images/ss-puzzles-cube}{``Cube'' from Puzzles}{fig:Cube}
-\screenshot{plugins/images/ss-puzzles-map}{``Map'' from Puzzles}{fig:Map}
-
-``Puzzles'' is a port of Simon Tatham's Portable Puzzle
-Collection. For documentation on the games included, please visit
-(\url{http://www.chiark.greenend.org.uk/~sgtatham/puzzles/}).
diff --git a/manual/plugins/sgt-puzzles.tex b/manual/plugins/sgt-puzzles.tex
new file mode 100644
index 0000000000..5001a39aaf
--- /dev/null
+++ b/manual/plugins/sgt-puzzles.tex
@@ -0,0 +1,29 @@
+\subsection{Sgt-Puzzles}
+\screenshot{plugins/images/ss-puzzles-cube}{``Cube'', a rolling solid puzzle}{fig:Cube}
+\screenshot{plugins/images/ss-puzzles-map}{``Map'', a 4-coloring game}{fig:Map}
+
+The games that begin with the ``sgt-'' prefix are ports of certain
+puzzles from Simon Tatham's Portable Puzzle Collection, an open source
+collection of single-player puzzle games.
+
+\subsubsection{Puzzle Documentation}
+For documentation on the games included, please see the ``Extensive
+Help'' menu option from inside the plugin to read puzzle-specific
+instructions or visit their official website at
+\url{https://www.chiark.greenend.org.uk/~sgtatham/puzzles/}.
+
+\subsubsection{Dynamic Font Sizing}
+By default, each game will only use one of two fonts in drawing: the
+hard-coded system font for fixed-width text, and the theme's UI font
+for variable-width text. For improved puzzle rendering, each puzzle is
+capable of using a special font pack when it is installed. This font
+pack is available from
+\url{http://download.rockbox.org/useful/sgt-fonts.zip}. To install,
+simply extract the contents of this file to the
+\fname{/.rockbox/fonts/} directory on your device. Once this has been
+done, each game will dynamically load and use properly-sized fonts
+whenever needed.
+
+\note{On hard disk-based devices, this may cause a slight delay as the
+  disk spins up to load the fonts when a puzzle is first started, and
+  after using the ``Extensive Help'' feature.}
-- 
cgit v1.2.3