Ri missing some system libraries

Discussion in 'Ruby' started by Charles Comstock, Feb 19, 2004.

  1. What exactly should / shouldn't Ri be missing? I assumed stuff like TCPSocket
    would be listed, but in my stable snapshot of 1.8.1 from earlier this week, I
    get no Ri reference to those classes, despite if I remember correctly, some
    documentation from them existing in the Programming Ruby book.
    Charles Comstock
     
    Charles Comstock, Feb 19, 2004
    #1
    1. Advertisements

  2. > What exactly should / shouldn't Ri be missing? I assumed stuff like
    > TCPSocket would be listed, but in my stable snapshot of 1.8.1 from
    > earlier this week, I get no Ri reference to those classes, despite if I
    > remember correctly, some documentation from them existing in the
    > Programming Ruby book.
    > Charles Comstock


    TCPSocket is not "core API"; it's "standard library". 'ri' attempts to
    document both categories using the source code. The code for TCPSocket is
    in ext/socket/socket.c, which has no documentation at all in it.

    RDoc uses certain heuristics to understand C files. If classes and
    methods are not defined in a certain (common) way, then RDoc won't pick
    them up unless you give explicit comments like

    /*
    * Document-class: TCPSocket
    *
    * TCPSocket is a ...
    */

    I think the whole core API has been documented. The standard library,
    however, is large and progress is slow. I just finished strscan, which
    has excellent (but incomplete) documentation in RD form. All up, it took
    me about 10 hours to properly document the source code.

    Could you please visit OnlineDocumentationIssues on the Wiki to report
    TCPSocket and other classes you notice to be missing?

    Cheers,
    Gavin
     
    Gavin Sinclair, Feb 19, 2004
    #2
    1. Advertisements

Want to reply to this thread or ask your own question?

It takes just 2 minutes to sign up (and it's free!). Just click the sign up button to choose a username and then you can ask your own questions on the forum.
Similar Threads
  1. Manzanita

    libraries, IDE and some doubts.

    Manzanita, Apr 1, 2004, in forum: Java
    Replies:
    1
    Views:
    412
    Andrew Thompson
    Apr 2, 2004
  2. Dheeraj Kumar
    Replies:
    2
    Views:
    401
    Frank Schmitt
    Sep 24, 2003
  3. Roy Yves
    Replies:
    0
    Views:
    507
    Roy Yves
    Jun 10, 2004
  4. Gary Herron
    Replies:
    2
    Views:
    853
    Bruno Desthuilliers
    Jul 4, 2006
  5. Karsten Wutzke
    Replies:
    21
    Views:
    1,278
    Roedy Green
    Jun 29, 2007
  6. Sriram Srinivasan
    Replies:
    13
    Views:
    884
    Benjamin Kaplan
    Nov 12, 2009
  7. Replies:
    0
    Views:
    308
  8. David Wright
    Replies:
    1
    Views:
    129
    Eric Hodel
    May 13, 2009
Loading...