Fundamental question

ruby-talk
1

Hi,

when I am using rbbr, I get at anytime the same out -- despite the
fact, that I have addionally installed a couple of tools and
packages. How can I update the "knowledge base" of rbbr?

Another documentation related question:
Sometimes I find the hint "to get the newest documentation of this
packages use rdoc on the contents of the archive." on homepage of
ruby-packages. Ok....? But how...?

Any hint how to circumvent these problems I have is very appreciated
:sunglasses:

Where can I find "rdoc for newbies" or "ri for newbies" or "rbbr for
newbies" ?

"man <rdoc,ri,rbbr>" and "rdoc <rdoc,ri,rbbr>" does not gave
anything of output on my box.

Thank you very much for any help in advance !
Meino Cramer

2

Meino Christian Cramer wrote:

I can't answer your question. I hope someone can.

"man <rdoc,ri,rbbr>" and "rdoc <rdoc,ri,rbbr>" does not gave
anything of output on my box.

This interests me. AFAIK there have never been man pages for any
Ruby-related tools.

How does one create man pages anyhow?

Hal

3

[Meino Christian Cramer <Meino.Cramer@gmx.de>, 2004-07-16 07.17 CEST]

"man <rdoc,ri,rbbr>" and "rdoc <rdoc,ri,rbbr>" does not gave
anything of output on my box.

It depends on your distribution. In Debian they come with man pages.

4

In rbbr, you have to import the modules you want to examine manually;
it will only load the core library and Gtk+/GNOME modules by default.
If you go to the 'File->Require Library...' menu item, you should get
a directory tree for every location in the Ruby load path, from which
you can select additional libraries to include. Alternately, if you
select 'File->Load Library...', you should see a file chooser dialog
which will prompt you for a single Ruby source file to load and
include in the rbbr class browser.

Regardless, you will likely find that rbbr is fairly focused on
Gtk+/GNOME/Glib functionality; 'Properties' and 'Signals' are not a
part of the Ruby core, but are fundamental features of any class from
the rbbr application's perspective.

Lennon

路路路

On Fri, 16 Jul 2004 14:20:13 +0900, Hal Fulton <hal9000@hypermetrics.com> wrote:

Meino Christian Cramer wrote:

I can't answer your question. I hope someone can.

> "man <rdoc,ri,rbbr>" and "rdoc <rdoc,ri,rbbr>" does not gave
> anything of output on my box.

This interests me. AFAIK there have never been man pages for any
Ruby-related tools.

How does one create man pages anyhow?

Hal

5

Hal Fulton wrote:

Meino Christian Cramer wrote:

I can't answer your question. I hope someone can.

"man <rdoc,ri,rbbr>" and "rdoc <rdoc,ri,rbbr>" does not gave
anything of output on my box.

This interests me. AFAIK there have never been man pages for any
Ruby-related tools.

How does one create man pages anyhow?

It's not hard, but it's not pretty, either. You have to use the groff/troff/whatever formatting system, which is ugly, but functional.

Here's a tutorial I googled for:

http://www.fnal.gov/docs/products/ups/ReferenceManual/html/manpages.html

I'm sure there are more out there, perhaps some that are even better.

路路路

--
Jamis Buck
jgb3@email.byu.edu
http://www.jamisbuck.org/jamis

"I use octal until I get to 8, and then I switch to decimal."

6

Hal Fulton wrote:

Meino Christian Cramer wrote:

I can't answer your question. I hope someone can.

"man <rdoc,ri,rbbr>" and "rdoc <rdoc,ri,rbbr>" does not gave
anything of output on my box.

This interests me. AFAIK there have never been man pages for any
Ruby-related tools.

How does one create man pages anyhow?

use rdtool:

   ~ > cat sample.rd
   = SYNOPSIS
     sample page
   = BUGS
     many
   = AUTHOR
     me

   ~ > rd2 -r rd/rd2man-lib sample.rd > sample.man

   ~ > env PAGER=cat man ./sample.man
   -(1) -(1)

   SYNOPSIS
              sample page

   BUGS
              many

   AUTHOR
              me

-a

路路路

--

EMAIL :: Ara [dot] T [dot] Howard [at] noaa [dot] gov
PHONE :: 303.497.6469
A flower falls, even though we love it;
and a weed grows, even though we do not love it. --Dogen

===============================================================================

7

Linux Doc Book supports man pages. You can create the sgml with lyx for
example and then use 'sgml2txt -m'

Guillaume.

路路路

On Fri, 2004-07-16 at 12:52, Ara.T.Howard wrote:

> Hal Fulton wrote:
>> Meino Christian Cramer wrote:
>>
>> I can't answer your question. I hope someone can.
>>
>>> "man <rdoc,ri,rbbr>" and "rdoc <rdoc,ri,rbbr>" does not gave
>>> anything of output on my box.
>>
>>
>> This interests me. AFAIK there have never been man pages for any
>> Ruby-related tools.
>>
>> How does one create man pages anyhow?

use rdtool:

   ~ > cat sample.rd
   = SYNOPSIS
     sample page
   = BUGS
     many
   = AUTHOR
     me

   ~ > rd2 -r rd/rd2man-lib sample.rd > sample.man

   ~ > env PAGER=cat man ./sample.man
   -(1) -(1)

   SYNOPSIS
              sample page

   BUGS
              many

   AUTHOR
              me

-a
--

> EMAIL :: Ara [dot] T [dot] Howard [at] noaa [dot] gov
> PHONE :: 303.497.6469
> A flower falls, even though we love it;
> and a weed grows, even though we do not love it.
> --Dogen