Messages in this thread | | | Date | Wed, 2 Aug 2000 10:20:49 -0400 | From | "Theodore Ts'o" <> | Subject | Re: linux kernel docs |
| |
From: "Copeland, Matthew" <Matthew.Copeland@Honeywell.com> Date: Tue, 1 Aug 2000 10:00:31 -0700
A good point. I had forgotten that this move was being made. My personal thought is that if we are going to be developing things new, then we should use the XML and just eat the learning curve, since we would have to do it at some point in the future anyway, we might as well all do it at once rather than each of us attempting a little bit at a time to convert one part of a set of documents later. It would also save us from having to convert later, so we can kind of think of it as an investment in the future.
Docbook XML may be more "future proof", but right now the open source tools for docbook are a complete disaster. (Has anyone actually looked at the documentation of Jade?!?) Linuxdoc may be politically incorrect these days, but its tools for processing it are far better than Docbook at the moment.
So before someone starts pushing Docbook yet again, could that person work to make the Docbook tools *better*, instead of just pushing the Format That Will Solve World Hunger on to hapless victims that have to suffer the horrors of Jade? (I will note that there *still* isn't a docbook to txt conversion Open Source solution, whereas linuxdoc has such a tool already.)
-Ted
- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.rutgers.edu Please read the FAQ at http://www.tux.org/lkml/
| |