File 0627-Add-dbg-function-name-meanings-to-docs.patch of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 0627-Add-dbg-function-name-meanings-to-docs.patch of Package erlang

From 5c254dfe0cc01ab8ec55b4f3708eb5b292290969 Mon Sep 17 00:00:00 2001
From: Trevor Brown <admin@stratus3d.com>
Date: Thu, 12 Aug 2021 20:21:58 -0400
Subject: [PATCH] Add dbg function name meanings to docs

Explain the meaning of acronym function names in dbg module

See http://erlang.org/pipermail/erlang-questions/2021-August/101275.html for context
---
 lib/runtime_tools/doc/src/dbg.xml | 55 +++++++++++++++++++------------
 1 file changed, 34 insertions(+), 21 deletions(-)

diff --git a/lib/runtime_tools/doc/src/dbg.xml b/lib/runtime_tools/doc/src/dbg.xml
index 168e89b7f0..2e1841b5c5 100644
--- a/lib/runtime_tools/doc/src/dbg.xml
+++ b/lib/runtime_tools/doc/src/dbg.xml
@@ -148,7 +148,7 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <name since="">h() -> ok </name>
 <fsummary>Give a list of available help items on standard output.</fsummary>
 <desc>
- Gives a list of items for brief online help.
+ <c>h</c> stands for help. Gives a list of items for brief online help. 
 </desc>
 </func>
 <func>
@@ -158,8 +158,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>Item = atom()</v>
 </type>
 <desc>
- Gives a brief help text for functions in the dbg module. The
- available items can be listed with <c>dbg:h/0</c>
+ <c>h</c> stands for help. Gives a brief help text for functions in the dbg module. The
+ available items can be listed with <c>dbg:h/0</c>.
 </desc>
 </func>
 <func>
@@ -178,7 +178,7 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>RPCError = term()</v>
 </type>
 <desc>
- Traces <c>Item</c> in accordance to the value specified
+ <c>p</c> stands for process. Traces <c>Item</c> in accordance to the value specified
 by <c>Flags</c>. The variation of <c>Item</c> is listed below:
 <taglist>
 <tag><c>pid()</c> or <c>port()</c></tag>
@@ -313,7 +313,7 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <name since="">c(Mod, Fun, Args, Flags)</name>
 <fsummary>Evaluate <c>apply(M,F,Args)</c>with <c>Flags</c>trace flags set.</fsummary>
 <desc>
- Evaluates the expression <c>apply(Mod, Fun, Args)</c> with the trace
+ <c>c</c> stands for call. Evaluates the expression <c>apply(Mod, Fun, Args)</c> with the trace
 flags in <c>Flags</c> set. This is a convenient way to trace processes 
 from the Erlang shell.
 </desc>
@@ -322,7 +322,7 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <name since="">i() -> ok</name>
 <fsummary>Display information about all traced processes and ports.</fsummary>
 <desc>
- Displays information about all traced processes and ports.
+ <c>i</c> stands for information. Displays information about all traced processes and ports.
 </desc>
 </func>
 <func>
@@ -360,7 +360,7 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>MatchNum = {matched, node(), integer()} | {matched, node(), 0, RPCError}</v>
 </type>
 <desc>
- This function enables call trace for one or more
+ <c>tp</c> stands for trace pattern. This function enables call trace for one or more
 functions. All exported functions matching the <c>{Module, Function, Arity}</c>
 argument will be concerned, but the
 <c>match_spec()</c> may further narrow down the set of function
@@ -434,7 +434,7 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <name since="">tpl({Module, Function, Arity}, MatchSpec) -> {ok, MatchDesc} | {error, term()}</name>
 <fsummary>Set pattern for traced local (as well as global) function calls</fsummary>
 <desc>
- This function works as <seemfa marker="#tp/2"><c>tp/2</c></seemfa>, but enables
+ <c>tpl</c> stands for trace pattern local. This function works as <seemfa marker="#tp/2"><c>tp/2</c></seemfa>, but enables
 tracing for local calls (and local functions) as well as for
 global calls (and functions).
 </desc>
@@ -453,7 +453,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>MatchNum = {matched, node(), 1} | {matched, node(), 0, RPCError}</v>
 </type>
 <desc>
- This function associates a match specification with trace event
+ <c>tpe</c> stands for trace pattern event.
+ This function associates a match specification with trace event
 	 <c>send</c> or <c>'receive'</c>. By default all executed <c>send</c>
 	 and <c>'receive'</c> events are traced if enabled for a process.
 	 A match specification can be used to filter traced events
@@ -522,7 +523,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>MatchNum = {matched, node(), integer()} | {matched, node(), 0, RPCError}</v>
 </type>
 <desc>
- This function disables call tracing on the specified
+ <c>ctp</c> stands for clear trace pattern.
+ This function disables call tracing on the specified
 functions. The semantics of the parameter is the same
 as for the corresponding function specification in
 <seemfa marker="#tp/2"><c>tp/2</c></seemfa> or <seemfa marker="#tpl/2"><c>tpl/2</c></seemfa>. Both local and global call trace
@@ -564,7 +566,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <name since="">ctpl({Module, Function, Arity}) -> {ok, MatchDesc} | {error, term()}</name>
 <fsummary>Clear call trace pattern for the specified functions</fsummary>
 <desc>
