Attributes

Should e.g. DBus attributes go here? Or just a note about them pointing to their docs?

Provide extra information to:

integrate libraries more directly, e.g. dbus. These are the ones most often used in new Vala programs/libraries.
to control C code generation, particularly with existing libraries, e.g. CCode. Mostly used in bindings.
to give extra information to Vala that isn't included in code, e.g. IntegerType. Mostly used internally in Vala.

They are written as:

[ AnnotationName ( details-list ) ]
declaration

[Notify]

Should use glib notifications.

Applies: properties

[CCode] (cheader_filename = "") (lower_case_cprefix = "") (cname_prefix) (type_id)

How to name in C

Applies: almost all

[InstanceLast]

Pass instance as last arg

Applies: class methods

[Import]

Method is defined elsewhere

Applies: methods

[NoArrayLength]

Array length parameter not passed

Applies: methods taking an array, methods returning an array - as return? as out arg?

[SimpleType]

Passed by value

Applies: struct

[IntegerType] (rank = 0)

Applies:

[FloatingType] (rank = 0)

Applies:

[HasEmitter]

Signal has emitter - what does that mean?

Applies: signals

[NoAccessorMethod]

Property has no accessor method.

Applies: properties

[Flags]

Is bitfield?

Applies: enums

Demonstrating...

// ...