fabs/i3ipcpp
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Doc-comments fix

Browse Source
This commit is contained in:
Sergey Naumov
2016-04-21 06:55:26 +03:00
parent abe80f965e
commit b6f819cf42
2 changed files with 48 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
include/i3ipc++/ipc-util.hpp
View File

@@ -23,9 +23,9 @@ namespace i3ipc {
*/ */
struct header_t { struct header_t {
/* 6 = strlen(I3_IPC_MAGIC) */ /* 6 = strlen(I3_IPC_MAGIC) */
char magic[6]; /**< Magic string @see I3_IPC_MAGIC */ char magic[6]; ///< Magic string @see I3_IPC_MAGIC
uint32_t size; /**< Size of payload */ uint32_t size; ///< Size of payload
uint32_t type; /**< Message type */ uint32_t type; ///< Message type
} __attribute__ ((packed)); } __attribute__ ((packed));
@@ -84,8 +84,8 @@ enum class ReplyType : uint32_t {
* @brief i3 IPC message buffer * @brief i3 IPC message buffer
*/ */
struct buf_t { struct buf_t {
uint32_t size; /**< @brief Size of whole buffer */ uint32_t size; ///< @brief Size of whole buffer
uint8_t* data; /**< @brief Pointer to the message */ uint8_t* data; ///< @brief Pointer to the message
/** /**
* @brief i3 IPC message header * @brief i3 IPC message header

86
include/i3ipc++/ipc.hpp
View File

@@ -27,44 +27,44 @@ std::string get_socketpath();
* Primitive of rectangle * Primitive of rectangle
*/ */
struct rect_t { struct rect_t {
int x; /**< Position on X axis */ int x; ///< Position on X axis
int y; /**< Position on Y axis */ int y; ///< Position on Y axis
int width; /**< Width of rectangle */ int width; ///< Width of rectangle
int height; /**< Height of rectangle */ int height; ///< Height of rectangle
}; };
/** /**
* i3's workspace * i3's workspace
*/ */
struct workspace_t { struct workspace_t {
int num; /**< Index of the worksapce */ int num; ///< Index of the worksapce
std::string name; /**< Name of the workspace */ std::string name; ///< Name of the workspace
bool visible; /**< Is the workspace visible */ bool visible; ///< Is the workspace visible
bool focused; /**< Is the workspace is currently focused */ bool focused; ///< Is the workspace is currently focused
bool urgent; /**< Is the workspace is urgent */ bool urgent; ///< Is the workspace is urgent
rect_t rect; /**< A size of the workspace */ rect_t rect; ///< A size of the workspace
std::string output; /**< An output of the workspace */ std::string output; ///< An output of the workspace
}; };
/** /**
* i3's output * i3's output
*/ */
struct output_t { struct output_t {
std::string name; /**< Name of the output */ std::string name; ///< Name of the output
bool active; /**< Is the output currently active */ bool active; ///< Is the output currently active
std::string current_workspace; /**< Name of current workspace */ std::string current_workspace; ///< Name of current workspace
rect_t rect; /**< Size of the output */ rect_t rect; ///< Size of the output
}; };
/** /**
* Version of i3 * Version of i3
*/ */
struct version_t { struct version_t {
std::string human_readable; /**< Human redable version string */ std::string human_readable; ///< Human redable version string
std::string loaded_config_file_name; /**< Path to current config of i3 */ std::string loaded_config_file_name; ///< Path to current config of i3
uint32_t major; /**< Major version of i3 */ uint32_t major; ///< Major version of i3
uint32_t minor; /**< Minor version of i3 */ uint32_t minor; ///< Minor version of i3
uint32_t patch; /**< Patch number of i3 */ uint32_t patch; ///< Patch number of i3
}; };
@@ -72,35 +72,35 @@ struct version_t {
* Types of the events of i3 * Types of the events of i3
*/ */
enum EventType { enum EventType {
ET_WORKSPACE = (1 << 0), /**< Workspace event */ ET_WORKSPACE = (1 << 0), ///< Workspace event
ET_OUTPUT = (1 << 1), /**< Output event */ ET_OUTPUT = (1 << 1), ///< Output event
ET_MODE = (1 << 2), /**< Output mode event */ ET_MODE = (1 << 2), ///< Output mode event
ET_WINDOW = (1 << 3), /**< Window event */ ET_WINDOW = (1 << 3), ///< Window event
ET_BARCONFIG_UPDATE = (1 << 4), /**< Bar config update event @attention Yet is not implemented as signal in I3Connection */ ET_BARCONFIG_UPDATE = (1 << 4), ///< Bar config update event @attention Yet is not implemented as signal in I3Connection
}; };
/** /**
* Types of workspace events * Types of workspace events
*/ */
enum class WorkspaceEventType : char { enum class WorkspaceEventType : char {
FOCUS = 'f', /**< Focused */ FOCUS = 'f', ///< Focused
INIT = 'i', /**< Initialized */ INIT = 'i', ///< Initialized
EMPTY = 'e', /**< Became empty */ EMPTY = 'e', ///< Became empty
URGENT = 'u', /**< Became urgent */ URGENT = 'u', ///< Became urgent
}; };
/** /**
* Types of window events * Types of window events
*/ */
enum class WindowEventType : char { enum class WindowEventType : char {
NEW = 'n', /**< Window created */ NEW = 'n', ///< Window created
CLOSE = 'c', /**< Window closed */ CLOSE = 'c', ///< Window closed
FOCUS = 'f', /**< Window got focus */ FOCUS = 'f', ///< Window got focus
TITLE = 't', /**< Title of window has been changed */ TITLE = 't', ///< Title of window has been changed
FULLSCREEN_MODE = 'F', /**< Window toggled to fullscreen mode */ FULLSCREEN_MODE = 'F', ///< Window toggled to fullscreen mode
MOVE = 'M', /**< Window moved */ MOVE = 'M', ///< Window moved
FLOATING = '_', /**< Window toggled floating mode */ FLOATING = '_', ///< Window toggled floating mode
URGENT = 'u', /**< Window became urgent */ URGENT = 'u', ///< Window became urgent
}; };
@@ -226,12 +226,12 @@ public:
*/ */
void handle_event(); void handle_event();
sigc::signal<void, WorkspaceEventType> signal_workspace_event; /**< Workspace event signal */ sigc::signal<void, WorkspaceEventType> signal_workspace_event; ///< Workspace event signal
sigc::signal<void> signal_output_event; /**< Output event signal */ sigc::signal<void> signal_output_event; ///< Output event signal
sigc::signal<void> signal_mode_event; /**< Output mode event signal */ sigc::signal<void> signal_mode_event; ///< Output mode event signal
sigc::signal<void, WindowEventType> signal_window_event; /**< Window event signal */ sigc::signal<void, WindowEventType> signal_window_event; ///< Window event signal
sigc::signal<void> signal_barconfig_update_event; /**< Barconfig update event signal */ sigc::signal<void> signal_barconfig_update_event; ///< Barconfig update event signal
sigc::signal<void, EventType, const std::shared_ptr<const buf_t>&> signal_event; /**< i3 event signal @note Default handler routes event to signal according to type */ sigc::signal<void, EventType, const std::shared_ptr<const buf_t>&> signal_event; ///< i3 event signal @note Default handler routes event to signal according to type
private: private:
const int32_t m_main_socket; const int32_t m_main_socket;
int32_t m_event_socket; int32_t m_event_socket;