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

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.