From: "drbrain (Eric Hodel)" Date: 2012-11-20T13:09:13+09:00 Subject: [ruby-core:49639] [ruby-trunk - Bug #7326] Time.c doc improvements Issue #7326 has been updated by drbrain (Eric Hodel). =begin Arguments should be surrounded by "+", not "_". In Time.at, (({+seconds+})), (({+seconds_with_frac+})) and (({+microseconds_with_frac+})) are preferred. Otherwise, a quick scan makes me think this patch is good. For reference purposes, methods will be linked in the same class if they have an "_" or them, so (({Time#to_s})) and (({#to_s})) and (({to_s})) would all link to the same place. A full name like (({Array#join})) should be used when referring to a method external to the current class. If a method doesn't have an "_" like (({Time#sec})) you need to prefix it with an "#". (({Time#sec})) and (({#sec})) would both link to the same place, but (({sec})) would not be linked. Similarly, for class methods without "_", prefix the method with "::". When using a full name, if the method is unambiguous, a "." will also work. (({Time.sec})) will link to (({Time#sec})) =end ---------------------------------------- Bug #7326: Time.c doc improvements https://bugs.ruby-lang.org/issues/7326#change-33155 Author: bt (Bernd Homuth) Status: Open Priority: Normal Assignee: zzak (Zachary Scott) Category: DOC Target version: 2.0.0 ruby -v: 1.9.3 I tried to improve some parts of the documentation. Mainly I changed +Time+ for classes and _time_ for objects. I fixed some typos and probably introduced new ones. Please check carefully. -- http://bugs.ruby-lang.org/