better handling of missing boot.html files

This commit is contained in:
David Botton 2022-09-30 15:28:50 -04:00
parent e1adace5ff
commit 073c4ba940

View file

@ -80,24 +80,26 @@ the same as the clog directy this overides the relative paths used in them.")
"Inititalize CLOG on a socket using HOST and PORT to serve BOOT-FILE as the
default route to establish web-socket connections and static files located at
STATIC-ROOT. The webserver used with CLACK can be chosen with :SERVER and
middlewares prepended with :LACK-MIDDLEWARE-LIST, NOT supporting LACK.BUILDER DSL.
If EXTENDED-ROUTING is t routes will match even if extend with additional / and
additional paths. If LONG-POLLING-FIRST is t then long polling continues until
the on-new-window-handler ends, if LONG-POLLING-FIRST is a number continues long
polling until that number of queries to browser. LONG-POLLING-FIRST is used in
webserver applications to enable crawling of your website. If CLOG was already
initialized and not shut down, this function does the same as
set-on-new-window (does not change the static-root). If ON-NEW-WINDOW-HANDLER is
nil no handler is set and none is removed. STATIC-ROOT by default is the
\"directory CLOG is installed in ./static-files\" If the variable
clog:*overide-static-root* is set STATIC-ROOT will be ignored. If BOOT-FILE is
nil no default boot-file will be set for root path, i.e. /. If static-boot-js is
t then boot.js is served from the file /js/boot.js instead of the compiled
version. If static-boot-html is nil if boot.html is not present will use
compiled version. boot-function if set is called with the url and the contents
of boot-file and its return value replaces the contents sent to the brower, this
allows adding content for search engine optimization, see tutorial 12 for an
example."
middlewares prepended with :LACK-MIDDLEWARE-LIST, NOT supporting LACK.BUILDER
DSL. If EXTENDED-ROUTING is t routes will match even if extend with additional
/ and additional paths. If LONG-POLLING-FIRST is t then long polling continues
until the on-new-window-handler ends, if LONG-POLLING-FIRST is a number
continues long polling until that number of queries to browser.
LONG-POLLING-FIRST is used in webserver applications to enable crawling of your
website. If CLOG was already initialized and not shut down, this function does
the same as set-on-new-window (does not change the static-root). If
ON-NEW-WINDOW-HANDLER is nil no handler is set and none is removed. STATIC-ROOT
by default is the \"directory CLOG is installed in ./static-files\" If the
variable clog:*overide-static-root* is set STATIC-ROOT will be ignored. If
BOOT-FILE is nil no default boot-file will be set for root path, i.e. /. If
static-boot-js is t then boot.js is served from the file /js/boot.js instead of
the compiled version. If static-boot-html is t if boot.html is not present will
use compiled version otherwise if set to nil (default) if a boot file not found
returns returns a blank page, if it is set to :error will signal an error and if
set to a string will display the string. boot-function if set is called with the
url and the contents of boot-file and its return value replaces the contents
sent to the brower, this allows adding content for search engine optimization,
see tutorial 12 for an example."
(declare (ignorable host
port
server