Hi, I could not find any type of "source" (aka batmand-howto.odt in this case) of the batmand-howto written by Wesley Tsai and it seems to be partially outdated. Because of that I decided to do a conversation of the PDF to LaTeX so it can be changed more easily. It is quite rough at the moment, but I hope that their is some kind of interest in it. Current sources can be found at http://gitorious.org/projects/batmand-howto and Simon and Marek have write access to mainline.
Best regards, Sven
Hey Sven,
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?
Anyway, i'd upload the updated version of the howto as soon as you consider it ready. Just compiled it and it seems quite good from a quick look ... ;)
best regards, Simon
[1] http://gitorious.org/projects/batman-adv-doc
On Wed, Jan 21, 2009 at 09:36:00PM +0100, Sven Eckelmann wrote:
Hi, I could not find any type of "source" (aka batmand-howto.odt in this case) of the batmand-howto written by Wesley Tsai and it seems to be partially outdated. Because of that I decided to do a conversation of the PDF to LaTeX so it can be changed more easily. It is quite rough at the moment, but I hope that their is some kind of interest in it. Current sources can be found at http://gitorious.org/projects/batmand-howto and Simon and Marek have write access to mainline.
Best regards, Sven
B.A.T.M.A.N mailing list B.A.T.M.A.N@open-mesh.net https://lists.open-mesh.net/mm/listinfo/b.a.t.m.a.n
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
On Friday 23 January 2009 01:26:18 Sven Eckelmann wrote: [...]
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.
Ok, I asked him and he agreed.
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).
Pushed fix in a clone of your git repo and requested merge.
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).
Seems to be better now. xmlto with fo output +fop isn't that bad. Their are problems with images when you try to generate pdf directly but generating ps and then pdf works fine. I read that renderx xep works better, but it is a commercial tool.
Regards, Sven
On Fri, Jan 23, 2009 at 01:26:18AM +0100, Sven Eckelmann wrote:
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
It is merged now into batman-adv-doc. A little bit more work is still needed...
Best regards, Sven
b.a.t.m.a.n@lists.open-mesh.org
-
Simon Wunderlich -
Sven Eckelmann