From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <mark@klomp.org>
Received: from gnu.wildebeest.org (wildebeest.demon.nl [212.238.236.112])
 by sourceware.org (Postfix) with ESMTPS id A53413857C52
 for <gnu-gabi@sourceware.org>; Fri, 14 Aug 2020 15:17:52 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org A53413857C52
Authentication-Results: sourceware.org;
 dmarc=none (p=none dis=none) header.from=klomp.org
Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mark@klomp.org
Received: from tarox.wildebeest.org (tarox.wildebeest.org [172.31.17.39])
 (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by gnu.wildebeest.org (Postfix) with ESMTPSA id 25F35302BB21;
 Fri, 14 Aug 2020 17:17:50 +0200 (CEST)
Received: by tarox.wildebeest.org (Postfix, from userid 1000)
 id D10B74708672; Fri, 14 Aug 2020 17:17:50 +0200 (CEST)
Message-ID: <e0160519c7b27ae131675a1307acfe722eac2a29.camel@klomp.org>
Subject: Re: ABI document
From: Mark Wielaard <mark@klomp.org>
To: Vivek Das Mohapatra <vivek@collabora.com>
Cc: Florian Weimer <fweimer@redhat.com>, GNU gABI gnu-gabi
 <gnu-gabi@sourceware.org>
Date: Fri, 14 Aug 2020 17:17:50 +0200
In-Reply-To: <alpine.DEB.2.20.2008141232410.15075@noise.cbg.collabora.co.uk>
References: <87o8nypmpq.fsf@oldenburg2.str.redhat.com>
 <616c0f661732fd1021e5a5b13ef872927390004d.camel@klomp.org>
 <CAMe9rOqSexN8m6J4w3dYXvw4cW3iQzY+7vg5HKG47AcDp9S4Ug@mail.gmail.com>
 <87ime6pl2q.fsf@oldenburg2.str.redhat.com>
 <alpine.DEB.2.20.2008141047340.15075@noise.cbg.collabora.co.uk>
 <1597402688538.b66a61e7629438@mozgaia>
 <alpine.DEB.2.20.2008141232410.15075@noise.cbg.collabora.co.uk>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Mailer: Evolution 3.28.5 (3.28.5-8.el7) 
Mime-Version: 1.0
X-Spam-Status: No, score=-6.3 required=5.0 tests=BAYES_00, JMQ_SPF_NEUTRAL,
 KAM_DMARC_STATUS, SPF_HELO_NONE, SPF_PASS,
 TXREP autolearn=no autolearn_force=no version=3.4.2
X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on
 server2.sourceware.org
X-BeenThere: gnu-gabi@sourceware.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Gnu-gabi mailing list <gnu-gabi.sourceware.org>
List-Unsubscribe: <https://sourceware.org/mailman/options/gnu-gabi>,
 <mailto:gnu-gabi-request@sourceware.org?subject=unsubscribe>
List-Archive: <https://sourceware.org/pipermail/gnu-gabi/>
List-Help: <mailto:gnu-gabi-request@sourceware.org?subject=help>
List-Subscribe: <https://sourceware.org/mailman/listinfo/gnu-gabi>,
 <mailto:gnu-gabi-request@sourceware.org?subject=subscribe>
X-List-Received-Date: Fri, 14 Aug 2020 15:17:54 -0000

Hi,

On Fri, 2020-08-14 at 12:33 +0100, Vivek Das Mohapatra via Gnu-gabi
wrote:
> > The GNU Gabi now has a git backed website to document these things
> >=20
> > https://sourceware.org/gnu-gabi
>=20
> Nice: Any particular preferred format?

Lets stick to plain text for now. Just so we have something that can
simply be converted into anything. Best to start with content before
worrying about format IMHO.

There are some other gABI extensions that use LaTeX, so we could adopt
that to reuse some structure. But personally I would prefer some
simpler markup language like StructuredText (rst) or MarkDown (md). I
believe Cary was converting the actual gABI spec into MarkDown.

Cheers,

Mark