<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>Seth,</p>
<p>I believe you should just go ahead and merge. Impressive work!</p>
<p>Even<br>
</p>
<div class="moz-cite-prefix">Le 26/06/2021 à 12:08, Seth G a écrit :<br>
</div>
<blockquote type="cite"
cite="mid:230e3ece-e702-4857-a9f4-8e1cd944d097@www.fastmail.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title></title>
<style type="text/css">p.MsoNormal,p.MsoNoSpacing{margin:0}</style>
<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"
moz-do-not-send="true">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"
moz-do-not-send="true">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:<a class="moz-txt-link-freetext" href="http://geographika.co.uk">http://geographika.co.uk</a><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"
moz-do-not-send="true">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" moz-do-not-send="true">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" moz-do-not-send="true">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" moz-do-not-send="true">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" moz-do-not-send="true">mapserver-dev@lists.osgeo.org</a><br>
</div>
<div> <a
href="https://lists.osgeo.org/mailman/listinfo/mapserver-dev"
rel="noreferrer" target="_blank" moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/mapserver-dev</a><br>
</div>
</blockquote>
</div>
</blockquote>
<div><br>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
mapserver-dev mailing list
<a class="moz-txt-link-abbreviated" href="mailto:mapserver-dev@lists.osgeo.org">mapserver-dev@lists.osgeo.org</a>
<a class="moz-txt-link-freetext" href="https://lists.osgeo.org/mailman/listinfo/mapserver-dev">https://lists.osgeo.org/mailman/listinfo/mapserver-dev</a>
</pre>
</blockquote>
<pre class="moz-signature" cols="72">--
<a class="moz-txt-link-freetext" href="http://www.spatialys.com">http://www.spatialys.com</a>
My software is free, but my time generally not.</pre>
</body>
</html>