please test kawa-3.0 release candidate 1

[Per Bothner]

http://per.bothner.com/kawa/kawa-3.0rc1.tar.gz (Source)
http://per.bothner.com/kawa/kawa-3.0rc1.zip (Binary)
Manual: http://per.bothner.com/kawa/manual/

This is a major release, with multiple big changes:
http://per.bothner.com/kawa/manual/news.xhtml
(The look-and-feel of this version of the manual is a bit different
from the home page, but that will be fixed.)

[David Pirotte]

Hello Per,

Post by Per Bothner
http://per.bothner.com/kawa/manual/news.xhtml
(The look-and-feel of this version of the manual is a bit different
from the home page, but that will be fixed.)

Thanks for the great work. I don't use Kawa that much, so I don't have a good app
to test it, but for info, I did build and 'make check' successfully, the latest,
from master, last commit here is commit 255e92bc5bbd1744da4356c7bd2a7b36f11e4147:

***@capac:/usr/local/src/kawa/git 17 $ kawa --version
Kawa 2.93 (git describe: 2.93-95-g255e92bc5-dirty)

I'm on debian buster:

4.12.0-1-amd64 #1 SMP Debian 4.12.6-1 (2017-08-12) x86_64
GNU/Linux

Cheers,
David

[Per Bothner]

http://per.bothner.com/kawa/kawa-3.0rc2.tar.gz (Source)
http://per.bothner.com/kawa/kawa-3.0rc2.zip (Binary)

Fairly minor changes from release candidate 1.
Mainly relating to Android, plus fixing a bug relating to man pages.

[Per Bothner]

http://per.bothner.com/kawa/kawa-3.0rc2.tar.gz (Source)
http://per.bothner.com/kawa/kawa-3.0rc2.zip (Binary)

Fairly minor changes from release candidate 1.
Mainly relating to Android, plus fixing a bug relating to man pages.

Testing Window and Mac would be especially welcome.
For the binary release, please try that the REPL works (especially
on Windows and Mac), with line-editing. Also that -w works, as well
as -wjavafx and -wbrowser. Also --browse-manual.

[Timo Myyrä]

Post by Per Bothner
http://per.bothner.com/kawa/kawa-3.0rc2.tar.gz (Source)
http://per.bothner.com/kawa/kawa-3.0rc2.zip (Binary)
Fairly minor changes from release candidate 1.
Mainly relating to Android, plus fixing a bug relating to man pages.
Testing Window and Mac would be especially welcome.
For the binary release, please try that the REPL works (especially
on Windows and Mac), with line-editing. Also that -w works, as well
as -wjavafx and -wbrowser. Also --browse-manual.

Hi,

Running the tests won't work fully on OpenBSD yet, there are open issues on
Gitlab with patches for these:
https://gitlab.com/kashell/Kawa/issues/17
https://gitlab.com/kashell/Kawa/issues/18

Man pages seem to copy nicely now but I looked at them with mandoc lint and they
contain few minor style errors:

$ mandoc -Tlint qexo.man
mandoc: qexo.man:95:41: STYLE: whitespace at end of input line
mandoc: qexo.man:96:40: STYLE: whitespace at end of input line
mandoc: qexo.man:102:5: STYLE: unterminated quoted argument
mandoc: qexo.man:1:2: WARNING: missing date, using today's date: TH
mandoc: qexo.man:87:2: WARNING: skipping paragraph macro: P empty
mandoc: qexo.man:94:2: WARNING: skipping paragraph macro: P empty
mandoc: qexo.man:101:2: WARNING: skipping paragraph macro: P empty

$ mandoc -Tlint kawa.man
mandoc: kawa.man:84:41: STYLE: whitespace at end of input line
mandoc: kawa.man:1:2: WARNING: missing date, using today's date: TH
mandoc: kawa.man:83:2: WARNING: skipping paragraph macro: P empty

Here's simple patches to fix the warnings and style issues in the man pages:

--- kawa.man.orig Sun Sep 3 08:38:49 2017
+++ kawa.man Sun Sep 3 08:45:06 2017
@@ -1,4 +1,4 @@
-.TH KAWA 1
+.TH KAWA 1 2017-09-03
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
@@ -80,8 +80,7 @@
Per Bothner <***@bothner.com>.
.SH "SEE ALSO"
.BR "info kawa" " - the complete Kawa manual."
-.P
-.UR "http://www.gnu.org/software/kawa/"
+.UR "http://www.gnu.org/software/kawa/"
.IR "http://www.gnu.org/software/kawa/"
.UE
- the


