From aaf8e77cb1d74a373a1f8d2c09e0c13cbfc115ab Mon Sep 17 00:00:00 2001 From: Zoltan Somogyi Date: Wed, 2 Jul 2025 12:19:45 +0200 Subject: [PATCH] Fix a persistent spelling error. s/descendent/descendant/ --- doc/user_guide.texi | 22 +++++++++++----------- profiler/output.m | 16 ++++++++-------- 2 files changed, 19 insertions(+), 19 deletions(-) diff --git a/doc/user_guide.texi b/doc/user_guide.texi index 96985ed29..145e09137 100644 --- a/doc/user_guide.texi +++ b/doc/user_guide.texi @@ -4892,7 +4892,7 @@ questions about the correctness of calls executed in your program. Because pure Mercury code does not have any side effects, the declarative debugger can make inferences such as ``if a call produces incorrect output from correct input, then there must be a bug in the code executed by one of -the descendents of the call''. +the descendants of the call''. The declarative debugger is therefore able to automate much of the `detective work' that must be done manually when using the @@ -6061,12 +6061,12 @@ For each procedure it shows the parents (callers) and children (callees) of that procedure, and shows the execution time and call counts for each parent and child. It is sorted on the total amount of time spent -in the procedure and all of its descendents +in the procedure and all of its descendants (i.e.@: all of the procedures that it calls, directly or indirectly.) @cindex Flat profile The flat profile presents the just execution time spent in each procedure. -It does not count the time spent in descendents of a procedure. +It does not count the time spent in descendants of a procedure. The alphabetic listing just lists the procedures in alphabetical order, along with their index number in the call graph profile, @@ -6086,7 +6086,7 @@ that calls to a procedure from different callers have roughly similar costs is not true, the graph profile can be quite misleading. -The time spent in a procedure and its descendents is calculated by +The time spent in a procedure and its descendants is calculated by propagating the times up the call graph, assuming that each call to a procedure from a particular caller takes the same amount of time. @@ -6105,7 +6105,7 @@ Here is a small portion of the call graph profile from an example program. @example called/total parents -index %time self descendents called+self name index +index %time self descendants called+self name index called/total children @@ -6197,7 +6197,7 @@ a particular entry in the call graph.) @item The percentage of total execution time spent in the current procedure -and all its descendents. +and all its descendants. As noted above, this is only a statistical approximation. @item @@ -6206,8 +6206,8 @@ part of current procedure. As noted above, this is only a statistical approximation. @item -The descendent time: the time spent in the -current procedure and all its descendents. +The descendant time: the time spent in the +current procedure and all its descendants. As noted above, this is only a statistical approximation. @item @@ -6227,9 +6227,9 @@ declaration of that predicate in the source code. For example, @samp{list.delete/3(3)} corresponds to the @samp{(out, out, in)} mode of @samp{list.delete/3}. -Now for the parent and child procedures the self and descendent time have -slightly different meanings. For the parent procedures the self and descendent -time represent the proportion of the current procedure's self and descendent +Now for the parent and child procedures the self and descendant time have +slightly different meanings. For the parent procedures the self and descendant +time represent the proportion of the current procedure's self and descendant time due to that parent. These times are obtained using the assumption that each call contributes equally to the total time of the current procedure. diff --git a/profiler/output.m b/profiler/output.m index 13dd715c9..67e58fddb 100644 --- a/profiler/output.m +++ b/profiler/output.m @@ -126,7 +126,7 @@ output_call_graph_headers(OutputStream, !IO) :- "\t\tthe program %s this procedure and its\n", [s(SpentIn)], !IO), io.write_string(OutputStream, - "\t\tdescendents.\n\n", !IO), + "\t\tdescendants.\n\n", !IO), io.format(OutputStream, "self\t\tthe number of %s actually %s\n", @@ -135,10 +135,10 @@ output_call_graph_headers(OutputStream, !IO) :- "\t\tthe procedure's own code.\n\n", !IO), io.format(OutputStream, - "descendents\tthe number of %s %s the\n", + "descendants\tthe number of %s %s the\n", [s(Units), s(SpentIn)], !IO), io.write_string(OutputStream, - "\t\tdescendents of the current procedure.\n\n", !IO), + "\t\tdescendants of the current procedure.\n\n", !IO), io.write_string(OutputStream, "called\t\tthe number of times the current procedure is\n", !IO), @@ -165,8 +165,8 @@ output_call_graph_headers(OutputStream, !IO) :- "\t\t%s due to calls from this parent.\n\n", [s(What)], !IO), io.format(OutputStream, - "descendents*\tthe number of %s of the current " ++ - "procedure's descendent\n", [s(Units)], !IO), + "descendants*\tthe number of %s of the current " ++ + "procedure's descendant\n", [s(Units)], !IO), io.format(OutputStream, "\t\t%s which is due to calls from this parent.\n\n", [s(What)], !IO), @@ -196,7 +196,7 @@ output_call_graph_headers(OutputStream, !IO) :- "\t\tdue to being called by the current procedure.\n\n", !IO), io.format(OutputStream, - "descendent*\tthe number of %s of this child's descendent %s which\n", + "descendant*\tthe number of %s of this child's descendant %s which\n", [s(Units), s(What)], !IO), io.write_string(OutputStream, "\t\tis due to the current procedure.\n\n", !IO), @@ -222,7 +222,7 @@ output_call_graph_headers(OutputStream, !IO) :- io.write_string(OutputStream, " parents\n", !IO), io.format(OutputStream, - "index %6s self descendents called+self", + "index %6s self descendants called+self", [s("%" ++ ShortWhat)], !IO), io.write_string(OutputStream, " name index\n", !IO), @@ -423,7 +423,7 @@ output_flat_headers(OutputStream, !IO) :- "total\t\tthe average number of %s %s this procedure and its\n", [s(MilliUnits), s(SpentIn)], !IO), io.format(OutputStream, - "%s \tdescendents per call.\n\n", + "%s \tdescendants per call.\n\n", [s(MilliUnitsPerCall)], !IO), io.write_string(OutputStream,