From: Christopher Currie (Christopher_at_[hidden])
Date: 2004-02-05 13:16:04
Vladimir Prus wrote:
> I actually though that it would be nice to cleanly separate the docs into
> "User documentation", "Extender documentation" and "Developer" documentation,
> but the way you put the last two in appendix is quite fine with me. After all
> "User documentation" is the most important part there.
I like having them included, because they're short enough to serve as a
good appendix, and it gets more people to look at them.
> I also though it's probably better to split the xml source into smaller
> chunks, to ease editing. What do you think? In either case, this can be done
> only when structure is completely finalized?
This is trivial to do, we'll just leverage the same xinclude
functionality used by the main boost docs. It was simpler to do the
initial conversion as a single doc, because of the global
search-and-replace I was doing, but now that we're converted we can
split them up and deal with parts individually. I'll split them up by
chapters for now, and if the chapters are too large we can break it down
> BTW, what editor for XML do you use? I'm not really happy with emacs in this
Actually, I just use plain old vim, because it's lightweight (at least
in comparison), its syntax highlighting is (IMO) superior to (x)emacs,
and I feel I have better control over its tabbing behavior. But, I've
been using it for a while, and if you're not a vi person it's probably a
pain to use, as much as I feel that using lisp for a config file is a pain.
Boost-Build list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk