Ruby curses documentation?

hello,
I would like to start to learn using curses with ruby.
I don’t know nothing about curses.
Is there existing any documentation about the ruby curses library?
all I found yet is code examples (not all works).
Do I have to search directly in the C source of ruby to get the names
of the functions and constants for example?

thanks,

jf

If there is examples in the Ruby source which doesn’t work, why don’t you
submit a bug-report ?

curses is deprecated. Instead use Ncurses.
http://ncurses-ruby.berlios.de/

You can read more about how to use ncurses, via ‘man ncurses’
Ncurses for Ruby is very similar to the C-API.

···

On Wed, 13 Aug 2003 06:49:58 +0000, MENON Jean-Francois wrote:

I would like to start to learn using curses with ruby.
I don’t know nothing about curses.
Is there existing any documentation about the ruby curses library?
all I found yet is code examples (not all works).
Do I have to search directly in the C source of ruby to get the names
of the functions and constants for example?


Simon Strandgaard

hello, thx for your answer :

Simon Strandgaard wrote:

I would like to start to learn using curses with ruby.
I don’t know nothing about curses.
Is there existing any documentation about the ruby curses library?
all I found yet is code examples (not all works).
Do I have to search directly in the C source of ruby to get the names
of the functions and constants for example?

If there is examples in the Ruby source which doesn’t work, why don’t you
submit a bug-report ?

I will submit a bug-report as soon as I understand something to the
examples

curses is deprecated. Instead use Ncurses.
http://ncurses-ruby.berlios.de/

I use the curses version in the ruby distrib (1.8.0-pre7).
Does it contains deprecated libraries ?

jf

···

On Wed, 13 Aug 2003 06:49:58 +0000, MENON Jean-Francois wrote:

I don’t think ruby’s curses binding is considered deprecated.

ncurses-ruby requires NCurses or PDCurses and will not work with
vendor-specific curses libs that ship with some proprietary unix
systems. Ruby’s own curses binding will most likely work with these.

Tobias

···

On Thu, 14 Aug 2003, MENON Jean-Francois wrote:

Simon Strandgaard wrote:

curses is deprecated. Instead use Ncurses.
http://ncurses-ruby.berlios.de/

I use the curses version in the ruby distrib (1.8.0-pre7).
Does it contains deprecated libraries ?

Scripsit ille »Tobias Peters« tpeters@uni-oldenburg.de:

Simon Strandgaard wrote:

curses is deprecated. Instead use Ncurses.
http://ncurses-ruby.berlios.de/

I use the curses version in the ruby distrib (1.8.0-pre7).
Does it contains deprecated libraries ?

I don’t think ruby’s curses binding is considered deprecated.

ncurses-ruby requires NCurses or PDCurses and will not work with
vendor-specific curses libs that ship with some proprietary unix
systems. Ruby’s own curses binding will most likely work with these.

Yes, but where is it documented?

I haven’t found any documentation for ncurses-ruby or ‘curses’…
but for ncurses I have the Linux manpages and the rest was guessing.

Where is Ruby’s curses interface documented?

···

On Thu, 14 Aug 2003, MENON Jean-Francois wrote:

bash-2.05b$ ri Curses
This is a test ‘ri’. Please report errors and omissions
on http://www.rubygarden.org/ruby?RIOnePointEight

Couldn’t find class/module `Curses’.
Use /usr/bin/ri with no parameter for a list


L: Núper erát medicús nunc ést vispíllo Diáulus:
D: Früher war er Arzt, nun ist Diaulus Totengräber:
L: Quód vispíllo facít - fécerat ét medicús.
D: Was er als Totengräber macht - tat er schon als Arzt. [Martial]

A 100 pages tutorial about NCurses programming is here:

If you prefer reference documentation, go for the various manpages.

The difference between the C API and the ncurses-ruby API is documented in
the README file (~ 4 pages) of the ncurses-ruby distribution.

The API difference of the standard ruby curses binding is AFAIK not
documented, but you will easily figure it out with sufficient NCurses
programming knowledge.

Tobias

···

On 14 Aug 2003, Rudolf Polzer wrote:

Scripsit ille »Tobias Peters« tpeters@uni-oldenburg.de:

ncurses-ruby requires NCurses or PDCurses and will not work with
vendor-specific curses libs that ship with some proprietary unix
systems. Ruby’s own curses binding will most likely work with these.

Yes, but where is it documented?

I haven’t found any documentation for ncurses-ruby or ‘curses’…
but for ncurses I have the Linux manpages and the rest was guessing.

Scripsit illa aut ille »Tobias Peters« tpeters@uni-oldenburg.de:

Scripsit ille »Tobias Peters« tpeters@uni-oldenburg.de:

ncurses-ruby requires NCurses or PDCurses and will not work with
vendor-specific curses libs that ship with some proprietary unix
systems. Ruby’s own curses binding will most likely work with these.

Yes, but where is it documented?

I haven’t found any documentation for ncurses-ruby or ‘curses’…
but for ncurses I have the Linux manpages and the rest was guessing.

A 100 pages tutorial about NCurses programming is here:
http://www.ibiblio.org/pub/Linux/docs/HOWTO/other-formats/pdf/NCURSES-Programming-HOWTO.pdf

If you prefer reference documentation, go for the various manpages.

I don’t have manpages for curses, only for ncurses. It seems to be highly
extended from curses.

The difference between the C API and the ncurses-ruby API is documented in
the README file (~ 4 pages) of the ncurses-ruby distribution.

The API difference of the standard ruby curses binding is AFAIK not
documented, but you will easily figure it out with sufficient NCurses
programming knowledge.

When I do Curses.methods - Object.methods and Curses.stdscr.methods -
Object.methods in irb, I don’t recognize many ncurses methods.

I’m currently trying to convert a ruby-ncurses program I wrote to
ruby-curses. And I miss MANY methods. First of all, all mv* methods.
Then it seems like I have to output text using << (I don’t find many
ncurses output functions like waddstr etc.).

For example, currently I’m looking on how to do “endwin” in curses.

Supersede: I found it. But what about nodelay()/timeout()? I need
non-blocking reading from the keyboard.

···

On 14 Aug 2003, Rudolf Polzer wrote:

Tobias Peters wrote:

The API difference of the standard ruby curses binding is AFAIK not
documented, but you will easily figure it out with sufficient NCurses
programming knowledge.

do you mean I that I have to learn Ncurses that I will not use to be
able
to use Curses that I didn’t learn ? ;->

MENON Jean-Francois wrote:

The API difference of the standard ruby curses binding is AFAIK not
documented, but you will easily figure it out with sufficient NCurses
programming knowledge.

do you mean I that I have to learn Ncurses that I will not use to be
able
to use Curses that I didn’t learn ? ;->

No, not in this strict sense, sorry. If you learn plain curses
programming, e.g. from your unix vendor’s programming manual, you can of
course use that knowledge.

To see if some curses feature is wrapped and under which name, you can
grep for it in /ext/curses/curses.c .

Tobias