1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00

* ext/curses/curses.c: Clean up documentation.

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@32145 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
drbrain 2011-06-17 04:10:37 +00:00
parent 630ba53d29
commit becd789625
2 changed files with 43 additions and 30 deletions

View file

@ -1,3 +1,7 @@
Fri Jun 17 13:09:45 2011 Eric Hodel <drbrain@segment7.net>
* ext/curses/curses.c: Clean up documentation.
Fri Jun 17 09:25:14 2011 Eric Hodel <drbrain@segment7.net>
* ext/curses/curses.c: Document curses constants. Patch by Vincent

View file

@ -142,6 +142,7 @@ curses_init_screen(void)
* Document-method: Curses.stdscr
*
* The Standard Screen.
*
* Upon initializing curses, a default window called stdscr,
* which is the size of the terminal screen, is created.
*
@ -820,15 +821,17 @@ curses_scrl(VALUE obj, VALUE n)
/*
* Document-method: Curses.setscrreg
* call-seq: setscrreg(top, bottom)
*
* call-seq:
* setscrreg(top, bottom)
*
* Set a software scrolling region in a window.
* +top+ and +bottom+ are lines numbers of the margin.
*
* If this option and Curses.scrollok are enabled, an attempt to move off
* the bottom margin line causes all lines in the scrolling region
* to scroll one line in the direction of the first line.
* Only the text of the window is scrolled.
* If this option and Curses.scrollok are enabled, an attempt to move off
* the bottom margin line causes all lines in the scrolling region
* to scroll one line in the direction of the first line.
* Only the text of the window is scrolled.
*
*/
static VALUE
@ -1893,7 +1896,9 @@ window_addstr(VALUE obj, VALUE str)
/*
* Document-method: Curses::Window.<<
* call-seq: <<(str)
*
* call-seq:
* <<(str)
*
* Add String +str+ to the current string.
*
@ -2087,15 +2092,16 @@ window_idlok(VALUE obj, VALUE bf)
/*
* Document-method: Curses::Window.setscrreg
* call-seq: setscrreg(top, bottom)
* call-seq:
* setscrreg(top, bottom)
*
* Set a software scrolling region in a window.
* +top+ and +bottom+ are lines numbers of the margin.
*
* If this option and Curses::Window.scrollok are enabled, an attempt to move off
* the bottom margin line causes all lines in the scrolling region
* to scroll one line in the direction of the first line.
* Only the text of the window is scrolled.
* If this option and Curses::Window.scrollok are enabled, an attempt to move
* off the bottom margin line causes all lines in the scrolling region to
* scroll one line in the direction of the first line. Only the text of the
* window is scrolled.
*
*/
static VALUE
@ -2352,16 +2358,19 @@ window_resize(VALUE obj, VALUE lin, VALUE col)
#ifdef HAVE_KEYPAD
/*
* Document-method: Curses::Window.keypad=
* call-seq: keypad=(bool)
* call-seq:
* keypad=(bool)
*
* see Curses::Window.keypad
* See Curses::Window.keypad
*/
/*
* Document-method: Curses::Window.keypad
* call-seq: keypad(bool)
* call-seq:
* keypad(bool)
*
* Enables the keypad of the user's terminal.
*
* If enabled (+bool+ is +true+), the user can press a function key
* (such as an arrow key) and wgetch returns a single value representing
* the function key, as in KEY_LEFT. If disabled (+bool+ is +false+),
@ -2602,27 +2611,27 @@ Init_curses(void)
*
* The means by which to create and manage frames or windows.
* While there may be more than one window at a time, only one window
* receive the input.
* will receive input.
*
* == Usage
*
* require 'curses'
* require 'curses'
*
* Curses.init_screen()
* Curses.init_screen()
*
* my_str = "LOOK! PONIES!"
* win = Curses::Window.new( 8, (my_str.length + 10),
* (Curses.lines - 8) / 2,
* (Curses.cols - (my_str.length + 10)) / 2 )
* win.box("|", "-")
* win.setpos(2,3)
* win.addstr(my_str)
* # or even
* win << "\nORLY"
* win << "\nYES!! " + my_str
* win.refresh
* win.getch
* win.close
* my_str = "LOOK! PONIES!"
* win = Curses::Window.new( 8, (my_str.length + 10),
* (Curses.lines - 8) / 2,
* (Curses.cols - (my_str.length + 10)) / 2 )
* win.box("|", "-")
* win.setpos(2,3)
* win.addstr(my_str)
* # or even
* win << "\nORLY"
* win << "\nYES!! " + my_str
* win.refresh
* win.getch
* win.close
*
*/
cWindow = rb_define_class_under(mCurses, "Window", rb_cData);