YARD GObject Plugin
This is a YARD plugin that assists in the documentation of Ruby bindings that make use of GObject, i.e. the Ruby-GNOME2 bindings.
Installation
Because YARD auto-loads all gems beggining with yard-
, all you need to do is install the latest version of this gem from Gemcutter.
Features
For now, it supports only one tag: @properties
. This tag can be applied to any Class (G_DEF_CLASS
macros), or Module (G_DEF_INTERFACE
macros). It provides meta-data for the various GObject properties belonging to a GObject Class or GObject Interface.
Syntax
# @properties property-name [PropertyType] :PropertyAccess description,
# another-property [PropertyType] description...
:PropertyAccess
is used to represent the access to the properties. Only three access permissions are used. The order in which they appear is unimportant. The letters used for specifying the position are as follows:
- R — for Read
- W — for Write
- C — for Construct
PropertyType
is formatted the same way YARD formats types. description
can be ommited.
An example: ## # @properties uri [String] :RWC, visible [String] :RWC
License
This plugin is Copyright © 2010 Stojan Dimitrovski, licensed under the MIT License. See the LICENSE.txt file included in this distribution for more information.