<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>I am working on a pull request now to add this information to the
docs and possibly dbg:h/0.</p>
<p>Even if we aren't completely correct on the meaning of the
acronyms, I think explaining them in the docs will help make the
API less esoteric. I came across someone who didn't know what the
tpl function name stood for and assumed it meant tuple. That's one
of the things that prompted me to look into this.</p>
<p>Trevor<br>
</p>
<div class="moz-cite-prefix">On 8/10/21 2:58 AM, Lukas Larsson
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CAP3zBqPkEMYT4QG_mgvtz7-b+fFS2NV7aq_64wU0FTTUHOn8Gw@mail.gmail.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<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"
moz-do-not-send="true">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>
</body>
</html>