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

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.