The documentation makes use of annotations like "transfer-full" and "allow-none" to describe how certain arguments and return values should be treated. For example, in the documentation for the "g_data_input_stream_read_line" function [1] several annotations are used.

These annotations alone are not clear enough to convey their meanings, so they have an accompanying text that explains what the annotation means.

In the generated HTML documentation this description text is associated with the annotation by the use of an acronym tag. This has the effect of rendering the description text as a title text on most browsers.

In the current CSS, the presence of this title text is not obvious as the annotations have the same style of normal text.

One possible solution is to underline the annotation with a dotted line, hinting to the user that the annotation text has a different meaning/behavior than that of a normal text. This is the approach used in the CSS for the GStreamer documentation [2].

If that is a good solution, the style rule that can be added to achieve this behavior is:

acronym {
    border-bottom: 1px dotted;
}

[1] http://developer.gnome.org/gio/stable/GDataInputStream.html#g-data-input-stream-read-line
[2] http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/annotation-glossary.html#glsO