1 --- ruby-1.8.7-p334/ruby.1 2007-02-12 15:01:19.000000000 -0800 |
|
2 +++ ruby-1.8.7-p334/../ruby.1 2008-02-28 03:00:23.255784000 -0800 |
|
3 @@ -104,8 +104,79 @@ |
|
4 .Ux |
|
5 systems, you can load object files into the Ruby interpreter |
|
6 on-the-fly. |
|
7 +.Pp |
|
8 +.It Sy "DTrace Probes" |
|
9 +Ruby has a set of DTrace probes that can be used to debug a running Ruby/Rails |
|
10 +application. NOTE: This is on x86/x64 platform only. |
|
11 +.Pp |
|
12 +.Nm function-entry |
|
13 +.Nd Probe that fires when a Ruby method is entered |
|
14 +.Pp |
|
15 +.Nm function-return |
|
16 +.Nd Probe that fires when a Ruby method returns |
|
17 +.Pp |
|
18 +.Nm raise |
|
19 +.Nd Probe that fires when a Ruby exception is raised |
|
20 +.Pp |
|
21 +.Nm rescue |
|
22 +.Nd Probe that fires when a Ruby exception is rescued |
|
23 +.Pp |
|
24 +.Nm line |
|
25 +.Nd Probe that fires for every line of Ruby executed |
|
26 +.Pp |
|
27 +.Nm gc-begin |
|
28 +.Nd Probe that fires right before a GC cycle begins |
|
29 +.Pp |
|
30 +.Nm gc-end |
|
31 +.Nd Probe that fires right after a GC cycle finishes |
|
32 +.Pp |
|
33 +.Nm object-create-start |
|
34 +.Nd Probe that fires directly before a Ruby object is allocated |
|
35 +.Pp |
|
36 +.Nm object-create-done |
|
37 +.Nd Probe that fires when Ruby is finished allocating an object |
|
38 +.Pp |
|
39 +.Nm object-free |
|
40 +.Nd Probe that fires every time a Ruby object is freed |
|
41 +.Pp |
|
42 +.Nm ruby-probe |
|
43 +.Nd Probe that can be fired from Ruby code (see below) |
|
44 +.Pp |
|
45 +.Sy "Probe Arguments" |
|
46 .El |
|
47 .Pp |
|
48 +.Nm function-entry |
|
49 +.Ar "Ruby class" Ar "Method name" Ar "Source file" Ar "Line number" |
|
50 +.Pp |
|
51 +.Nm function-return |
|
52 +.Ar "Ruby class" Ar "Method name" Ar "Source file" Ar "Line number" |
|
53 +.Pp |
|
54 +.Nm raise |
|
55 +.Ar "Ruby class" Ar "Source file" Ar "Line number" |
|
56 +.Pp |
|
57 +.Nm rescue |
|
58 +.Ar "Source file" Ar "Line number" |
|
59 +.Pp |
|
60 +.Nm line |
|
61 +.Ar "Source file" Ar "Line number" |
|
62 +.Pp |
|
63 +.Nm gc-begin |
|
64 +.Ar "" |
|
65 +.Pp |
|
66 +.Nm gc-end |
|
67 +.Ar "" |
|
68 +.Pp |
|
69 +.Nm object-create-start |
|
70 +.Ar "Ruby type" Ar "Source file" Ar "Line number" |
|
71 +.Pp |
|
72 +.Nm object-create-done |
|
73 +.Ar "Ruby type" Ar "Source file" Ar "Line number" |
|
74 +.Pp |
|
75 +.Nm object-free |
|
76 +.Ar "Ruby type" |
|
77 +.Nm ruby-probe |
|
78 +.Ar "Arbitrary string" Ar "Arbitrary string" |
|
79 +.Pp |
|
80 .Sh OPTIONS |
|
81 Ruby interpreter accepts following command-line options (switches). |
|
82 They are quite similar to those of |
|
83 @@ -154,9 +225,9 @@ |
|
84 .Li #! |
|
85 on machines that don't support it, in the following manner: |
|
86 .Bd -literal -offset indent |
|
87 -#! /usr/local/bin/ruby |
|
88 +#! /usr/bin/ruby |
|
89 # This line makes the next one a comment in Ruby \e |
|
90 - exec /usr/local/bin/ruby -S $0 $* |
|
91 + exec /usr/bin/ruby -S $0 $* |
|
92 .Ed |
|
93 .Pp |
|
94 .It Fl T Ns Op Ar level |
|
95 @@ -251,7 +322,7 @@ |
|
96 .Li ARGV |
|
97 and set the corresponding variable in the script. For example: |
|
98 .Bd -literal -offset indent |
|
99 -#! /usr/local/bin/ruby -s |
|
100 +#! /usr/bin/ruby -s |
|
101 # prints "true" if invoked with `-xyz' switch. |
|
102 print "true\en" if $xyz |
|
103 .Ed |
|
104 @@ -349,3 +420,5 @@ |
|
105 .Sh AUTHORS |
|
106 Ruby is designed and implemented by |
|
107 .An Yukihiro Matsumoto Aq [email protected] . |
|
108 +.Sh SEE ALSO |
|
109 +.Nm gem(1) |
|