Update of /cvsroot/alsa/alsa-kernel/drivers/mpu401
In directory sc8-pr-cvs1:/tmp/cvs-serv10822/drivers/mpu401

Modified Files:
        mpu401_uart.c 
Log Message:
[PATCH: kerneldoc-comments.dif]

- added/corrected kernel-doc style comments.



Index: mpu401_uart.c
===================================================================
RCS file: /cvsroot/alsa/alsa-kernel/drivers/mpu401/mpu401_uart.c,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- mpu401_uart.c       7 Jan 2003 11:00:46 -0000       1.16
+++ mpu401_uart.c       7 Jan 2003 12:27:46 -0000       1.17
@@ -74,6 +74,14 @@
                snd_mpu401_uart_output_write(mpu);
 }
 
+/**
+ * snd_mpu401_uart_interrupt - generic MPU401-UART interrupt handler
+ * @irq: the irq number
+ * @dev_id: mpu401 instance
+ * @regs: the reigster
+ *
+ * Processes the interrupt for MPU401-UART i/o.
+ */
 void snd_mpu401_uart_interrupt(int irq, void *dev_id, struct pt_regs *regs)
 {
        mpu401_t *mpu = snd_magic_cast(mpu401_t, dev_id, return);
@@ -375,6 +383,25 @@
        snd_magic_kfree(mpu);
 }
 
+/**
+ * snd_mpu401_uart_new - create an MPU401-UART instance
+ * @card: the card instance
+ * @device: the device index, zero-based
+ * @hardware: the hardware type, MPU401_HW_XXXX
+ * @port: the base address of MPU401 port
+ * @integrated: non-zero if the port was already reserved by the chip
+ * @irq: the irq number, -1 if no interrupt for mpu
+ * @irq_flags: the irq request flags (SA_XXX), 0 if irq was already reserved.
+ * @rrawmidi: the pointer to store the new rawmidi instance
+ *
+ * Creates a new MPU-401 instance.
+ *
+ * Note that the rawmidi instance is returned on the rrawmidi argument,
+ * not the mpu401 instance itself.  To access to the mpu401 instance,
+ * cast from rawmidi->private_data (with mpu401_t magic-cast).
+ *
+ * Returns zero if successful, or a negative error code.
+ */
 int snd_mpu401_uart_new(snd_card_t * card, int device,
                        unsigned short hardware,
                        unsigned long port, int integrated,



-------------------------------------------------------
This SF.NET email is sponsored by:
SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See!
http://www.vasoftware.com
_______________________________________________
Alsa-cvslog mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/alsa-cvslog

Reply via email to