From mboxrd@z Thu Jan  1 00:00:00 1970
From: Marius Bakke <mbakke@fastmail.com>
Subject: Re: [PATCH] gnu: Add capnproto.
Date: Thu, 25 Aug 2016 16:52:30 +0100
Message-ID: <87poow26dd.fsf@ike.i-did-not-set--mail-host-address--so-tickle-me>
References: <CAOP=4wh+2__kbiRoHy0hdTtdhdRzE-d9fkUhh2mqoHwuK9=p9g@mail.gmail.com>
	<87a8g0vp7a.fsf@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51700)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mbakke@fastmail.com>) id 1bcwxQ-00037p-TX
	for guix-devel@gnu.org; Thu, 25 Aug 2016 11:52:45 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mbakke@fastmail.com>) id 1bcwxN-0007rh-N6
	for guix-devel@gnu.org; Thu, 25 Aug 2016 11:52:44 -0400
Received: from out2-smtp.messagingengine.com ([66.111.4.26]:34172)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mbakke@fastmail.com>) id 1bcwxL-0007qR-DY
	for guix-devel@gnu.org; Thu, 25 Aug 2016 11:52:41 -0400
In-Reply-To: <87a8g0vp7a.fsf@gmail.com>
List-Id: "Development of GNU Guix and the GNU System distribution."
	<guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-devel/>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=subscribe>
Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org
Sender: "Guix-devel" <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
To: Alex Vong <alexvong1995@gmail.com>, Kenton Varda <kenton@sandstorm.io>
Cc: guix-devel@gnu.org

Alex Vong <alexvong1995@gmail.com> writes:

>> PS. regarding the man page, I believe Debian mostly generated this
>> page from the capnp tool's help text. I'd accept a patch to
>> c++/src/kj/main.c++ which adds some code to generate man XML format
>> directly, so that we don't have to maintain the same text in multiple
>> places.
>
> I want to ask what is meant by man XML format? Do you mean to generate
> man page? As far as I know, there are at least 2 ways to generate a man
> page. One way is to use help2man, which is probably the Debian's
> approach. Another way is to write the man page in pod (perl's plain old
> documentation) and use pod2man to translate it into a man page. Would
> you accept any of these approaches?

I think Kenton is referring to the Debian manual, which is in XML
format:

https://github.com/thomaslee/capnproto-debian/blob/master/debian/capnp.1.xml

But you are right, it would be better to convert it to a standard format
and simply add a make target for it.

Cheers,
Marius