Re: New BoostBook user manual

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 
further.

> BTW, what editor for XML do you use? I'm not really happy with emacs in this 
> respect.

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.

Christopher