Opaque documentation

[egbert]

Once in a while you come acros aline of documentation
that you have to, or that invites you to, read it again.
This is what I found in PyGTK:

    The set_screen method sets the 'screen" property to 
    the gtk.gdk.Screen specified by screen. The "screen" property
    contains the screen that the window is displayed on.

The screen on the second line, before the period, is in italics, 
if that helps.

I like these texts. Prose should not disclose its secrets at once.
If you have other examples, please let us know.
-- 
Egbert Bouwman - Keizersgracht 197 II - 1016 DS  Amsterdam - 020 6257991
========================================================================