<div dir="ltr"><div><br></div><br><div class="gmail_quote"><div dir="ltr">Le sam. 2 déc. 2017 à 08:22, Phil Thompson <<a href="mailto:phil@riverbankcomputing.com" target="_blank">phil@riverbankcomputing.com</a>> a écrit :<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On 2 Dec 2017, at 11:51 am, Denis Rouzaud <<a href="mailto:denis.rouzaud@gmail.com" target="_blank">denis.rouzaud@gmail.com</a>> wrote:<br>
><br>
> It doesn't integrate the signature because we provide our own docstrings from the c++ headers.<br>
><br>
> I was hoping for an automation of:<br>
> - getting the signature in the pythonic way<br>
> - getting all the overloaded methods listed<br>
<br>
First off, docstrings are different to documentation. The former are only generated for objects that actually *do* exist. The latter is generated for all objects that *might* exist. For example, you want documentation to include platform-specific APIs but docstrings can only include the current platform. You need to take that into account when deciding how you are going to automate the documentation.<br></blockquote><div><br></div><div>Thanks for the warning, that's something I did not pay attention to yet. I don't think there is a lot of concern here for our project, not sure though.</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Just considering the docstrings for now you could provide a patch to sip that make the %Docstring directive work the way you want. For example, add a "generated" option that could have values of either "before", "after" or "discard". The default value would be "discard" (to maintain compatibility).<br></blockquote><div><br></div><div>Hey, that would be awesome. Is that something you could achieve for us/me?</div><div>If fundings are needed, I could ask the project for some.</div><div>Let me know your thoughts.</div><div><br></div><div>Cheers,</div><div>Denis </div></div></div>