<div dir="ltr">> In particular, please don't include any GUI dialog messages<div><br></div><div>which are they all?</div><div><br></div><div>anyway, I felt I was crossing a line, hence I'm waving here to the judges :) </div><div><br></div><div>For instance, [namecanvas] did include a 'msg' message to canvas. I count that as a modest dynamic patch documentation.</div><div><br></div><div>Also, many of us use and abuse these for ages now... what if the documentation also gives us a "heads up", some "warning" that this is unstable and should be used assuming risks? This would be better than just having people check for this kind of documentation in Pd-extended or something and worse stuff.</div><div><br></div><div>But I see this might needs lots of debates, and as soon as I have more input I can revise and move this to a github discussion and a parallel PR.</div><div><br></div><div>thanks</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Em sex., 26 de nov. de 2021 às 17:18, Christof Ressi <<a href="mailto:info@christofressi.com">info@christofressi.com</a>> escreveu:<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>
<p>I think there are definitely many "official" messages (e.g.
"dsp", "fast-forward", "quit", etc.) that need to be documented
properly, so in principle I very much welcome this effort.</p>
<p>However, I'm rather sceptical about including any "dynamic
patching" messages in the official documentation as they are not
officially supported. I think it would be better to exclude this
from the main PR
(<a href="https://github.com/pure-data/pure-data/pull/1455" target="_blank">https://github.com/pure-data/pure-data/pull/1455</a>) and only offer
this as a secondary PR (that you can rebase regularly on top of
the other one).</p>
<p>In particular, please don't include any GUI dialog messages.
Those are really internal. Also, don't advertize "coords" (at
least you didn't mention "donecanvasdialog") because that one
should really be replaced by
<a href="https://github.com/pure-data/pure-data/pull/627" target="_blank">https://github.com/pure-data/pure-data/pull/627</a> (hopefully in the
next Pd release :-)<br>
</p>
<p>I think including dynamic patching would "taint" your otherwise
great documentation updates.<br>
</p>
<p>Christof<br>
</p>
<div>On 26.11.2021 21:05, Alexandre Torres
Porres wrote:<br>
</div>
<blockquote type="cite">
<div dir="ltr">the reason I ask for revisions here is that I'm not
an expert on this dark magic, so I'm not 100% sure about things.
I can revert the commit in the PR and keep it on the fridge for
the next release update if the real wizards see problems on it.</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">Em sex., 26 de nov. de 2021 às
16:59, Alexandre Torres Porres <<a href="mailto:porres@gmail.com" target="_blank">porres@gmail.com</a>>
escreveu:<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 dir="ltr">I could just send the main Patch, but it just
works best if you have all of the current state of the
reference folder and also check other changes I'm proposing
in this PR, so see attachment of the whole thing.
<div><br>
</div>
<div>I got a rather broken keyboard, so I must be generating
more typos than usual. Will need to revise it!</div>
<div><br>
</div>
<div>note that [Pd-messages] gets called in the help files
of [send-receive], 'message boxes' and [namecanvas], all
of them have been rewritten as well.</div>
<div><br>
</div>
<div>cheers</div>
<div><br>
</div>
<div><br>
</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">Em sex., 26 de nov. de
2021 às 16:55, Alexandre Torres Porres <<a href="mailto:porres@gmail.com" target="_blank">porres@gmail.com</a>>
escreveu:<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 dir="ltr">People, I'm on a roll here, updating much
of the help files and documentation.
<div><br>
</div>
<div>I just hit an important new addition, documenting
"Messages to/from Pd" and "Dynamic Patching"</div>
<div><br>
</div>
<div>I'd like you people to revise it.</div>
<div><br>
</div>
<div>Here's the commit => <a href="https://github.com/pure-data/pure-data/pull/1455/commits/0ec5429629eb1045c901ab9c74befd124ccb6e69" target="_blank">https://github.com/pure-data/pure-data/pull/1455/commits/0ec5429629eb1045c901ab9c74befd124ccb6e69</a></div>
<div><br>
</div>
<div>already in an open PR</div>
<div><br>
</div>
<div>Cheers</div>
</div>
</blockquote>
</div>
</blockquote>
</div>
<br>
<fieldset></fieldset>
<pre>_______________________________________________
<a href="mailto:Pd-list@lists.iem.at" target="_blank">Pd-list@lists.iem.at</a> mailing list
UNSUBSCRIBE and account-management -> <a href="https://lists.puredata.info/listinfo/pd-list" target="_blank">https://lists.puredata.info/listinfo/pd-list</a>
</pre>
</blockquote>
</div>
_______________________________________________<br>
<a href="mailto:Pd-list@lists.iem.at" target="_blank">Pd-list@lists.iem.at</a> mailing list<br>
UNSUBSCRIBE and account-management -> <a href="https://lists.puredata.info/listinfo/pd-list" rel="noreferrer" target="_blank">https://lists.puredata.info/listinfo/pd-list</a><br>
</blockquote></div>