GNOME Bugzilla – Bug 109882
CH2 of the Gtkmm book does not include Windows installation
Last modified: 2004-12-22 21:47:04 UTC
Chapter 2 of the Gtkmm book does not include installation instructions for the Windows platform. See: http://www.gtkmm.org/gtkmm2/docs/tutorial/html/ch02.html The windows installation instructions should probably describe how to install Gtkmm 2.x from the various binaries provided, rather than going into details of compiling sources. I'll try and have an initial patch for this by this weekend.
Gene, did you have a look at the modified xml file I sent you last week ? Do you think this win32 stuff should be included into the gtkmm book or should it be a separate file (like the FAQ) referenced from the gtkmm main index.html ? By the way, I think this bug should be reattributed to version 2.2 (instead of 2.0) of gtkmm.
DO try to post patches here rather than to each other. That stops things from getting lost.
Cedric, I did not recieve your e-mail. Would you please post it here so that I can add my changes and submit a final patch this weekend? Thank You!
Here is the file, with both your contribution and the text from the README.win32 file. It's a standalone file but it could easily be included into the gtkmm book, although I think the win32 platform deserves its own file where all win32-related notes/problems/FAQs could be included. But of course; it's just my two cents...
Created attachment 15490 [details] gtkmm-win32.xml first draft.
I'm okay with having a separate book/chapter for Gtkmm on Win32. We should probably create a link from the FAQ and the Tutorial to the separate book however.
Thanks. I think this should be an appendix in the main book. The main installation chapter should have a Windows section with a brief description and a link to the appendix. We should say "we can recommend Dev-C++" rather than "Dev-C++ is the recommended IDE for gtkmm". Also, it's not called "Dev-Cpp". Please submit it as another patch here rather than committing it directly so I can check the english is perfect as a native speaker.
Should I expect another patch?
I'll try and have something by this weekend.. =)
Thanks.
Created attachment 16037 [details] [review] win32_doc.patch - win32 installation instruction appendix
Created attachment 16038 [details] figures.tar.gz - png image needed for above file (docs/tutorial/figures/devcpp_project_options.png)
Thanks. I'll try to process this ASAP.
Thanks. Applied, with corrections and removal of unnecessary stuff. Please see the TODOS and maybe submit an extra patch. Also, the building-gtkmm stuff should be in a README and not in 2 places, so maybe we can just remove it?
Cedric contributed the building gtkmm portion. Cedric, do you have any opinions on this?
I guess the easiest way would be to have the building stuff in the xml file, with the link to the html file explicitly stated in README.win32 (like 'see docs\tutorial\html\ape.htm' for details'). Same thing for the symbols/objects/methods currently not available on win32. The html doc is part of the source tarball anyway !
Why do the building-gtkmm-on-windows need to be in the book, wherease the building-on-solaris README does not? It's easier to update the README than the book, so I'd prefer for the book to say "See the README". Likewise, the no-exported stuff - that needs to be easy to update.
If the README.win32 stuff is correct, then I'm just going to remove all building-gtkmm stuff from the book.
README.win32 is correct. I will keep updating when required. And yes, feel free to remove the build section in the book.
I've removed it - will commit later.