On 12/11/2015 11:02 AM, Russell Bryant wrote: > On 12/10/2015 09:13 PM, Justin Pettit wrote: >> >>> On Dec 10, 2015, at 9:49 AM, Russell Bryant <russ...@ovn.org> wrote: >>> >>> It looks like xml.dom.minidom doesn't support it. We'd have to manually >>> implement the interpretation of xi:include. That might be OK for our >>> limited usage since we only care about href="" to a local file and not >>> the full set of possible uses of xi:include. >>> >>> Otherwise, we'd have to switch to another XML parser. lxml supports it, >>> but that'd be an external dependency, so I'd rather avoid it. From >>> searching around it seems like xml.etree.ElementTree/ElementInclude from >>> the Python stdlib is supposed to support this, but I haven't gotten it >>> to work yet locally. >> >> This is something I've had on my to-do list for a while. If you can >> figure out a solution, that would be great, since there's quite a bit >> of information that needs to be copied between man pages. We use >> that extensively in our nroff man pages. In fact, if we had that and >> a way to include build-time definitions such as the @RUNDIR@ and >> @VERSION@, then I think we could replace all our nroff man pages with >> XML. > > Sure, that all seems doable. > > Wei Li, are you working on this? I'm happy to work on adding these > things to xml2nroff if not. >
To answer my own question, yes, the xi:include support is being added here: https://github.com/openvswitch/ovs/pull/93 Once xi:include support is done, we can switch to a .xml.in file for places where we need to substitute build-time info like @RUNDIR_ and @VERSION@. -- Russell Bryant _______________________________________________ dev mailing list dev@openvswitch.org http://openvswitch.org/mailman/listinfo/dev
