From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mathieu Lirzin Subject: Re: Texinfo in descriptions? Date: Thu, 23 Jul 2015 11:49:03 +0200 Message-ID: <87vbdb6w6o.fsf@openmailbox.org> References: <87wpy0nygt.fsf@gmail.com> <87y4ige2ux.fsf@openmailbox.org> <87wpy0t83c.fsf@gnu.org> <87r3o7pz3h.fsf@openmailbox.org> <87y4ietrdz.fsf_-_@gnu.org> <874mkx8a5o.fsf@openmailbox.org> <87wpxs9ux0.fsf@gnu.org> <87h9ov51j9.fsf@gnu.org> <20150722220825.GA8182@debian> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:55086) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZID9f-0000hr-Cl for guix-devel@gnu.org; Thu, 23 Jul 2015 05:51:08 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZID9b-0000cp-Bu for guix-devel@gnu.org; Thu, 23 Jul 2015 05:51:07 -0400 In-Reply-To: <20150722220825.GA8182@debian> (Andreas Enge's message of "Thu, 23 Jul 2015 00:08:25 +0200") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: Andreas Enge Cc: guix-devel@gnu.org, Alex Kost Andreas Enge writes: > On Wed, Jul 22, 2015 at 11:24:10PM +0200, Ludovic Court=C3=A8s wrote: >> With Benno being OK, we should start looking at implementing the change. Good news! I'm interested in implementing this change. I can't dedicate my time to do this right now, but I can do it within a period of one month. If someone is willing to do the work sooner, I have no problem with that. > Is there a consensus on the usefulness of the change? So far (but this may > be a classical case of confirmation bias) I noticed mainly voices against > the use of markup or at least with moderated enthusiasm. I agree with you that there is room for discussion. IMO Texinfo markup is a good compromise between using HTML or ASCII. It is lightweight enough to not be intrusive, and It is not specific to Guix. I think the last point is important because choosing texinfo means we have a full documentation to which we can refer, plus an already implemented Guile module for text manipulation. Eventually using texinfo participate in the unity of the GNU project. At least my enthusiasm cannot be described as moderated now ;). My concerns were about translation issues but since we got the green light from Benno, I am totally OK with the choice of texinfo. -- Mathieu Lirzin