-rw-r--r-- | libopie/colordialog.cpp | 2 | ||||
-rw-r--r-- | libopie/colordialog.h | 2 | ||||
-rw-r--r-- | libopie/colorpopupmenu.h | 6 | ||||
-rw-r--r-- | libopie/ocheckitem.h | 9 | ||||
-rw-r--r-- | libopie/oclickablelabel.h | 11 | ||||
-rw-r--r-- | libopie/ocolorbutton.h | 6 | ||||
-rw-r--r-- | libopie/odevicebutton.cpp | 4 | ||||
-rw-r--r-- | libopie/ofileselector.h | 17 | ||||
-rw-r--r-- | libopie/ofontselector.h | 3 | ||||
-rw-r--r-- | libopie/oprocess.h | 8 | ||||
-rw-r--r-- | libopie/orecurrancewidget.h | 6 | ||||
-rw-r--r-- | libopie/otabbar.h | 2 | ||||
-rw-r--r-- | libopie/otabinfo.h | 8 | ||||
-rw-r--r-- | libopie/otabwidget.h | 8 | ||||
-rw-r--r-- | libopie/oticker.h | 3 | ||||
-rw-r--r-- | libopie/otimepicker.h | 2 | ||||
-rw-r--r-- | libopie/todayconfigwidget.h | 2 | ||||
-rw-r--r-- | libopie/todayplugininterface.h | 3 |
18 files changed, 75 insertions, 27 deletions
diff --git a/libopie/colordialog.cpp b/libopie/colordialog.cpp index 35f15d6..c7421ec 100644 --- a/libopie/colordialog.cpp +++ b/libopie/colordialog.cpp | |||
@@ -692,7 +692,7 @@ OColorDialogPrivate::OColorDialogPrivate( OColorDialog *dialog ) : | |||
692 | 692 | ||
693 | // BEING REVISED: jo | 693 | // BEING REVISED: jo |
694 | /*! | 694 | /*! |
695 | \class OColorDialog OColorDialog.h | 695 | \class ColorDialog ColorDialog.h |
696 | \brief The OColorDialog class provides a dialog widget for specifying colors. | 696 | \brief The OColorDialog class provides a dialog widget for specifying colors. |
697 | \ingroup dialogs | 697 | \ingroup dialogs |
698 | 698 | ||
diff --git a/libopie/colordialog.h b/libopie/colordialog.h index e9bb7ed..1a6a3fd 100644 --- a/libopie/colordialog.h +++ b/libopie/colordialog.h | |||
@@ -44,7 +44,7 @@ | |||
44 | 44 | ||
45 | class OColorDialogPrivate; | 45 | class OColorDialogPrivate; |
46 | 46 | ||
47 | /** | 47 | /* |
48 | * @class OColorDialog | 48 | * @class OColorDialog |
49 | * @brief The OColorDialog class is a copy of QColorDialog for use in Opie. | 49 | * @brief The OColorDialog class is a copy of QColorDialog for use in Opie. |
50 | * | 50 | * |
diff --git a/libopie/colorpopupmenu.h b/libopie/colorpopupmenu.h index 184b132..3e90c5e 100644 --- a/libopie/colorpopupmenu.h +++ b/libopie/colorpopupmenu.h | |||
@@ -68,7 +68,7 @@ public: | |||
68 | OColorPanelButton(const QColor& color, QWidget* parent = 0, const char* name = 0); | 68 | OColorPanelButton(const QColor& color, QWidget* parent = 0, const char* name = 0); |
69 | 69 | ||
70 | /** | 70 | /** |
71 | * @fn ~ColorPanelButton() | 71 | * @fn ~OColorPanelButton() |
72 | * @brief Object destructor. | 72 | * @brief Object destructor. |
73 | */ | 73 | */ |
74 | ~OColorPanelButton(); | 74 | ~OColorPanelButton(); |
@@ -107,11 +107,11 @@ public: | |||
107 | void leaveEvent(QEvent* e); | 107 | void leaveEvent(QEvent* e); |
108 | 108 | ||
109 | /** | 109 | /** |
110 | * @fn paintEvent( QEvent* e ) | 110 | * @fn paintEvent( QPaintEvent* e ) |
111 | * @brief Reimplemented for internal reasons. | 111 | * @brief Reimplemented for internal reasons. |
112 | * | 112 | * |
113 | * @param e Event currently being processed. | 113 | * @param e Event currently being processed. |
114 | * | 114 | * @reimp |
115 | * Reimplemented to ensure correct display of button. | 115 | * Reimplemented to ensure correct display of button. |
116 | */ | 116 | */ |
117 | void paintEvent(QPaintEvent* e); | 117 | void paintEvent(QPaintEvent* e); |
diff --git a/libopie/ocheckitem.h b/libopie/ocheckitem.h index 2387134..82ee3d0 100644 --- a/libopie/ocheckitem.h +++ b/libopie/ocheckitem.h | |||
@@ -29,15 +29,24 @@ | |||
29 | class OCheckItem : public QTableItem | 29 | class OCheckItem : public QTableItem |
30 | { | 30 | { |
31 | public: | 31 | public: |
32 | /** The size of a box currently unused */ | ||
32 | enum Size { BoxSize = 10 }; | 33 | enum Size { BoxSize = 10 }; |
33 | OCheckItem( QTable *t, const QString &sortkey ); | 34 | OCheckItem( QTable *t, const QString &sortkey ); |
34 | 35 | ||
35 | virtual void setChecked( bool b ); | 36 | virtual void setChecked( bool b ); |
36 | virtual void toggle(); | 37 | virtual void toggle(); |
37 | bool isChecked() const; | 38 | bool isChecked() const; |
39 | /** | ||
40 | * @short Set the sort key | ||
41 | * @reimp | ||
42 | */ | ||
38 | void setKey( const QString &key ) { m_sortKey = key; } | 43 | void setKey( const QString &key ) { m_sortKey = key; } |
39 | virtual QString key() const; | 44 | virtual QString key() const; |
40 | 45 | ||
46 | /** | ||
47 | * foo | ||
48 | * @internal | ||
49 | */ | ||
41 | void paint( QPainter *p, const QColorGroup &cg, const QRect &cr, bool selected ); | 50 | void paint( QPainter *p, const QColorGroup &cg, const QRect &cr, bool selected ); |
42 | 51 | ||
43 | //static const int BoxSize = 10; | 52 | //static const int BoxSize = 10; |
diff --git a/libopie/oclickablelabel.h b/libopie/oclickablelabel.h index 4b6dcbc..6e7a123 100644 --- a/libopie/oclickablelabel.h +++ b/libopie/oclickablelabel.h | |||
@@ -32,14 +32,25 @@ public: | |||
32 | void setToggleButton(bool t); | 32 | void setToggleButton(bool t); |
33 | 33 | ||
34 | protected: | 34 | protected: |
35 | /** @internal */ | ||
35 | void mousePressEvent( QMouseEvent *e ); | 36 | void mousePressEvent( QMouseEvent *e ); |
37 | /** @internal */ | ||
36 | void mouseReleaseEvent( QMouseEvent *e ); | 38 | void mouseReleaseEvent( QMouseEvent *e ); |
39 | /** @internal */ | ||
37 | void mouseMoveEvent( QMouseEvent *e ); | 40 | void mouseMoveEvent( QMouseEvent *e ); |
38 | 41 | ||
39 | public slots: | 42 | public slots: |
40 | void setOn(bool on); | 43 | void setOn(bool on); |
41 | signals: | 44 | signals: |
45 | /** | ||
46 | * emitted when the labels gets clicked | ||
47 | */ | ||
42 | void clicked(); | 48 | void clicked(); |
49 | |||
50 | /** | ||
51 | * emitted when the labels gets toggled | ||
52 | * @param the new new state of the label | ||
53 | */ | ||
43 | void toggled(bool on); | 54 | void toggled(bool on); |
44 | private: | 55 | private: |
45 | bool isToggle : 1; | 56 | bool isToggle : 1; |
diff --git a/libopie/ocolorbutton.h b/libopie/ocolorbutton.h index 338e654..7ff9cd2 100644 --- a/libopie/ocolorbutton.h +++ b/libopie/ocolorbutton.h | |||
@@ -50,12 +50,18 @@ public: | |||
50 | QColor color ( ) const; | 50 | QColor color ( ) const; |
51 | 51 | ||
52 | signals: | 52 | signals: |
53 | /** | ||
54 | * emitted when a color gets selected | ||
55 | */ | ||
53 | void colorSelected ( const QColor & ); | 56 | void colorSelected ( const QColor & ); |
54 | 57 | ||
55 | public slots: | 58 | public slots: |
56 | virtual void setColor ( const QColor & ); | 59 | virtual void setColor ( const QColor & ); |
57 | 60 | ||
58 | protected slots: | 61 | protected slots: |
62 | /** | ||
63 | * @internal | ||
64 | */ | ||
59 | virtual void updateColor ( const QColor & ); | 65 | virtual void updateColor ( const QColor & ); |
60 | 66 | ||
61 | private: | 67 | private: |
diff --git a/libopie/odevicebutton.cpp b/libopie/odevicebutton.cpp index 4b22358..eccb57c 100644 --- a/libopie/odevicebutton.cpp +++ b/libopie/odevicebutton.cpp | |||
@@ -111,8 +111,8 @@ void OQCopMessage::setData ( const QByteArray &data ) | |||
111 | d-> m_data = data; | 111 | d-> m_data = data; |
112 | } | 112 | } |
113 | 113 | ||
114 | /*! \class ODeviceButton | 114 | /*! \class Opie::ODeviceButton |
115 | \brief The ODeviceButton class represents a physical user mappable button on a Qtopia device. | 115 | \brief The Opie::ODeviceButton class represents a physical user mappable button on a Qtopia device. |
116 | 116 | ||
117 | This class represents a physical button on a Qtopia device. A | 117 | This class represents a physical button on a Qtopia device. A |
118 | device may have "user programmable" buttons. | 118 | device may have "user programmable" buttons. |
diff --git a/libopie/ofileselector.h b/libopie/ofileselector.h index 06ac806..d06aa0a 100644 --- a/libopie/ofileselector.h +++ b/libopie/ofileselector.h | |||
@@ -44,13 +44,7 @@ | |||
44 | #include <qpe/applnk.h> | 44 | #include <qpe/applnk.h> |
45 | #include <qlistview.h> | 45 | #include <qlistview.h> |
46 | 46 | ||
47 | /** This is OPIEs FileDialog Widget. You can use it | 47 | |
48 | * as a dropin replacement of the fileselector and | ||
49 | * or use any of the new features. | ||
50 | * This is also a complete FileSave and FileLoad widget | ||
51 | * If you look for a Dialog check OFileDialog | ||
52 | * | ||
53 | */ | ||
54 | class DocLnk; | 48 | class DocLnk; |
55 | class QCheckBox; | 49 | class QCheckBox; |
56 | class QComboBox; | 50 | class QComboBox; |
@@ -69,6 +63,15 @@ class QHBox; | |||
69 | 63 | ||
70 | typedef QMap< QString, QStringList> MimeTypes; | 64 | typedef QMap< QString, QStringList> MimeTypes; |
71 | 65 | ||
66 | /** | ||
67 | * This is OPIEs FileDialog Widget. You can use it | ||
68 | * as a dropin replacement of the fileselector and | ||
69 | * or use any of the new features. | ||
70 | * This is also a complete FileSave and FileLoad widget | ||
71 | * If you look for a Dialog check OFileDialog | ||
72 | * | ||
73 | * NOTE THAT the API will change to be more extendable! | ||
74 | */ | ||
72 | class OFileSelector : public QWidget { | 75 | class OFileSelector : public QWidget { |
73 | Q_OBJECT | 76 | Q_OBJECT |
74 | public: | 77 | public: |
diff --git a/libopie/ofontselector.h b/libopie/ofontselector.h index 95ffd04..b819c45 100644 --- a/libopie/ofontselector.h +++ b/libopie/ofontselector.h | |||
@@ -73,8 +73,11 @@ signals: | |||
73 | void fontSelected ( const QFont & ); | 73 | void fontSelected ( const QFont & ); |
74 | 74 | ||
75 | protected slots: | 75 | protected slots: |
76 | /** @internal */ | ||
76 | virtual void fontFamilyClicked ( int ); | 77 | virtual void fontFamilyClicked ( int ); |
78 | /** @internal */ | ||
77 | virtual void fontStyleClicked ( int ); | 79 | virtual void fontStyleClicked ( int ); |
80 | /** @internal */ | ||
78 | virtual void fontSizeClicked ( int ); | 81 | virtual void fontSizeClicked ( int ); |
79 | 82 | ||
80 | protected: | 83 | protected: |
diff --git a/libopie/oprocess.h b/libopie/oprocess.h index bf5fe0e..f2853b0 100644 --- a/libopie/oprocess.h +++ b/libopie/oprocess.h | |||
@@ -46,7 +46,7 @@ class OProcessPrivate; | |||
46 | * | 46 | * |
47 | * @sect General usage and features | 47 | * @sect General usage and features |
48 | * | 48 | * |
49 | *This class allows a KDE application to start child processes without having | 49 | *This class allows a KDE and OPIE application to start child processes without having |
50 | *to worry about UN*X signal handling issues and zombie process reaping. | 50 | *to worry about UN*X signal handling issues and zombie process reaping. |
51 | * | 51 | * |
52 | *@see KProcIO | 52 | *@see KProcIO |
@@ -188,7 +188,13 @@ public: | |||
188 | * Constructor | 188 | * Constructor |
189 | */ | 189 | */ |
190 | OProcess(QObject *parent = 0, const char *name = 0); | 190 | OProcess(QObject *parent = 0, const char *name = 0); |
191 | /** | ||
192 | * Constructor | ||
193 | */ | ||
191 | OProcess(const QString &arg0, QObject *parent = 0, const char *name = 0); | 194 | OProcess(const QString &arg0, QObject *parent = 0, const char *name = 0); |
195 | /** | ||
196 | * Constructor | ||
197 | */ | ||
192 | OProcess(const QStringList &args, QObject *parent = 0, const char *name = 0); | 198 | OProcess(const QStringList &args, QObject *parent = 0, const char *name = 0); |
193 | 199 | ||
194 | /** | 200 | /** |
diff --git a/libopie/orecurrancewidget.h b/libopie/orecurrancewidget.h index af87ce9..a5d6489 100644 --- a/libopie/orecurrancewidget.h +++ b/libopie/orecurrancewidget.h | |||
@@ -46,7 +46,13 @@ public: | |||
46 | 46 | ||
47 | public slots: | 47 | public slots: |
48 | void slotSetRType( int ); | 48 | void slotSetRType( int ); |
49 | /** | ||
50 | * set the new end date | ||
51 | */ | ||
49 | void endDateChanged( int, int, int ); | 52 | void endDateChanged( int, int, int ); |
53 | /** | ||
54 | * enable/disable end date | ||
55 | */ | ||
50 | void slotNoEnd( bool unused ); | 56 | void slotNoEnd( bool unused ); |
51 | void setStartDate( const QDate& ); | 57 | void setStartDate( const QDate& ); |
52 | void setRecurrence( const ORecur& recur, const QDate& start ); | 58 | void setRecurrence( const ORecur& recur, const QDate& start ); |
diff --git a/libopie/otabbar.h b/libopie/otabbar.h index c413611..0b353e2 100644 --- a/libopie/otabbar.h +++ b/libopie/otabbar.h | |||
@@ -62,7 +62,7 @@ public: | |||
62 | 62 | ||
63 | protected: | 63 | protected: |
64 | /** | 64 | /** |
65 | * @fn paintLabel( QPainter* p, const QRect& br, QTab* t, bool has_focus ) | 65 | * @fn paintLabel( QPainter* p, const QRect& br , QTab* t, bool has_focus)const |
66 | * @brief Internal function to draw a tab's label. | 66 | * @brief Internal function to draw a tab's label. |
67 | * | 67 | * |
68 | * @param p Pointer to QPainter used for drawing. | 68 | * @param p Pointer to QPainter used for drawing. |
diff --git a/libopie/otabinfo.h b/libopie/otabinfo.h index 6589638..eebaf8e 100644 --- a/libopie/otabinfo.h +++ b/libopie/otabinfo.h | |||
@@ -77,13 +77,13 @@ public: | |||
77 | : i( id ), c( control ), p( icon ), l( label ) {} | 77 | : i( id ), c( control ), p( icon ), l( label ) {} |
78 | 78 | ||
79 | /** | 79 | /** |
80 | * @fn id() | 80 | * @fn id()const |
81 | * @brief Returns TabBar ID. | 81 | * @brief Returns TabBar ID. |
82 | */ | 82 | */ |
83 | int id() const { return i; } | 83 | int id() const { return i; } |
84 | 84 | ||
85 | /** | 85 | /** |
86 | * @fn label() | 86 | * @fn label()const |
87 | * @brief Returns text label for widget. | 87 | * @brief Returns text label for widget. |
88 | */ | 88 | */ |
89 | const QString &label() const { return l; } | 89 | const QString &label() const { return l; } |
@@ -97,13 +97,13 @@ public: | |||
97 | void setLabel( const QString &label ) { l = label; } | 97 | void setLabel( const QString &label ) { l = label; } |
98 | 98 | ||
99 | /** | 99 | /** |
100 | * @fn control() | 100 | * @fn control()const |
101 | * @brief Returns pointer to widget. | 101 | * @brief Returns pointer to widget. |
102 | */ | 102 | */ |
103 | QWidget *control() const { return c; } | 103 | QWidget *control() const { return c; } |
104 | 104 | ||
105 | /** | 105 | /** |
106 | * @fn icon() | 106 | * @fn icon()const |
107 | * @brief Returns name of icon file. | 107 | * @brief Returns name of icon file. |
108 | */ | 108 | */ |
109 | const QString &icon() const { return p; } | 109 | const QString &icon() const { return p; } |
diff --git a/libopie/otabwidget.h b/libopie/otabwidget.h index bcd9a85..a67fe06 100644 --- a/libopie/otabwidget.h +++ b/libopie/otabwidget.h | |||
@@ -127,7 +127,7 @@ public: | |||
127 | void removePage( QWidget * ); | 127 | void removePage( QWidget * ); |
128 | 128 | ||
129 | /** | 129 | /** |
130 | * @fn changeTab( QWidget *widget, const QIconSet &icon, const QString &label ) | 130 | * @fn changeTab( QWidget *widget, const QString &icon, const QString &label ) |
131 | * @brief Change text and/or icon for existing tab | 131 | * @brief Change text and/or icon for existing tab |
132 | * | 132 | * |
133 | * @param child Widget control. | 133 | * @param child Widget control. |
@@ -137,7 +137,7 @@ public: | |||
137 | void changeTab( QWidget *, const QString &, const QString & ); | 137 | void changeTab( QWidget *, const QString &, const QString & ); |
138 | 138 | ||
139 | /** | 139 | /** |
140 | * @fn tabStyle() | 140 | * @fn tabStyle()const |
141 | * @brief Returns current widget selection control style. | 141 | * @brief Returns current widget selection control style. |
142 | */ | 142 | */ |
143 | TabStyle tabStyle() const; | 143 | TabStyle tabStyle() const; |
@@ -151,7 +151,7 @@ public: | |||
151 | void setTabStyle( TabStyle ); | 151 | void setTabStyle( TabStyle ); |
152 | 152 | ||
153 | /** | 153 | /** |
154 | * @fn tabPosition() | 154 | * @fn tabPosition()const |
155 | * @brief Returns current widget selection control position. | 155 | * @brief Returns current widget selection control position. |
156 | */ | 156 | */ |
157 | TabPosition tabPosition() const; | 157 | TabPosition tabPosition() const; |
@@ -189,7 +189,7 @@ public: | |||
189 | void setCurrentTab(int); | 189 | void setCurrentTab(int); |
190 | 190 | ||
191 | /** | 191 | /** |
192 | * @fn sizeHint() | 192 | * @fn sizeHint()const |
193 | * @brief Reimplemented for internal purposes. | 193 | * @brief Reimplemented for internal purposes. |
194 | */ | 194 | */ |
195 | QSize sizeHint() const; | 195 | QSize sizeHint() const; |
diff --git a/libopie/oticker.h b/libopie/oticker.h index 30b7517..c848654 100644 --- a/libopie/oticker.h +++ b/libopie/oticker.h | |||
@@ -66,7 +66,7 @@ public: | |||
66 | */ | 66 | */ |
67 | ~OTicker(); | 67 | ~OTicker(); |
68 | /*! | 68 | /*! |
69 | * @fn setText() | 69 | * @fn setText(const QString& ) |
70 | * @brief sets text to be displayed | 70 | * @brief sets text to be displayed |
71 | * @param text QString text to be displayed. | 71 | * @param text QString text to be displayed. |
72 | * | 72 | * |
@@ -78,6 +78,7 @@ public: | |||
78 | * @param color QColor color to be set. | 78 | * @param color QColor color to be set. |
79 | * | 79 | * |
80 | */ | 80 | */ |
81 | //FIXME const QColor& please -zecke | ||
81 | void setBackgroundColor(QColor color); | 82 | void setBackgroundColor(QColor color); |
82 | /*! | 83 | /*! |
83 | * @fn setForegroundColor(QColor color) | 84 | * @fn setForegroundColor(QColor color) |
diff --git a/libopie/otimepicker.h b/libopie/otimepicker.h index 495c806..d501a95 100644 --- a/libopie/otimepicker.h +++ b/libopie/otimepicker.h | |||
@@ -56,7 +56,7 @@ class OTimePicker: public QWidget { | |||
56 | 56 | ||
57 | /** | 57 | /** |
58 | * | 58 | * |
59 | * @short | 59 | * @short A small dialog to pick a time |
60 | * @version 1.0 | 60 | * @version 1.0 |
61 | * @author Stefan Eilers | 61 | * @author Stefan Eilers |
62 | */ | 62 | */ |
diff --git a/libopie/todayconfigwidget.h b/libopie/todayconfigwidget.h index 6b49efc..f3501a1 100644 --- a/libopie/todayconfigwidget.h +++ b/libopie/todayconfigwidget.h | |||
@@ -24,7 +24,7 @@ public: | |||
24 | * gets deleted as in any Qt application | 24 | * gets deleted as in any Qt application |
25 | * | 25 | * |
26 | * @param parent The parent of the widget | 26 | * @param parent The parent of the widget |
27 | * @paran name The name of the object | 27 | * @param name The name of the object |
28 | */ | 28 | */ |
29 | TodayConfigWidget( QWidget *parent, const char *name ) : QWidget( parent, name ) {} ; | 29 | TodayConfigWidget( QWidget *parent, const char *name ) : QWidget( parent, name ) {} ; |
30 | virtual ~TodayConfigWidget() {}; | 30 | virtual ~TodayConfigWidget() {}; |
diff --git a/libopie/todayplugininterface.h b/libopie/todayplugininterface.h index 29a12bc..532f492 100644 --- a/libopie/todayplugininterface.h +++ b/libopie/todayplugininterface.h | |||
@@ -100,6 +100,9 @@ public: | |||
100 | * This is part of the QCOM works. See example plugins how to do it right | 100 | * This is part of the QCOM works. See example plugins how to do it right |
101 | */ | 101 | */ |
102 | struct TodayPluginInterface : public QUnknownInterface { | 102 | struct TodayPluginInterface : public QUnknownInterface { |
103 | /** | ||
104 | * return the TodayPluginObject implementation | ||
105 | */ | ||
103 | virtual TodayPluginObject *guiPart() = 0; | 106 | virtual TodayPluginObject *guiPart() = 0; |
104 | }; | 107 | }; |
105 | 108 | ||