For better text.
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>
Title: Overview
This library is designed for applications to manipulate ALSA control character device and operate
-control functionality abstracted as card and element. ALSACtlCard represent the card. It holds
+control functionality abstracted as card and element. ALSACtlCard express the card. It holds
file descriptor and creates GSource for event dispatching by GLib's GMainContext/GMainLoop.
This library is designed for applications to manipulate ALSA Rawmidi character device and operate
rawmidi functionality abstracted as a pair of streams and substream. ALSARawmidiStreamPair
-represents the pair of streams. It holds file descriptor and creates GSource for event dispathing
+expresss the pair of streams. It holds file descriptor and creates GSource for event dispathing
by GLib's GMainContext/GMainLoop.
Title: Overview
This library is designed for applications to manipulate ALSA sequencer character device and operate
-its functionality abstracted. as user client, port, and event. ALSASeqUserClient represent the
-user client. It holds file descriptor and creates GSource for event dispatching by GLib's
-GMainContext/GMainLoop.
+its functionality abstracted as user client, port, and event. ALSASeqUserClient express the user
+client. It holds file descriptor and creates GSource for event dispatching by GLib's GMainContext
+and GMainLoop.
Title: Overview
This library is designed for applications to manipulate ALSA timer character device and operate
-timer functionality abstracted as timer device and user instance. ALSATimerUserInstance represents
+timer functionality abstracted as timer device and user instance. ALSATimerUserInstance expresss
the user instance. It holds file descriptor and creates GSource for event dispatching by GLib's
GMainContext/GMainLoop.
/**
* ALSACtlCardInfo:
- * A GObject-derived object to represent information of sound card.
+ * A GObject-derived object to express information of sound card.
*
* A [class@CardInfo] is information of sound card. The call of [method@Card.get_info] returns an
* instance of the object.
/**
* ALSACtlCard:
- * An GObject-derived object to represent sound card.
+ * An GObject-derived object to express sound card.
*
- * A [class@Card] is a GObject-derived object to represent sound card. Applications use the
+ * A [class@Card] is a GObject-derived object to express sound card. Applications use the
* instance of object to manipulate functionalities on sound card. After the call of
* [method@Card.open] for the numeric ID of sound card, the object maintains file descriptor till
* object destruction.
* used.
* @error: A [struct@GLib.Error].
*
- * Get the version of control protocol currently used. The version is represented as the array with
+ * Get the version of control protocol currently used. The version is expressed as the array with
* three elements; major, minor, and micro version in the order. The length of major version is
* 16 bit, the length of minor and micro version is 8 bit each.
*
/**
* ALSACtlElemId:
- * A boxed object to represent the identifier of element.
+ * A boxed object to express the identifier of element.
*
- * A [struct@ElemId] is a boxed object to represent the identifier of element. It points to a
+ * A [struct@ElemId] is a boxed object to express the identifier of element. It points to a
* element by two ways; by the numeric identifier, or by the combination of the type of interface,
* the numeric identifier of device, the numeric identifier of subdevice, the name, and the index.
*
/**
* ALSAHwdepDeviceInfo:
- * A GObject-derived object to represent information of ALSA hwdep device.
+ * A GObject-derived object to express information of ALSA hwdep device.
*
- * A [class@DeviceInfo] is a GObject-derived object to represent information of ALSA hwdep device.
+ * A [class@DeviceInfo] is a GObject-derived object to express information of ALSA hwdep device.
* The call of [func@get_device_info] returns an instance of the object.
*
* The object wraps `struct snd_hwdep_info` in UAPI of Linux sound subsystem.
/**
* ALSARawmidiStreamPair:
- * GObject-derived object to represent a pair of Rawmidi stream.
+ * GObject-derived object to express a pair of Rawmidi stream.
*
- * A [class@StreamPair] is a GObject-derived object to represent a pair of Rawmidi stream to which
+ * A [class@StreamPair] is a GObject-derived object to express a pair of Rawmidi stream to which
* substreams are attached. The substream is pointed by the combination of the numeric identifier
* of device, subdevice, and direction. When the call of [method@StreamPair.open] with the
* combination, corresponding substreams are attached to the object. Then the object maintains file
* used.
* @error: A [struct@GLib.Error].
*
- * Get the version of rawmidi protocol currently used. The version is represented as the array with
+ * Get the version of rawmidi protocol currently used. The version is expressed as the array with
* three elements; major, minor, and micro version in the order. The length of major version is
* 16 bit, the length of minor and micro version is 8 bit each.
*
/**
* ALSARawmidiSubstreamInfo:
- * A GObject-derived object to represent information of substream.
+ * A GObject-derived object to express information of substream.
*
- * A [class@SubstreamInfo] is a GObject-derived object to represent information of substream
+ * A [class@SubstreamInfo] is a GObject-derived object to express information of substream
* attached to the pair of streams. The call of [method@StreamPair.get_substream_info] or
* [func@get_substream_info] return the instance of object.
*
/**
* ALSARawmidiSubstreamParams:
- * A GObject-derived object to represent parameters of substream.
+ * A GObject-derived object to express parameters of substream.
*
- * A [class@SubstreamParams] is a GObject-derived object to represent parameters of substream
+ * A [class@SubstreamParams] is a GObject-derived object to express parameters of substream
* attached to the pair of streams. The call of [method@StreamPair.set_substream_params] requires
* the instance of object.
*
/**
* ALSARawmidiSubstreamStatus:
- * A GObject-derived object to represent status of substream.
+ * A GObject-derived object to express status of substream.
*
- * A [class@SubstreamStatus] is a GObject-derived object to represent status of substream attached
+ * A [class@SubstreamStatus] is a GObject-derived object to express status of substream attached
* to the pair of stream. The call of [method@StreamPair.get_substream_status] returns the instance
* of object.
*
/**
* ALSASeqAddr:
- * A boxed object to represent address in ALSA Sequencer.
+ * A boxed object to express address in ALSA Sequencer.
*
- * A [struct@Addr] is a boxed object to represent address in ALSA Sequencer. The address consists
+ * A [struct@Addr] is a boxed object to express address in ALSA Sequencer. The address consists
* of two parts; the numeric ID of client and port.
*
* The object wraps `struct snd_seq_addr` in UAPI of Linux sound subsystem.
/**
* ALSASeqClientInfo:
- * A GObject-derived object to represent information of client.
+ * A GObject-derived object to express information of client.
*
- * A [class@ClientInfo] is a GObject-derived object to represent information of client. The call
+ * A [class@ClientInfo] is a GObject-derived object to express information of client. The call
* of [func@get_client_info] returns the instance of object. The call of
* [method@UserClient.set_info] and [method@UserClient.get_info] require the instance of object.
*
/**
* ALSASeqClientPool:
- * A GObject-derived object to represent information of pool owned by client.
+ * A GObject-derived object to express information of pool owned by client.
*
- * A [class@ClientPool] is a GObject-derived object to represent information of pool owned by
+ * A [class@ClientPool] is a GObject-derived object to express information of pool owned by
* client. The pool consists of a batch of cells to store message contents in kernel space. The
* call of [func@get_client_pool] returns the instance of object. The call of
* [method@UserClient.set_pool]) and [method@UserClient.get_pool] require the instance of object.
/**
* ALSASeqEventDataConnect:
- * A boxed object to represent data of connect event.
+ * A boxed object to express data of connect event.
*
- * A [struct@EventDataConnect] is a boxed object to represent data of connect event. The instance
+ * A [struct@EventDataConnect] is a boxed object to express data of connect event. The instance
* of object is one of data properties in event.
*
* The object wraps `struct snd_seq_connect` in UAPI of Linux sound subsystem.
/**
* ALSASeqEventDataCtl:
- * A boxed object to represent data of control event.
+ * A boxed object to express data of control event.
*
- * A [struct@EventDataCtl] is a boxed object to represent data of control event. The instance of
+ * A [struct@EventDataCtl] is a boxed object to express data of control event. The instance of
* object is one of data properties in event.
*
* The object wraps `struct snd_seq_ev_ctrl` in UAPI of Linux sound subsystem.
/**
* ALSASeqEventDataNote:
- * A boxed object to represent data of note event.
+ * A boxed object to express data of note event.
*
- * A [struct@EventDataNote] is a boxed object to represent data of note event. The instance of
+ * A [struct@EventDataNote] is a boxed object to express data of note event. The instance of
* object is one of data properties in event.
*
* The object wraps `struct snd_seq_ev_note` in UAPI of Linux sound subsystem.
/**
* ALSASeqEventDataQueue:
- * A boxed object to represent data of queue event.
+ * A boxed object to express data of queue event.
*
- * A [struct@EventDataQueue] is a boxed object to represent data of queue event. The instance of
+ * A [struct@EventDataQueue] is a boxed object to express data of queue event. The instance of
* object is one of data properties in event.
*
* The object wraps `struct snd_seq_ev_queue_control` in UAPI of Linux sound subsystem.
/**
* ALSASeqEventDataResult:
- * A boxed object to represent data of result event.
+ * A boxed object to express data of result event.
*
- * A [struct@EventDataResult] is a boxed object to represent data of result event. The instance of
+ * A [struct@EventDataResult] is a boxed object to express data of result event. The instance of
* object is one of data properties in event.
*
* The object wraps `struct snd_seq_result` in UAPI of Linux sound subsystem.
/**
* ALSASeqPortInfo:
- * A GObject-derived object to represent information of port.
+ * A GObject-derived object to express information of port.
*
- * A [class@PortInfo] is a GObject-derived object to represent information of port. The call of
+ * A [class@PortInfo] is a GObject-derived object to express information of port. The call of
* [func@get_port_info] returns the instance of object. The call of [method@UserClient.create_port]
* and [method@UserClient.update_port] requires the instance of object.
*
/**
* ALSASeqQueueInfo:
- * A GObject-derived object to represent information of queue.
+ * A GObject-derived object to express information of queue.
*
- * A [class@QueueInfo] is a GObject-derived object to represent information of queue. The call of
+ * A [class@QueueInfo] is a GObject-derived object to express information of queue. The call of
* [func@get_queue_info_by_id] and [func@get_queue_info_by_name] returns the instance of object.
* The call of [method@UserClient.create_queue] and [method@UserClient.update_queue] requires the
* instance of object.
/**
* ALSASeqQueueStatus:
- * A GObject-derived object to represent status of queue.
+ * A GObject-derived object to express status of queue.
*
- * A [class@QueueStatus] is a GObject-derived object to represent status of queue. The call of
+ * A [class@QueueStatus] is a GObject-derived object to express status of queue. The call of
* [func@get_queue_status] returns the instance of object.
*
* The object wraps `struct snd_seq_queue_status` in UAPI of Linux sound subsystem.
/**
* ALSASeqQueueTempo:
- * A GObject-derived object to represent tempo of queue.
+ * A GObject-derived object to express tempo of queue.
*
- * A [class@QueueTempo] is a GObject-derived object to represent tempo of queue.
+ * A [class@QueueTempo] is a GObject-derived object to express tempo of queue.
*
* The object wraps `struct snd_seq_queue_tempo` in UAPI of Linux sound subsystem.
*/
/**
* ALSASeqRemoveFilter:
- * A boxed object to represent filter to remove scheduled event in queue.
+ * A boxed object to express filter to remove scheduled event in queue.
*
- * A [struct@RemoveFilter] is a boxed object to represent filter to remove scheduled event in
+ * A [struct@RemoveFilter] is a boxed object to express filter to remove scheduled event in
* queue. The call of [method@UserClient.remove_events] requires the instance of object. In the
* object, data shares the same storage, thus it's not possible to use several purposes.
*
/**
* ALSASeqSubscribeData:
- * A GObject-derived object to represent data for subscription between ports.
+ * A GObject-derived object to express data for subscription between ports.
*
- * A [class@SubscribeData] is a GObject-derived object to represent data for subscription between
+ * A [class@SubscribeData] is a GObject-derived object to express data for subscription between
* a pair of ports. The call of [func@get_subscription_list] returns the list of data. The call of
* [method@UserClient.operate_subscription] requires the instance of object.
*
/**
* ALSASeqSystemInfo:
- * A GObject-derived object to represent information of ALSA Sequencer.
+ * A GObject-derived object to express information of ALSA Sequencer.
*
- * A [class@SystemInfo] is a GObject-derived object to represent information of ALSA Sequencer. The
+ * A [class@SystemInfo] is a GObject-derived object to express information of ALSA Sequencer. The
* call of [func@get_system_info] returns the instance of object.
*
* The object wraps `struct snd_seq_system_info` in UAPI of Linux sound subsystem.
/**
* ALSASeqUserClient:
- * A GObject-derived object to represent user client.
+ * A GObject-derived object to express user client.
*
- * A [class@UserClient] is a GObject-derived object to represent user client. Any port can be added
+ * A [class@UserClient] is a GObject-derived object to express user client. Any port can be added
* to the client as destination or source for any event.
*
* When the call of [method@UserClient.open] the object maintain file descriptor till object
* used.
* @error: A [struct@GLib.Error].
*
- * Get the version of sequencer protocol currently used. The version is represented as the array
+ * Get the version of sequencer protocol currently used. The version is expressed as the array
* with three elements; major, minor, and micro version in the order. The length of major version
* is 16 bit, the length of minor and micro version is 8 bit each.
*
/**
* ALSATimerDeviceId:
- * A boxed object to represent the identifier of timer device.
+ * A boxed object to express the identifier of timer device.
*
- * A [struct@DeviceId] is a boxed object to represent the identifier of timer device. The
+ * A [struct@DeviceId] is a boxed object to express the identifier of timer device. The
* identifier mainly consists of the class of timer device. The other members; the numeric ID of
* card, device, and subdevice are optional according to the class of timer device.
*
/**
* ALSATimerDeviceInfo:
- * A GObject-derived object to represent information of timer device.
+ * A GObject-derived object to express information of timer device.
*
- * A [class@DeviceInfo] is a GObject-derived object to represent information of timer device.
+ * A [class@DeviceInfo] is a GObject-derived object to express information of timer device.
* The call of alsatimer_get_device_info() returns an instance of the object according to the
* identifier of timer device.
*
/**
* ALSATimerDeviceParams:
- * A GObject-derived object to represent parameter of timer device.
+ * A GObject-derived object to express parameter of timer device.
*
- * A [class@DeviceParams] is a GObject-derived object to represent parameter of timer device. The
+ * A [class@DeviceParams] is a GObject-derived object to express parameter of timer device. The
* call of alsatimer_set_device_params() requires the instance of object.
*
* The object wraps `struct snd_timer_gparams` in UAPI of Linux sound subsystem.
/**
* ALSATimerDeviceStatus:
- * A GObject-derived object to represent status of timer device.
+ * A GObject-derived object to express status of timer device.
*
- * A [class@DeviceStatus] is a GObject-derived object to represent status of timer device. The
+ * A [class@DeviceStatus] is a GObject-derived object to express status of timer device. The
* call of [func@get_device_status] returns the instance of object.
*
* The object wraps 'struct snd_timer_gstatus' in UAPI of Linux sound subsystem.
/**
* ALSATimerInstanceInfo:
- * A GObject-derived object to represent information of user instance.
+ * A GObject-derived object to express information of user instance.
*
- * A [class@InstanceInfo] is a GObject-derived object to represent information of user instance
+ * A [class@InstanceInfo] is a GObject-derived object to express information of user instance
* attached to any timer device or the other instance as slave. The call of
* [method@UserInstance.get_info] returns the instance of object.
*
/**
* ALSATimerInstanceParams:
- * A GObject-derived object to represent parameters of user instance.
+ * A GObject-derived object to express parameters of user instance.
*
- * A [class@InstanceParams] is a GObject-derived object to represent parameters of user instance
+ * A [class@InstanceParams] is a GObject-derived object to express parameters of user instance
* attached to any timer device or the other instance as slave. The call of
* [method@UserInstance.set_params] requires the instance of object.
*
/**
* ALSATimerInstanceStatus:
- * A GObject-derived object to represent status of user instance.
+ * A GObject-derived object to express status of user instance.
*
* A [class@InstanceStatus] is a GObject-derived object to express status of user instance attached
* to any timer device or the other instance as slave. The call of [method@UserInstance.get_status]
/**
* ALSATimerUserInstance:
- * A GObject-derived object to represent user instance.
+ * A GObject-derived object to express user instance.
*
- * A [class@UserInstance] is a GObject-derived object to represent information of user instance
+ * A [class@UserInstance] is a GObject-derived object to express information of user instance
* attached to any timer device or the other instance as slave. After calling
* [method@UserInstance.open], the object maintains file descriptor till object destruction. After
* calling [method@UserInstance.attach] or [method@UserInstance.attach_as_slave], the user instance
* used.
* @error: A [struct@GLib.Error].
*
- * Get the version of timer protocol currently used. The version is represented as the array with
+ * Get the version of timer protocol currently used. The version is expressed as the array with
* three elements; major, minor, and micro version in the order. The length of major version is
* 16 bit, the length of minor and micro version is 8 bit each.
*
git://git.alsa-project.org / alsa-gobject.git / commitdiff