-
-@mainpage libserialport API
-
-Introduction
-============
-
-libserialport is a minimal library written in C that is intended to take care
-of the OS-specific details when writing software that uses serial ports.
-
-By writing your serial code to use libserialport, you enable it to work
-transparently on any platform supported by the library.
-
-The operations that are supported are:
-
-- @ref Enumeration (obtaining a list of serial ports on the system).
-- @ref Ports
-- @ref Configuration (baud rate, parity, etc)
-- @ref Data
-- @ref Errors
-
-libserialport is an open source project released under the LGPL3+ license.
-
-API principles
-==============
-
-The API is simple, and designed to be a minimal wrapper around the serial port
-support in each OS.
-
-Most functions take a pointer to a struct sp_port, which represents a serial
-port. These structures are always allocated and freed by the library, using
-the functions in the @ref Enumeration "Enumeration" section.
-
-All functions can return only three possible error values. SP_ERR_ARG indicates
-the function was called with invalid arguments. SP_ERR_FAIL indicates that the
-OS reported a failure. SP_ERR_MEM indicates that a memory allocation failed.
-All of these error values are negative.
-
-When SP_ERR_FAIL is returned, an error code or string description of the error
-can be obtained by calling sp_last_error_code() or sp_last_error_message(). The
-error code or message is that provided by the OS; libserialport does not define
-any error codes or messages of its own.
-
-Function calls that succeed return SP_OK, which is equal to zero, or where
-otherwise documented a positive value.
-
-*/
+ *
+ * @mainpage libserialport API
+ *
+ * Introduction
+ * ============
+ *
+ * libserialport is a minimal library written in C that is intended to take
+ * care of the OS-specific details when writing software that uses serial ports.
+ *
+ * By writing your serial code to use libserialport, you enable it to work
+ * transparently on any platform supported by the library.
+ *
+ * The operations that are supported are:
+ *
+ * - @ref Enumeration (obtaining a list of serial ports on the system)
+ * - @ref Ports
+ * - @ref Configuration (baud rate, parity, etc.)
+ * - @ref Data
+ * - @ref Errors
+ *
+ * libserialport is an open source project released under the LGPL3+ license.
+ *
+ * API principles
+ * ==============
+ *
+ * The API is simple, and designed to be a minimal wrapper around the serial
+ * port support in each OS.
+ *
+ * Most functions take a pointer to a struct sp_port, which represents a serial
+ * port. These structures are always allocated and freed by the library, using
+ * the functions in the @ref Enumeration "Enumeration" section.
+ *
+ * All functions can return only three possible error values. @ref SP_ERR_ARG
+ * indicates the function was called with invalid arguments. @ref SP_ERR_FAIL
+ * indicates that the OS reported a failure. @ref SP_ERR_MEM indicates that a
+ * memory allocation failed. All of these error values are negative.
+ *
+ * When @ref SP_ERR_FAIL is returned, an error code or string description of
+ * the error can be obtained by calling sp_last_error_code() or
+ * sp_last_error_message(). The error code or message is that provided by the
+ * OS; libserialport does not define any error codes or messages of its own.
+ *
+ * Function calls that succeed return @ref SP_OK, which is equal to zero,
+ * or where otherwise documented a positive value.
+ */