ruby-changes:30454
From: zzak <ko1@a...>
Date: Mon, 12 Aug 2013 13:48:35 +0900 (JST)
Subject: [ruby-changes:30454] zzak:r42533 (trunk): * process.c: [DOC] RDoc formatting of Process.clock_gettime
zzak 2013-08-12 13:48:28 +0900 (Mon, 12 Aug 2013) New Revision: 42533 http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=42533 Log: * process.c: [DOC] RDoc formatting of Process.clock_gettime Modified files: trunk/ChangeLog trunk/process.c Index: ChangeLog =================================================================== --- ChangeLog (revision 42532) +++ ChangeLog (revision 42533) @@ -1,3 +1,7 @@ https://github.com/ruby/ruby/blob/trunk/ChangeLog#L1 +Mon Aug 12 13:47:54 2013 Zachary Scott <e@z...> + + * process.c: [DOC] RDoc formatting of Process.clock_gettime + Mon Aug 12 13:29:09 2013 Zachary Scott <e@z...> * lib/yaml/dbm.rb: [DOC] Document call-seq for YAML::DBM Index: process.c =================================================================== --- process.c (revision 42532) +++ process.c (revision 42533) @@ -6639,16 +6639,17 @@ rb_proc_times(VALUE obj) https://github.com/ruby/ruby/blob/trunk/process.c#L6639 /* * call-seq: - * Process.clock_gettime(clk_id [, unit]) -> number + * Process.clock_gettime(clock_id [, unit]) -> number * * Returns a time returned by POSIX clock_gettime() function. * - * _clk_id_ specifies a kind of clock. + * +clock_id+ specifies a kind of clock. * It is specifed as a constant which begins with <code>Process::CLOCK_</code> - * such like <code>Process::CLOCK_REALTIME</code> and - * <code>Process::CLOCK_MONOTONIC</code>. + * such as Process::CLOCK_REALTIME and Process::CLOCK_MONOTONIC. + * * The supported constants depends on OS and version. - * Ruby provides following type of _clk_id_ if available. + * + * Ruby provides following types of +clock_id+ if available. * * [CLOCK_REALTIME] SUSv2 to 4, Linux 2.5.63, FreeBSD 3.0, NetBSD 2.0, OpenBSD 2.1 * [CLOCK_MONOTONIC] SUSv3 to 4, Linux 2.5.63, FreeBSD 3.0, NetBSD 2.0, OpenBSD 3.4 @@ -6666,17 +6667,17 @@ rb_proc_times(VALUE obj) https://github.com/ruby/ruby/blob/trunk/process.c#L6667 * [CLOCK_UPTIME_PRECISE] FreeBSD 8.1 * [CLOCK_SECOND] FreeBSD 8.1 * - * Also, several symbols are accepted as _clk_id_. + * Also, several symbols are accepted as +clock_id+. * They may be used as emulation for clock_gettime(). - * For example, <code>Process::CLOCK_REALTIME</code> is defined as - * <code>:POSIX_GETTIMEOFDAY_CLOCK_REALTIME</code> when clock_gettime() is not available. + * For example, Process::CLOCK_REALTIME is defined as + * +:POSIX_GETTIMEOFDAY_CLOCK_REALTIME+ when clock_gettime() is not available. * * [:POSIX_GETTIMEOFDAY_CLOCK_REALTIME] Use gettimeofday(). The precision is 1 micro second. * [:POSIX_TIME_CLOCK_REALTIME] Use time(). The precision is 1 second. * - * If the given _clk_id_ is not supported, Errno::EINVAL is raised. + * If the given +clock_id+ is not supported, Errno::EINVAL is raised. * - * _unit_ specifies a type of the return value. + * +unit+ specifies a type of the return value. * * [:float_seconds] number of seconds as a float (default) * [:float_milliseconds] number of milliseconds as a float @@ -6688,7 +6689,7 @@ rb_proc_times(VALUE obj) https://github.com/ruby/ruby/blob/trunk/process.c#L6689 * The underlying function, clock_gettime(), returns a number of nanoseconds. * Float object (IEEE 754 double) is not enough to represent * the return value for CLOCK_REALTIME. - * If the exact nanoseconds value is required, use :nanoseconds as _unit_. + * If the exact nanoseconds value is required, use +:nanoseconds+ as the +unit+. * * The origin (zero) of the returned value varies. * For example, system start up time, process start up time, the Epoch, etc. -- ML: ruby-changes@q... Info: http://www.atdot.net/~ko1/quickml/