[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Artanis] Documentation Format, from texi to sxml

From: Nala Ginrut
Subject: Re: [Artanis] Documentation Format, from texi to sxml
Date: Mon, 02 Mar 2015 14:33:17 +0800

On Sun, 2015-03-01 at 05:13 -0600, Kyle Grieb wrote:
> I propose we write our documentation in sxml format, replacing the
> currently used texi format.
> I think this should be a community adopted standard for all documentation,
> I welcome references to discussions on this topic.

Actually, the original documentation is not in texi, it's org-mode[0],
since I'm Emacs big fans ;-P

It's texi in release because GNU requires all the documentations in texi
for generating different format docs (like pdf,info,html...). I just
exported org to texi. That's the story.

** Documentation:
    We require using Texinfo (
    for documentation, and recommend writing both reference and tutorial
    information in the same manual.  Please see

I don't reject sxml format, but I don't have time for that. It's great
if one can write org-mode plugins or any third-party program (I hope
someone write it in Scheme, but just hope) for exporting it. Keep using
org-mode is reasonable way to maintain our documentation. ;-)



GNU Powered it
GPL Protected it
GOD Blessed it

HFG - NalaGinrut

Fingerprint 77F8 7D5B B425 E505 535E  C365 9182 7E28 EE78 E925

Attachment: signature.asc
Description: This is a digitally signed message part

reply via email to

[Prev in Thread] Current Thread [Next in Thread]