--- qexo.man.orig Sun Sep 3 08:42:48 2017
+++ qexo.man Sun Sep 3 08:45:25 2017
@@ -1,4 +1,4 @@
-.TH QEXO 1
+.TH QEXO 1 2017-09-03
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
@@ -84,22 +84,19 @@
.B kawa(1)
.P
.BR "info kawa" " - the complete Kawa manual."
-.P
.UR "http://www.gnu.org/software/qxeo/"
.I http://www.gnu.org/software/qxeo/
.UE
- the
.B qexo
home page.
-.P
-.UR "http://www.gnu.org/software/kawa/"
-.I "http://www.gnu.org/software/kawa/"
+.UR "http://www.gnu.org/software/kawa/"
+.I "http://www.gnu.org/software/kawa/"
.UE
- the
.B kawa
home page.
-.P
-.UR "htpp://www.w3.org/XML/Query""
+.UR "htpp://www.w3.org/XML/Query"
.I "htpp://www.w3.org/XML/Query"
.UE
- the W3C XQuery home page.

[Per Bothner]

Post by Timo Myyrä
Running the tests won't work fully on OpenBSD yet, there are open issues on
https://gitlab.com/kashell/Kawa/issues/17
https://gitlab.com/kashell/Kawa/issues/18

Oops. Checked in now.

Post by Timo Myyrä
Man pages seem to copy nicely now but I looked at them with mandoc lint and they
$ mandoc -Tlint qexo.man
mandoc: qexo.man:95:41: STYLE: whitespace at end of input line
mandoc: qexo.man:96:40: STYLE: whitespace at end of input line
mandoc: qexo.man:102:5: STYLE: unterminated quoted argument
mandoc: qexo.man:1:2: WARNING: missing date, using today's date: TH
mandoc: qexo.man:87:2: WARNING: skipping paragraph macro: P empty
mandoc: qexo.man:94:2: WARNING: skipping paragraph macro: P empty
mandoc: qexo.man:101:2: WARNING: skipping paragraph macro: P empty
$ mandoc -Tlint kawa.man
mandoc: kawa.man:84:41: STYLE: whitespace at end of input line
mandoc: kawa.man:1:2: WARNING: missing date, using today's date: TH
mandoc: kawa.man:83:2: WARNING: skipping paragraph macro: P empty

I checked in most of your patches.

However, I'm not sure about how to add a date to the TH macro.
Manually putting a date in there seems wrong. Better might be
to use the same date as the UPDATED macro in version.texi.
Or maybe the date *should* be manually updated - these are files
that are seldom updated anyway.

[Timo Myyrä]

Post by Per Bothner

Post by Timo Myyrä
Running the tests won't work fully on OpenBSD yet, there are open issues on
https://gitlab.com/kashell/Kawa/issues/17
https://gitlab.com/kashell/Kawa/issues/18

Oops. Checked in now.

Post by Timo Myyrä
Man pages seem to copy nicely now but I looked at them with mandoc lint and they
$ mandoc -Tlint qexo.man
mandoc: qexo.man:95:41: STYLE: whitespace at end of input line
mandoc: qexo.man:96:40: STYLE: whitespace at end of input line
mandoc: qexo.man:102:5: STYLE: unterminated quoted argument
mandoc: qexo.man:1:2: WARNING: missing date, using today's date: TH
mandoc: qexo.man:87:2: WARNING: skipping paragraph macro: P empty
mandoc: qexo.man:94:2: WARNING: skipping paragraph macro: P empty
mandoc: qexo.man:101:2: WARNING: skipping paragraph macro: P empty
$ mandoc -Tlint kawa.man
mandoc: kawa.man:84:41: STYLE: whitespace at end of input line
mandoc: kawa.man:1:2: WARNING: missing date, using today's date: TH
mandoc: kawa.man:83:2: WARNING: skipping paragraph macro: P empty

I checked in most of your patches.
However, I'm not sure about how to add a date to the TH macro.
Manually putting a date in there seems wrong. Better might be
to use the same date as the UPDATED macro in version.texi.
Or maybe the date *should* be manually updated - these are files
that are seldom updated anyway.

Hmm, probably best to add some code to update the date when building the
release. That way the date in man page would reflect the release date of
kawa. It would make the date shown in man page useful.

Perhaps add some place holder in the man page and rewrite it in Makefile:

kawa.man:
sed "s/#RELEASE_DATE#/$(date +%Y-%m-%d)/" kawa.man.tmp > kawa.man

qexo.man:
sed "s/#RELEASE_DATE#/$(date +%Y-%m-%d)/" qexo.man.tmp > qexo.man

The above is just example, I haven't tested it yet.

Timo