1 files changed, 69 insertions, 0 deletions
diff --git a/Examples/js_cputime_example.txt b/Examples/js_cputime_example.txt
new file mode 100644
index 000000000000..dff42fdca9fa
--- /dev/null
+++ b/Examples/js_cputime_example.txt
@@ -0,0 +1,69 @@
+The following are examples of js_cputime.d.
+
+This script traces the on-CPU time of JavaScript functions and prints a report. 
+Here it traces the example program, Code/JavaScript/func_clock.html
+
+# js_cputime.d
+Tracing... Hit Ctrl-C to end.
+^C
+
+Count,
+   FILE                 TYPE       NAME                                COUNT
+   func_clock.html      func       func_a                                  5
+   func_clock.html      func       func_b                                  5
+   func_clock.html      func       func_c                                  5
+   func_clock.html      func       setTimeout                              5
+   func_clock.html      func       start                                   5
+   func_clock.html      obj-new    Date                                    5
+   func_clock.html      func       getElementById                         20
+   -                    total      -                                      50
+
+Elapsed times (us),
+   FILE                 TYPE       NAME                                TOTAL
+   -                    total      -                                      37
+   func_clock.html      obj-new    Date                                   37
+
+Exclusive function on-CPU times (us),
+   FILE                 TYPE       NAME                                TOTAL
+   func_clock.html      func       setTimeout                            316
+   func_clock.html      func       getElementById                        588
+   func_clock.html      func       start                                4734
+   func_clock.html      func       func_a                              83465
+   func_clock.html      func       func_b                             166613
+   func_clock.html      func       func_c                             247683
+   -                    total      -                                  503402
+
+Inclusive function on-CPU times (us),
+   FILE                 TYPE       NAME                                TOTAL
+   func_clock.html      func       setTimeout                            316
+   func_clock.html      func       getElementById                        588
+   func_clock.html      func       func_c                             247872
+   func_clock.html      func       func_b                             414601
+   func_clock.html      func       func_a                             498142
+   func_clock.html      func       start                              503439
+
+You can see the results are printed in four sections.
+
+The first section reports how many times each subroutine was called, and it's
+type.
+
+The second section reports on the on-CPU time of anything that was not of type
+"func", in this case the only elements reported here are Date obj-new.
+
+The exclusive subroutine on-CPU times shows, amongst other results, that func_a 
+spent around 83,000 microseconds on-CPU.  This time excludes time spent in 
+other subroutines.
+
+The inclusive subroutine on-CPU times show that func_a spent around 0.5
+seconds on-CPU.  This includes the time spent in other subroutines
+called.
+
+These on-CPU times are the time the thread spent running on a CPU, from when
+the subroutine began to when it completed. This does not include time
+spent off-CPU time such as sleeping for I/O or waiting for scheduling.
+
+On-CPU times are useful for showing who is causing the CPUs to be busy.
+See Notes/ALLoncpu_notes.txt for more details. Also see
+Notes/ALLexclusive_notes.txt and Notes/ALLinclusive_notes.txt for a
+detailed explanation of exclusive vs inclusive subroutine time.
+