<!DOCTYPE html><html><head><title></title><style type="text/css">p.MsoNormal,p.MsoNoSpacing{margin:0}</style></head><body><div>Hi all,<br></div><div><br></div><div>Any further comments/questions on MS RFC 132?<br></div><div><br></div><div>Even raised the question about the `<span class="blob-code-inner blob-code-marker-addition"><span class="pl-s1">nitpick` being set to False. This is due to the resolution of MapScript variable links, but these can be hidden in Sphinx 4.1 which I believe may be released soon (the mileston deadline was 2 weeks ago). Once we update to Sphinx 4.1 `nitpick` can be set back to True. </span></span><br></div><div><br></div><div><span class="blob-code-inner blob-code-marker-addition"><span class="pl-s1">The other major blocker is getting a pull request into SWIG so class property types are automatically documented.</span></span><br></div><div><a href="https://github.com/swig/swig/pull/1951">https://github.com/swig/swig/pull/1951</a> - I'll look again at fixing the tests and trying to get this merged. <br></div><div><span class="blob-code-inner blob-code-marker-addition"><span class="pl-s1">In the meantime to update the docs requires manually building MapScript with a custom SWIG and pushing to test.pypi.org</span></span><br></div><div><br></div><div><span class="blob-code-inner blob-code-marker-addition"><span class="pl-s1">The pull request in its current state does build the MapScript API docs automatically, and contains over 10 years of updates/corrections to the current MapScript docs so I'd like to merge this into main in the next couple of days if there are no objections.</span></span><br></div><div><br></div><div><span class="blob-code-inner blob-code-marker-addition"><span class="pl-s1">Once merged and the main branch is made to be the current release (8.0) the docs will appear as at: </span></span><a href="https://geographika.github.io/MapServer-documentation/mapscript/mapscript-api/index.html">https://geographika.github.io/MapServer-documentation/mapscript/mapscript-api/index.html</a><span class="blob-code-inner blob-code-marker-addition"><span class="pl-s1"></span></span></div><div><br></div><div><span class="blob-code-inner blob-code-marker-addition"><span class="pl-s1">Seth</span></span><br></div><div><br></div><div id="sig62266145"><div class="signature">--<br></div><div class="signature">web:http://geographika.co.uk<br></div><div class="signature">twitter: @geographika<br></div></div><div><br></div><div><br></div><div>On Tue, May 25, 2021, at 12:11 AM, Steve Lime wrote:<br></div><blockquote type="cite" id="qt" style=""><div dir="ltr">Woohoo! Congrats and thanks for taking on such a large chunk of work - two milestones in one day is pretty cool. --Steve<br></div><div><br></div><div class="qt-gmail_quote"><div dir="ltr" class="qt-gmail_attr">On Mon, May 24, 2021 at 8:38 AM Seth G <<a href="mailto:sethg@geographika.co.uk">sethg@geographika.co.uk</a>> wrote:<br></div><blockquote class="qt-gmail_quote" style="margin-top:0px;margin-right:0px;margin-bottom:0px;margin-left:0.8ex;border-left-color:rgb(204, 204, 204);border-left-style:solid;border-left-width:1px;padding-left:1ex;"><div>Hi all,<br></div><div> <br></div><div> I'm pleased to announce that the MapScript documentation generation, described in RFC132 [1] is now added to a pull request [2] ready for review. <br></div><div> <br></div><div> Features include:<br></div><div> <br></div><div> * Automatic stub generation based on the latest MapScript release. Keywords and functions.<br></div><div> * Any undocumented properties or functions has a TODO label added. The docs will always be up to date with the latest Python MapScript release<br></div><div> * Linking to Mapfile keywords to avoid duplication of docs (see Sphinx pull request)<br></div><div> * Linking to classes and functions available throughout docs, e.g. in HowTo and in the API docs themselves.<br></div><div> * Support for Python snippets from the Python test cases, ensuring examples continue to work with the latest codebase<br></div><div> * Set of Python scripts to update the list of available classes, constants, and enumerations, as well as class diagrams. These could also be set these to run automatically as part of the CI / docs build process<br></div><div> * Updates to the various MapScript HOWTO guides<br></div><div> <br></div><div> <br></div><div> Seth<br></div><div> <br></div><div> [1] <a href="https://mapserver.org/id/development/rfc/ms-rfc-132.html" rel="noreferrer" target="_blank">https://mapserver.org/id/development/rfc/ms-rfc-132.html</a><br></div><div> [2] <a href="https://github.com/MapServer/MapServer-documentation/pull/544" rel="noreferrer" target="_blank">https://github.com/MapServer/MapServer-documentation/pull/544</a><br></div><div> <br></div><div> --<br></div><div> web:<a href="http://geographika.co.uk" rel="noreferrer" target="_blank">http://geographika.co.uk</a><br></div><div> twitter: @geographika<br></div><div> _______________________________________________<br></div><div> mapserver-dev mailing list<br></div><div> <a href="mailto:mapserver-dev@lists.osgeo.org" target="_blank">mapserver-dev@lists.osgeo.org</a><br></div><div> <a href="https://lists.osgeo.org/mailman/listinfo/mapserver-dev" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/mapserver-dev</a><br></div></blockquote></div></blockquote><div><br></div></body></html>