1The file kawa-manual.epub contains the Kawa documentation packaged
2as an e-book in EPUB format.  It should be readable by most standalone
3e-book readers.  There are also plugins available for various browsers.
4
5You can also read the manual with the kawa --browse-manual option:
6
7  $ kawa --browse-manual
8
9Here kawa is one of kawa or kawa.bat in the ../bin directory.
10
11This command starts a mini-web-server, and then creates a window or tab
12to read it using your default browser.
13
14You can specify some other browser - for example:
15
16  $ kawa --browse-manual="firefox %U"
17
18This runs the command quoted, after Kawa replaces %U with a URL
19referencing Kawa's mini-web-server.
20
21An epub is essentially a zip archive, which you can unzip:
22
23    cd $KAWA_HOME/doc
24    unzip kawa-manual.epub
25
26Then you can use a plain browser with the URL
27file:$KAWA_HOME/doc/OEBPS/index.xhtml.
28
29You can generate the web-page-style html files from the source
30with 'cd doc && make web/index.html', but this requires
31various tools including xsltproc and the docbook style sheets.
32