<div dir="ltr"><div class="gmail_extra">Hi Moritz,<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, May 12, 2016 at 3:26 AM, Moritz Lennert <span dir="ltr"><<a href="mailto:mlennert@club.worldonline.be" target="_blank">mlennert@club.worldonline.be</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div id=":l4" class="">Trying to understand how some of the code in the wxGUI works, I'm confronted with the absence of documentation of the wxGUI code.</div></blockquote><div><br></div><div>Please, feel free to ask on mailing list if something is unclear.<br> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div id=":l4" class="">Yes, there are docstrings in the code, but what is lacking is a programmer's manual that describes the general logic and gives a more precise overview of what is done in the different files and classes.<br>
<br>
Is there anything like this out there ?<br></div></blockquote><div><br>Yes:<br><br>cd grass/source/code<br>make sphinxdoc<br><br><div class="gmail_extra">I'm
 not sure if it is compiled to the online docs. But there is a good 
reason it should not. It is not guaranteed API (unfortunately!), so only
 people who know it and are prepared to make changes as need should use 
it (perhaps we should discuss and officially state the policy). For 
programming of GUI itself, you can compile it yourself, although it is 
less convenient.<br><br></div><div class="gmail_extra">There is also:<br><br><a href="https://grasswiki.osgeo.org/wiki/WxGUI_Programming_Howto">https://grasswiki.osgeo.org/wiki/WxGUI_Programming_Howto</a><br><br></div><div class="gmail_extra">which should be probably moved to Trac or the documentation itself.<br></div><div class="gmail_extra"><br></div></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div id=":l4" class="">
<br>
Otherwise this might be a worthwhile goal for a code sprint...<br></div></blockquote><div><br></div><div>Great! It definitively needs improvement.<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div id=":l4" class="">
<br>
I know that some would like to move the whole GUI to qt, but even so,</div></blockquote><div><br></div><div>Let's not have this discussion in this thread but the replacement is not happening just yet, so there is no reason to stop working on the current GUI. Please see the log for gui/wxpython:<br><br><a href="https://trac.osgeo.org/grass/log/grass/trunk/gui/wxpython?&rev=68424&limit=100">https://trac.osgeo.org/grass/log/grass/trunk/gui/wxpython?&rev=68424&limit=100</a><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div id=":l4" class="">documenting the wxgui code might help in constructing a new GUI as well.</div></blockquote></div><br></div><div class="gmail_extra">Sure.<br><br></div><div class="gmail_extra">Best,<br></div><div class="gmail_extra">Vaclav<br></div></div>