summaryrefslogtreecommitdiff
path: root/Development/Documentation/DocBookConversion.mdwn
blob: 0402471b801e93406781480bbfad425c537f853c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


## Tools

What is needed to convert troff documents from [[DocBook|DocBook]]: 

* [[DocLifter|DocLifter]] ([[+patches|http://lists.freedesktop.org/archives/xorg/2008-June/035967.html]]) 
* Time 
* Luck 

## To Do

List the document that have yet to be converted here. 

* [[XKB|XKB]] specs (xorg-docs/specs/XKB/Proto & xorg-docs/specs/XKB/XKBlib): these are in Frame``Maker format.   [[AlanCoopersmith|AlanCoopersmith]] used Frame``Maker's Export options to produce several more convertible formats from them: XML (with unknown DTD), HTML & MIF - available at [[http://people.freedesktop.org/~alanc/xkb/|http://people.freedesktop.org/~alanc/xkb/]] - but someone needs to finish converting to DocBook/XML. 

## Ongoing

There has been an interest in converting the parts of the Xorg documentation written in troff to [[DocBook|DocBook]] (or any other generic format).  In order not to duplicate efforts, here is the list of what is being done and by whom. 

* [[PeterHutterer|PeterHutterer]] has converted the XInput documentation to [[DocBook|DocBook]] 
* [[FrancoisDenisGonthier|FrancoisDenisGonthier]] and [[MichaelVerret|MichaelVerret]] are trying to convert from XProtocol from troff to [[DocBook|DocBook]] using doclifter. 
* [[GüntherBrammer|GüntherBrammer]] is converting documentation in the Xext directory.