- This function works as <seemfa marker="#ctp/1"><c>ctp/1</c></seemfa>, but only disables
+ <c>ctpl</c> stands for clear trace pattern local.
+ This function works as <seemfa marker="#ctp/1"><c>ctp/1</c></seemfa>, but only disables
 tracing set up with <seemfa marker="#tpl/2"><c>tpl/2</c></seemfa>
 (not with <seemfa marker="#tp/2"><c>tp/2</c></seemfa>).
 </desc>
@@ -601,7 +604,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <name since="">ctpg({Module, Function, Arity}) -> {ok, MatchDesc} | {error, term()}</name>
 <fsummary>Clear call trace pattern for the specified functions</fsummary>
 <desc>
- This function works as <seemfa marker="#ctp/1"><c>ctp/1</c></seemfa>, but only disables
+ <c>ctpg</c> stands for clear trace pattern global.
+ This function works as <seemfa marker="#ctp/1"><c>ctp/1</c></seemfa>, but only disables
 tracing set up with <seemfa marker="#tp/2"><c>tp/2</c></seemfa>
 (not with <seemfa marker="#tpl/2"><c>tpl/2</c></seemfa>).
 </desc>
@@ -615,7 +619,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>MatchNum = {matched, node(), 1} | {matched, node(), 0, RPCError}</v>
 </type>
 <desc>
- This function clears match specifications for the specified
+ <c>ctpe</c> stands for clear trace pattern event.
+ This function clears match specifications for the specified
 	 trace event (<c>send</c> or <c>'receive'</c>). It will revert back
 	 to the default behavior of tracing all triggered events.
 The return value follow the same style as for
@@ -626,7 +631,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <name since="">ltp() -> ok</name>
 <fsummary>List saved and built-in match specifications on the console.</fsummary>
 <desc>
- Use this function to recall all match specifications previously
+ <c>ltp</c> stands for list trace patterns.
+ Use this function to recall all match specifications previously
 used in the session (i. e. previously saved during calls
 to <seemfa marker="#tp/2"><c>tp/2</c></seemfa>, and built-in match specifications.
 This is very useful, as a complicated
@@ -657,7 +663,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <name since="">dtp() -> ok</name>
 <fsummary>Delete all saved match specifications.</fsummary>
 <desc>
- Use this function to "forget" all match specifications
+ <c>dtp</c> stands for delete trace patterns.
+ Use this function to "forget" all match specifications
 saved during calls to <seemfa marker="#tp/2"><c>tp/2</c></seemfa>.
 This is useful when one wants to restore other match
 specifications from a file with <seemfa marker="#rtp/1"><c>rtp/1</c></seemfa>. Use
@@ -671,7 +678,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>N = integer()</v>
 </type>
 <desc>
- Use this function to "forget" a specific match specification
+ <c>dtp</c> stands for delete trace pattern.
+ Use this function to "forget" a specific match specification
 saved during calls to <seemfa marker="#tp/2"><c>tp/2</c></seemfa>.
 </desc>
 </func>
@@ -683,7 +691,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>IOError = term()</v>
 </type>
 <desc>
- This function will save all match specifications saved
+ <c>wtp</c> stands for write trace patterns.
+ This function will save all match specifications saved
 during the session (during calls to <seemfa marker="#tp/2"><c>tp/2</c></seemfa>)
 and built-in match specifications in a text
 file with the name designated by <c>Name</c>. The format
@@ -706,7 +715,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>Error = term()</v>
 </type>
 <desc>
- This function reads match specifications from a file
+ <c>rtp</c> stands for read trace patterns.
+ This function reads match specifications from a file
 (possibly) generated by the <seemfa marker="#wtp/1"><c>wtp/1</c></seemfa>
 function. It checks
 the syntax of all match specifications and verifies that
@@ -735,7 +745,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>Reason = term()</v>
 </type>
 <desc>
- The <c>dbg</c> server keeps a list of nodes where tracing
+ <c>n</c> stands for node.
+ The <c>dbg</c> server keeps a list of nodes where tracing
 should be performed. Whenever a <seemfa marker="#tp/2"><c>tp/2</c></seemfa> call or a
 <seemfa marker="#p/2"><c>p/2</c></seemfa> call is made, it is executed for all nodes in this
 list including the local node (except for <seemfa marker="#p/2"><c>p/2</c></seemfa> with a
@@ -773,7 +784,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <v>Nodename = atom()</v>
 </type>
 <desc>
- Clears a node from the list of traced nodes. Subsequent
+ <c>cn</c> stands for clear node.
+ Clears a node from the list of traced nodes. Subsequent
 calls to <seemfa marker="#tp/2"><c>tp/2</c></seemfa> and
 <seemfa marker="#p/2"><c>p/2</c></seemfa> will not consider that
 node, but tracing already activated on the node will continue
@@ -785,7 +797,8 @@ Error: fun containing local erlang function calls ('is_atomm' called in guard)\
 <name since="">ln() -> ok</name>
 <fsummary>Show the list of traced nodes on the console.</fsummary>
 <desc>
- Shows the list of traced nodes on the console.
+ <c>ln</c> stands for list nodes.
+ Shows the list of traced nodes on the console.
 </desc>
 </func>
 <func>
-- 
2.31.1

Places

File 0627-Add-dbg-function-name-meanings-to-docs.patch of Package erlang

Places