Page 1 of 2

Irrlicht Help File (Irrlicht.chm)

Posted: Sat Dec 20, 2008 2:35 am
by Acki
Hi,
what happened to the doc (Irrlicht.chm) !?!?! :shock:
it looks realy crappy now and it's hard to read...
the corrected doc: Irrlicht.chm

.chm for Irrlicht 1.4.2 (good):
Image

.chm for Irrlicht 1.5 (bad):
Image

Posted: Sat Dec 20, 2008 9:46 am
by GameDude
Your right, it does look bad, hopefully we can get it fixed

Posted: Sat Dec 20, 2008 1:47 pm
by MasterGod
I guess they've updated the doxygen version and those are the results..
They use a custom script file for doxygen that doesn't work right with newer versions of doxygen, I tried that myself.

P.S
I guess that's what happened..

Posted: Sat Dec 20, 2008 3:48 pm
by Acki
it seems the error is with the doxygen.css file !!!
if I remove it from the doxygen script the doc looks ok again, except of the header, so the header.html file must also get corrected (maybe footer.html also) !!! ;)

Posted: Sat Dec 20, 2008 5:14 pm
by Mirror
acki if you get a corrected version of the .chm could you possibly throw it this way ?

Posted: Sat Dec 20, 2008 6:40 pm
by Acki
here we go: Irrlicht.chm
I hope it's all fine with it now.. ;)

for those who have Doxygen (and of course for the devs): just remove the doxygen.css entry from the script and edit the header.html to adjust the colors of the header (the footer seems ok)... ;)

Posted: Sat Dec 20, 2008 6:47 pm
by GameDude
Thanks for the fixes to the docs

Posted: Sat Dec 20, 2008 8:18 pm
by wyrmmage
yes, thank you! :) I've been wondering for awhile what happened to the docs.

I've created a patch for the doxygen.css file that fixes the problem:

Code: Select all

Index: doxygen.css
===================================================================
--- doxygen.css	(revision 1981)
+++ doxygen.css	(working copy)
@@ -306,3 +306,9 @@
      border: none;
      border-top: 1px solid black;
 }
+
+table.memname
+{
+background-color: #f5f5f5;
+border: 1px solid #b0b0b0;
+}
the patch is for trunk.
-wyrmmage

Posted: Sun Dec 21, 2008 3:11 pm
by Acki
wyrmmage wrote:I've created a patch for the doxygen.css file that fixes the problem:
yes, it looks better now:
Image


but I still like it more if you just remove the doxygen.css file from the script (also against the old style) ;) :
Image

Posted: Sun Dec 21, 2008 5:53 pm
by joshcryer
Very cool Acki, thank you very much. :)

Posted: Sun Dec 21, 2008 6:28 pm
by MasterGod
It would be refreshing to see new doc style, even if so little is changed.

Posted: Sun Dec 21, 2008 9:05 pm
by Acki
hmm, I have a problem with the search function !!!!
the search function (3rd tab on the left) doesn't work !?!?! :shock:
what do I have to do to get it working ???

Posted: Sun Dec 21, 2008 10:17 pm
by Mirror
thanks acki!

Posted: Mon Dec 22, 2008 12:04 am
by Acki
Acki wrote:hmm, I have a problem with the search function !!!!
ok, solved, the search function now works again !!! 8)
it seems I had not installed HWS correctly... :oops:

Posted: Mon Dec 22, 2008 1:09 am
by wyrmmage
I'm curious what you did to fix the search problem? I can't search in my help file either :\

Removing the css file pretty much destroys the help file for me:
Image

Your image displaying my patch looks quite a bit different than when I apply the patch XD
Image

Finally, a question that perhaps one of the devs can answer: why doesn't the documentation build into trunk/doc instead of trunk/doctemp? :\ At the very least it seems like there should be a command in the batch or shell file copying the irrlicht.chm file from doctemp to doc :)

Oh, and Acki, what's HWS? :\
-wyrmmage