Per Bothner e5b4a4bc98 One minor doc update and 2 typos. vor 5 Jahren
..
images e93a4177ef Sync branches/invoke with trunk -r8883:9027 vor 8 Jahren
style 73d2a42252 * Makefile.am (kawa.xml): Change Top node to index.html, not start.html. vor 7 Jahren
+default+ e93a4177ef Sync branches/invoke with trunk -r8883:9027 vor 8 Jahren
.cvsignore 0feefdf674 *** empty log message *** vor 21 Jahren
ChangeLog 098978abe6 Fix 2 documentation issues (type and missing 'expt'). vor 5 Jahren
Makefile.am 50177cf4bd Fix typo for kashell.html Makefile rule. vor 6 Jahren
README-epub 5fe40b2e27 Sync branches/invoke with trunk -r9027:9034. vor 8 Jahren
browse-kawa-manual 5fe40b2e27 Sync branches/invoke with trunk -r9027:9034. vor 8 Jahren
kashell.texi 10d8f954e4 * kashell.texi: Merge in and update some information. vor 6 Jahren
kawa.man b837eb8986 * kawa.man, qexo.man: Fix some style errors reported by mandoc lint. vor 7 Jahren
kawa.texi e5b4a4bc98 One minor doc update and 2 typos. vor 5 Jahren
latex8.bst 06b4550d19 Remove RCS Id template. vor 25 Jahren
mdate-sh 0135a66702 ( vor 26 Jahren
mine.bib af25a9f20f New directory - files mostly moved from .. . vor 28 Jahren
news.texi d477ef9faa Revert 2017-08-26 cȟange (commit 77784568 for issue #11). vor 6 Jahren
qexo.man b837eb8986 * kawa.man, qexo.man: Fix some style errors reported by mandoc lint. vor 7 Jahren
scm2java.html af25a9f20f New directory - files mostly moved from .. . vor 28 Jahren
texinfo.tex f275c41ffe * texinfo.tex: Use newer version. vor 7 Jahren
with-frames.html e93a4177ef Sync branches/invoke with trunk -r8883:9027 vor 8 Jahren

README-epub

The file kawa-manual.epub contains the Kawa documentation packaged
as an e-book in EPUB format. It should be readable by most standalone
e-book readers. There are also plugins available for various browsers.

You can also read the manual with the kawa --browse-manual option:

$ kawa --browse-manual

Here kawa is one of kawa or kawa.bat in the ../bin directory.

This command starts a mini-web-server, and then creates a window or tab
to read it using your default browser.

You can specify some other browser - for example:

$ kawa --browse-manual="firefox %U"

This runs the command quoted, after Kawa replaces %U with a URL
referencing Kawa's mini-web-server.

An epub is essentially a zip archive, which you can unzip:

cd $KAWA_HOME/doc
unzip kawa-manual.epub

Then you can use a plain browser with the URL
file:$KAWA_HOME/doc/OEBPS/index.xhtml.

You can generate the web-page-style html files from the source
with 'cd doc && make web/index.html', but this requires
various tools including xsltproc and the docbook style sheets.