1 files changed, 48 insertions, 7 deletions

diff --git a/library/ir.cpp b/library/ir.cpp
index 68345d1..a7cf7b1 100644
--- a/library/ir.cpp
+++ b/library/ir.cpp
@@ -1 +1,21 @@
+/**********************************************************************
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
+**
+** This file is part of the Qtopia Environment.
+**
+** This file may be distributed and/or modified under the terms of the
+** GNU General Public License version 2 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.
+**
+** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+**
+** See http://www.trolltech.com/gpl/ for GPL licensing information.
+**
+** Contact info@trolltech.com if any conditions of this licensing are
+** not clear to you.
+**
+**********************************************************************/
+
 #include "ir.h"
@@ -3,4 +23,6 @@
 #include <qstring.h>
+#ifdef QWS
 #include "qcopenvelope_qws.h"
 #include <qcopchannel_qws.h>
+#endif
 #include "applnk.h"
@@ -12,3 +34,11 @@
   
-  The Ir class is a small helper class to enable sending of objects over an infrared communication link.
+  Both \link doclnk.html DocLnk\endlink objects and files can be
+  sent to another device via the infrared link using the send()
+  function. When the send has completed the done() signal is
+  emitted.
+
+  The supported() function returns whether the device supports
+  infrared communication or not.
+
+  \ingroup qtopiaemb
 */
@@ -22,2 +52,3 @@ Ir::Ir( QObject *parent, const char *name )
 {
+#ifndef QT_NO_COP
     ch = new QCopChannel( "QPE/Obex" );
@@ -25,2 +56,3 @@ Ir::Ir( QObject *parent, const char *name )
              this, SLOT(obexMessage( const QCString &, const QByteArray &)) );
+#endif
 }
@@ -28,3 +60,4 @@ Ir::Ir( QObject *parent, const char *name )
 /*! 
-  Returns TRUE if the system supports infrared communication.
+  Returns TRUE if the system supports infrared communication;
+  otherwise returns FALSE.
 */
@@ -32,3 +65,5 @@ bool Ir::supported()
 {
+#ifndef QT_NO_COP
     return QCopChannel::isRegistered( "QPE/Obex" );
+#endif
 }
@@ -36,7 +71,9 @@ bool Ir::supported()
 /*!
-  Send the object in the file \a fn over the infrared link.
-  The \a description will be shown to the user while
-  sending is in progress.
-  The optional \a mimetype parameter specifies the mimetype of the object. If this parameter is not
-  set, it will be determined by the extension of the filename.
+  Sends the object in file \a fn over the infrared link. The \a
+  description is used in the text shown to the user while sending
+  is in progress. The optional \a mimetype parameter specifies the
+  mimetype of the object. If this parameter is not set, it is
+  determined by the the filename's suffix.
+
+  \sa done()
 */
@@ -46,4 +83,6 @@ void Ir::send( const QString &fn, const QString &description, const QString &mim
     filename = fn;
+#ifndef QT_NO_COP
     QCopEnvelope e("QPE/Obex", "send(QString,QString,QString)");
     e << description << filename << mimetype;
+#endif
 }
@@ -54,2 +93,4 @@ void Ir::send( const QString &fn, const QString &description, const QString &mim
   Uses the DocLnk::file() and DocLnk::type() of \a doc.
+
+  \sa done()
 */