From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([2001:4830:134:3::10]:33974)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eGh6g-0003cx-Tr
	for guix-patches@gnu.org; Mon, 20 Nov 2017 03:07:08 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eGh6c-0008Gn-Ua
	for guix-patches@gnu.org; Mon, 20 Nov 2017 03:07:06 -0500
Received: from debbugs.gnu.org ([208.118.235.43]:39529)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
	id 1eGh6c-0008Gf-Qi
	for guix-patches@gnu.org; Mon, 20 Nov 2017 03:07:02 -0500
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eGh6c-0004CD-EP
	for guix-patches@gnu.org; Mon, 20 Nov 2017 03:07:02 -0500
Subject: [bug#29359] [PATCH 25/31] gnu: Add java-stax.
Resent-Message-ID: <handler.29359.B29359.151116518516084@debbugs.gnu.org>
References: <handler.29359.B.151111429223890.ack@debbugs.gnu.org>
	<20171119175805.902-1-julien@lepiller.eu>
	<20171119175805.902-25-julien@lepiller.eu>
From: Ricardo Wurmus <rekado@elephly.net>
In-reply-to: <20171119175805.902-25-julien@lepiller.eu>
Date: Mon, 20 Nov 2017 09:05:47 +0100
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Message-ID: <873759xtlw.fsf@elephly.net>
List-Id: <guix-patches.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-patches>,
	<mailto:guix-patches-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-patches/>
List-Post: <mailto:guix-patches@gnu.org>
List-Help: <mailto:guix-patches-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-patches>,
	<mailto:guix-patches-request@gnu.org?subject=subscribe>
Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org
Sender: "Guix-patches" <guix-patches-bounces+kyle=kyleam.com@gnu.org>
To: Julien Lepiller <julien@lepiller.eu>
Cc: 29359@debbugs.gnu.org


Julien Lepiller <julien@lepiller.eu> writes:

> * gnu/packages/java.scm (java-stax): New variable.

Maybe move this package to (gnu packages xml) instead.

> +    (home-page "https://repo1.maven.org/maven2/stax/stax/")

This looks weird.  The original home page was http://stax.codehaus.org/,
but it has disappeared.  It=E2=80=99s fine to keep it pointing at the maven
repo, even though it=E2=80=99s not really a home page.

> +    (synopsis "Streaming API for XML")
> +    (description "The StAX Java API for XML processing is designed for p=
arsing
> +XML streams, just like the SAX API's.")


This description could be improved.  How about this:

   This package provides the reference implementation of the
   @dfn{Streaming API for XML} (StAX).  It is used for streaming XML
   data to and from a Java application.  It provides a standard pull
   parser interface.

--
Ricardo

GPG: BCA6 89B6 3655 3801 C3C6  2150 197A 5888 235F ACAC
https://elephly.net