[36549] in Kerberos

home help back first fref pref prev next nref lref last post

Re: Switch kerberos man pages to Docbook?

daemon@ATHENA.MIT.EDU (Lionel Cons)
Tue Oct 14 18:20:54 2014

MIME-Version: 1.0
In-Reply-To: <5422D686.6080709@mit.edu>
Date: Wed, 15 Oct 2014 00:20:37 +0200
Message-ID: <CAPJSo4U8JdzQvu4gFxmZGdjQwN6msZeiQO+-XswSZ8r21gp9PQ@mail.gmail.com>
From: Lionel Cons <lionelcons1972@gmail.com>
To: Greg Hudson <ghudson@mit.edu>
Cc: kerberos@mit.edu
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: kerberos-bounces@mit.edu

On 24 September 2014 16:34, Greg Hudson <ghudson@mit.edu> wrote:
> On 09/24/2014 06:54 AM, Lionel Cons wrote:
>> Has anyone considered switching the source format for the kerberos man
>> pages from the current custom format over to Docbook/XML? It would
>> make tasks like translation (our main issue) or generation of troff,
>> PDF and PS output much easier and gives more formatting options like
>> embedding mathml/svg on demand.
>
> The current source format is not custom; restructured text is used by
> Python and many other projects (http://sphinx-doc.org/examples.html).

Well, its custom from the viewpoint that none of the professional
localization tools support it. Its basically all handcrafted with no
way to facilitate translation and its painful to update. That's why
we'd like to propose a switch to docbook/xml...

Lionel
________________________________________________
Kerberos mailing list           Kerberos@mit.edu
https://mailman.mit.edu/mailman/listinfo/kerberos

home help back first fref pref prev next nref lref last post