<div dir="ltr"><div>Would it make sense to also consider adding "long names" to the API, possibly deprecating the short one over time ?</div><div><br></div><div><div><div><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div>Thomas Depierre</div></div></div></div><br></div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, 10 Aug 2021 at 08:58, Lukas Larsson <<a href="mailto:lukas@erlang.org">lukas@erlang.org</a>> wrote:<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"><div>Hello!</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, Aug 8, 2021 at 8:42 AM Trevor Brown <<a href="mailto:admin@stratus3d.com" target="_blank">admin@stratus3d.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi, I've used the dbg module a fair bit over the years, and I am curious<br>
about the names of the functions. Looking at the list of functions, I<br>
came up with what I think each function name means:<br>
<br>
The function names are all acronyms (except for the ones that clearly<br>
aren't like `get_tracer/0` and `stop/0`) and stand for the following:<br>
<br>
* `c` stands for *c*lear<br></blockquote><div><br></div><div>I believe that the solitary `c` stands for *c*all.</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">
* `cn` stands for *c*lear *n*ode<br>
* `ctp` stands for *c*lear *t*race *p*attern<br>
* `ctpe` stands for *c*lear *t*race *p*attern *e*vent<br>
* `ctpg` stands for *c*lear *t*race *p*attern *g*lobal<br>
* `ctpl` stands for *c*lear *t*race *p*attern *l*ocal<br>
* `dtp` stands for *d*elete *t*race *p*attern (not sure if it's delete,<br>
drop, discard, etc...)<br></blockquote><div><br></div><div>If you type "dbg:h(dtp)" it prints: </div><div><br></div><div>dtp() -> ok<br> - Deletes all saved match_spec's.<br>dtp(N) -> ok<br> - Deletes a specific saved match_spec.<br></div><div><br></div><div>So it is `delete`, just as you guessed.</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">
* `wtp` stands for *w*rite *t*race *p*attern<br>
* `rtp` stands for *r*ead *t*race *p*attern<br>
* `n` stands for *n*ode<br>
* `i` stands for *i*nformation<br>
* `p` stands for *p*rocess<br>
* `tp` stands for *t*race *p*attern (implicitly global)<br>
* `tpl` stands for *t*race *p*attern *l*ocal<br>
* `h` stands for *h*elp<br>
* `ln` stands for *l*ist *n*odes<br>
* `ltp` stands for *l*ist *t*race *p*atterns<br>
<br>
Can anyone confirm if I am correct here? And if so, reference any docs<br>
explaining this? I personally find that understanding the acronyms makes<br>
the functions easier to remember, so it's a shame the official docs<br>
don't explain this if I am correct.<br></blockquote><div><br></div><div>I use the same words to describe the acronyms as you have done. I believe the person that designed the dbg API has left the Erlang world for the time being, so if we are incorrect we may never know.</div><div><br></div><div>If you want to create a PR that adds the names that you have proposed into the documentation I think that it could be a good starting point in making the words behind the acronyms official.</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
Also, I've always assumed the module name stood for debug, but is that<br>
true? I haven't found any docs on that either.<br></blockquote><div><br></div><div>I believe that you are correct, but I do not know for sure.</div></div></div>
</blockquote></div>