Re: please test kawa-3.0 release candidate 2

Re: please test kawa-3.0 release candidate 2

[Timo Myyrä]

Per Bothner <per@bothner.com> writes:

> 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 <per@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.

Re: please test kawa-3.0 release candidate 2

[Per Bothner]

On 09/02/2017 10:51 PM, Timo Myyrä wrote:

> 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

Oops.  Checked in now.

> 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

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.
-- 
	--Per Bothner
per@bothner.com   http://per.bothner.com/

Re: please test kawa-3.0 release candidate 2

[Timo Myyrä]

Per Bothner <per@bothner.com> writes:

> On 09/02/2017 10:51 PM, Timo Myyrä wrote:
>
>> 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
>
> Oops.  Checked in now.
>
>> 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
>
> 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

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.)
-- 
	--Per Bothner
per@bothner.com   http://per.bothner.com/

please test kawa-3.0 release candidate 2

[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
per@bothner.com   http://per.bothner.com/

please test kawa-3.0 release candidate 2

[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.
-- 
	--Per Bothner
per@bothner.com   http://per.bothner.com/