dbus/dbus-message.c

   1 /* -*- mode: C; c-file-style: "gnu" -*- */
   2 /* dbus-message.c  DBusMessage object
   3  *
   4  * Copyright (C) 2002  Red Hat Inc.
   5  *
   6  * Licensed under the Academic Free License version 1.2
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  *
  22  */
  23
  24 #include "dbus-message.h"
  25
  26 /**
  27  * @defgroup DBusMessageInternals DBusMessage implementation details
  28  * @ingroup DBusInternals
  29  * @brief DBusMessage private implementation details.
  30  *
  31  * The guts of DBusMessage and its methods.
  32  *
  33  * @{
  34  */
  35
  36 /**
  37  * Object representing a message received from or to be sent to
  38  * another application. This is an opaque object, all members
  39  * are private.
  40  */
  41 struct DBusMessage
  42 {
  43   int refcount; /**< Reference count */
  44
  45 };
  46
  47 /** @} */
  48
  49 /**
  50  * @defgroup DBusMessage DBusMessage
  51  * @ingroup  DBus
  52  * @brief DBusMessage object
  53  *
  54  * Types and functions related to the DBusMessage object.
  55  *
  56  * @{
  57  */
  58
  59 /**
  60  * @typedef DBusMessage
  61  *
  62  * Opaque data type representing a message received from or to be
  63  * sent to another application.
  64  */
  65
  66 /**
  67  * Constructs a new message.
  68  * @return a new DBusMessage, free with dbus_message_unref()
  69  * @see dbus_message_unref()
  70  */
  71 DBusMessage*
  72 dbus_message_new (void)
  73 {
  74
  75   return NULL;
  76 }
  77
  78
  79 /**
  80  * Increments the reference count of a DBusMessage.
  81  *
  82  * @param message The message
  83  * @see dbus_message_unref
  84  */
  85 void
  86 dbus_message_ref (DBusMessage *message)
  87 {
  88
  89 }
  90
  91 /**
  92  * Decrements the reference count of a DBusMessage.
  93  *
  94  * @param message The message
  95  * @see dbus_message_ref
  96  */
  97 void
  98 dbus_message_unref (DBusMessage *message)
  99 {
 100
 101
 102 }
 103
 104 /** @} */