clean up Settings portion of documentation, and document foreground mode

doc/index.html

@@ -41,43 +41,67 @@ too.
 
 <p>Voila!  You can use ssh/scp/sftp/rsync to talk to your Android device!</p>
 
-<h2>Configuration</h2>
+<h2>Settings</h2>
 
-<p>There are three directory settings that are important for SimpleSSHD.</p>
+<p>Generally speaking, you must re-start the SimpleSSHD service for any
+of these settings to take effect.</p>
 
-<p>The first is the path for general dropbear files, which defaults to
+<dl>
+<dt>Start on Boot</dt>
+<dd>Automatically start the SimpleSSHD service when the phone powers on.</dd>
+
+<dt>Foreground Service</dt>
+<dd>Run the SimpleSSHD service as an Android "foreground service." This
+means a notification will be displayed for the service (you might be able
+to block the notification by holding down on the notification).
+On newer versions of Android (Marshmallow and Nougat), this will also
+make SimpleSSHD much more responsive if the phone has been in and out of
+Doze mode.  It does not seem to increase battery consumption much.</dd>
+
+<dt>Port Number</dt>
+<dd>This is the port number that SimpleSSHD will listen on.  It must be
+greater than 1024 (because SimpleSSHD does not have root).</dd>
+
+<dt>SSH Path</dt>
+<dd>Path for general dropbear files, which defaults to
 <tt>/sdcard/ssh</tt>.  Most importantly, this is where
 <tt>authorized_keys</tt> is found.  It is also where host keys wind up
-(they are created on demand), and where temporary files go.</p>
+(they are created on demand), and where temporary files go.  This path
+should probably be under <tt>/sdcard</tt>.</dd>
 
-<p>Next is the path to the login shell.  The default Android shell is
+<dt>Login Shell</dt>
+<dd>Path to the command shell.  The default Android shell is
 <tt>/system/bin/sh</tt>, but you may prefer to use the one that comes with
 busybox or whatever.  If you set it to the su binary (i.e.,
-<tt>/system/xbin/su</tt>), then scp, sftp, and
-rsync will run as root and should be able to access files
-outside of the sdcard.</p>
+<tt>/system/xbin/su</tt>), then scp, sftp, and rsync will run as root and
+should be able to access files outside of the sdcard.</dd>
 
-<p>A bug in SuperSU interacts with an infelicity in rsync to cause an
+<dt>Buffer hack for rsync+SuperSU</dt>
+<dd>A bug in SuperSU interacts with an infelicity in rsync to cause an
 occasional deadlock.  This is a real pain because I use SuperSU+rsync 
 for system-wide backups, which will always eventually trigger the
 deadlock.  To work around this, there is a "Buffer hack" option that
 should be enabled if you use rsync with SuperSU.  It adds a miniscule
 overhead to rsync, but isn't harmful even if you aren't using
-SuperSU.</p>
+SuperSU.</dd>
 
-<p>Finally, there is the path for the home directory, which also defaults
+<dt>Home Directory</dt>
+<dd>The login shell's home directory, which also defaults
 to <tt>/sdcard/ssh</tt>.  This is where your ssh session starts out, and is
-where <tt>.profile</tt> will be found if it is present.</p>
+where <tt>.profile</tt> will be found if it is present.</dd>
 
-<p>There is also a place where you can put additional commandline options
-for dropbear server.  The options which are hardcoded are:
-<tt>-R -F -p :portno</tt>.
+<dt>Extra Commandline</dt>
+<dd>You can specify additional commandline options for dropbear server.
+The options which are hardcoded are:
+<blockquote><pre>-R -F -p :portno</pre></blockquote>
 You can use <tt>\</tt> or <tt>"</tt> to escape characters in this
-commandline.</p>
+commandline.</dd>
 
 <h2>Change Log</h2>
 
 <ul>
+<li> <b>2016/10/xx Version 13:</b> Support foreground service (fewer
+stalls with newer Android).
 <li> <b>2016/08/08 Version 1.11:</b> Fix stall initializing random number generator.
 <li> <b>2016/07/22 Version 1.10:</b> Enable TCP port forwarding.
 <li> <b>2016/07/04 Version 1.9:</b> Restart sshd if the system kills it.