From 7c4d0468df37da40cbcd178070b288dd535bc72e Mon Sep 17 00:00:00 2001 From: zzak Date: Wed, 19 Sep 2012 22:23:15 +0000 Subject: * complex.c: Examples for Complex Documentation. Patch by Robin Dupret. Fixes #184 on github. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@36993 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ChangeLog | 6 ++++++ complex.c | 20 +++++++++++++++++--- 2 files changed, 23 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index 5e731729a9..d3d5603687 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Thu Sep 20 07:20:00 2012 Zachary Scott + + * complex.c: Examples for Complex Documentation. + Patch by Robin Dupret. + Fixes #184 on github. + Thu Sep 20 07:15:00 2012 Zachary Scott * ext/ripper/lib/ripper.rb: Documentation for Ripper. diff --git a/complex.c b/complex.c index 230f713b16..a1ec5d5b41 100644 --- a/complex.c +++ b/complex.c @@ -440,6 +440,10 @@ nucomp_s_canonicalize_internal(VALUE klass, VALUE real, VALUE imag) * Complex.rectangular(real[, imag]) -> complex * * Returns a complex object which denotes the given rectangular form. + * + * For example: + * Complex.rect(12, 2) # => (12+2i) + * Complex.rect(0, 17) # => (0+17i) */ static VALUE nucomp_s_new(int argc, VALUE *argv, VALUE klass) @@ -679,7 +683,11 @@ f_addsub(VALUE self, VALUE other, * call-seq: * cmp + numeric -> complex * - * Performs addition. + * Performs addition on the first member of the Complex. + * + * Complex(5, 2) + 3 # => (8+2i) + * Complex(11, 3) + 4 # => (15+3i) + * */ static VALUE nucomp_add(VALUE self, VALUE other) @@ -691,7 +699,10 @@ nucomp_add(VALUE self, VALUE other) * call-seq: * cmp - numeric -> complex * - * Performs subtraction. + * Performs subtraction on the first member of the Complex. + * + * Complex(33, 12) - 10 # => (23+12i) + * Complex(12.4, 3.5) - 5 # => (7.4+3.5i) */ static VALUE nucomp_sub(VALUE self, VALUE other) @@ -703,7 +714,10 @@ nucomp_sub(VALUE self, VALUE other) * call-seq: * cmp * numeric -> complex * - * Performs multiplication. + * Performs multiplication on the two members. + * + * Complex(78, 58) * 10 # => (780+580i) + * Complex(5.6, 3.4) * 10 # => (56+34i) */ static VALUE nucomp_mul(VALUE self, VALUE other) -- cgit v1.2.3