On Friday 23 January 2009 00:10:28 Simon Wunderlich wrote:
thanks for your work, it'd be nice to keep the howto up to date. We might as well merge the howto with our ongoing documentation [1]. What do you (and the others) think?
Hm, sounds interesting, but I see different problems. First thing is the different copyright. You specified GPL2 for the batman(-adv) documentation and Wesley released his stuff as CC-by-nc-sa-3.0. These licenses aren't compatible in the way that you relicense his work under the GPL2 [2], but you can ask him if he relicenses his work. The second thing is that somebody has to rewrite it into XML Docbook. This isn't that bad but I will definitely not doing anything like that until somebody explained me why you are using a SGML Docbook tool to convert a XML docbook to your target format. When you try it on another distribution than debian etch/lenny you will propably receive an error (try for example one of our public accessible machines at tuc). And maybe somebody can answer the question what is the right way to do the conversation job? I found different references that their is/was some xsl stylesheet to convert them to pdf but I don't want to fiddle about xsltproc and different xsl paths on each plattform. I tried xmlto some time ago (small shell script which does all the xslt stuff for me), but the output was quite bad and it had problems with the images (hm, reminds me on the fact that the current way the images are handled inside batman-adv-doc is a hack too). The last thing is that the target audience is different. I don't think that mixing the two ideas together. Maybe it works when their would be * part 1 - batmand - algorithm, implementation, usage, ... * part 2 - batman-adv, differents in implementation, usage, ... ... or something completely different
Anyway, i'd upload the updated version of the howto as soon as you consider it ready.
Tell me how something could be ready which describes another object which hasn't reached a final state and probably never will. But I don't intend to change anything in the near future. Everything Wesley did is included, new informations are merged and images are scalable. So proceed further as you wish.
Best regards, Sven