Skip to content

Commit 61d9aba

Browse files
authored
Merge pull request xbmc#29134 from darkdi/doc-param-names
[Doxygen] Fix \param names that do not match the argument
2 parents 90d59e5 + c73e10f commit 61d9aba

2 files changed

Lines changed: 11 additions & 11 deletions

File tree

xbmc/PlayListPlayer.h

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ class CPlayListPlayer : public IMsgTargetCallback,
9090
int GetNextItemIdx(int offset) const;
9191

9292
/*! \brief Set the active playlist
93-
\param id Id of playlist
93+
\param playlistId Id of playlist
9494
\sa GetCurrentPlaylist
9595
*/
9696
void SetCurrentPlaylist(Id playlistId);
@@ -102,7 +102,7 @@ class CPlayListPlayer : public IMsgTargetCallback,
102102
Id GetCurrentPlaylist() const;
103103

104104
/*! \brief Get a particular playlist object
105-
\param id Id of playlist
105+
\param playlistId Id of playlist
106106
\return A reference to the CPlayList object.
107107
\sa GetCurrentPlaylist
108108
*/
@@ -125,7 +125,7 @@ class CPlayListPlayer : public IMsgTargetCallback,
125125
/*! \brief Set shuffle state of a playlist.
126126
If the shuffle state changes, the playlist is shuffled or unshuffled.
127127
Has no effect if Party Mode is enabled.
128-
\param playlist the playlist to (un)shuffle, PLAYLIST::TYPE_MUSIC or PLAYLIST::TYPE_VIDEO.
128+
\param playlistId the playlist to (un)shuffle, PLAYLIST::TYPE_MUSIC or PLAYLIST::TYPE_VIDEO.
129129
\param shuffle set true to shuffle, false to unshuffle.
130130
\param notify notify the user with a Toast notification (defaults to false)
131131
\sa IsShuffled
@@ -134,7 +134,7 @@ class CPlayListPlayer : public IMsgTargetCallback,
134134

135135
/*! \brief Return whether a playlist is shuffled.
136136
If partymode is enabled, this always returns false.
137-
\param playlist the playlist to query for shuffle state, PLAYLIST::TYPE_MUSIC or PLAYLIST::TYPE_VIDEO.
137+
\param playlistId the playlist to query for shuffle state, PLAYLIST::TYPE_MUSIC or PLAYLIST::TYPE_VIDEO.
138138
\return true if the given playlist is shuffled and party mode isn't enabled, false otherwise.
139139
\sa SetShuffle
140140
*/
@@ -147,7 +147,7 @@ class CPlayListPlayer : public IMsgTargetCallback,
147147

148148
/*! \brief Set repeat state of a playlist.
149149
If called while in Party Mode, repeat is disabled.
150-
\param playlist the playlist to set repeat state for, PLAYLIST::TYPE_MUSIC or PLAYLIST::TYPE_VIDEO.
150+
\param playlistId the playlist to set repeat state for, PLAYLIST::TYPE_MUSIC or PLAYLIST::TYPE_VIDEO.
151151
\param state set to RepeatState::NONE, RepeatState::ONE or RepeatState::ALL
152152
\param notify notify the user with a Toast notification
153153
\sa GetRepeat
@@ -171,13 +171,13 @@ class CPlayListPlayer : public IMsgTargetCallback,
171171

172172
protected:
173173
/*! \brief Returns true if the given is set to repeat all
174-
\param playlist Playlist to be query
174+
\param playlistId Playlist to be query
175175
\return true if the given playlist is set to repeat all, false otherwise.
176176
*/
177177
bool Repeated(Id playlistId) const;
178178

179179
/*! \brief Returns true if the given is set to repeat one
180-
\param playlist Playlist to be query
180+
\param playlistId Playlist to be query
181181
\return true if the given playlist is set to repeat one, false otherwise.
182182
*/
183183
bool RepeatedOne(Id playlistId) const;

xbmc/TextureCache.h

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -147,7 +147,7 @@ class CTextureCache : public CJobQueue, public CPowerState
147147
void ClearCachedImage(const std::string &image, bool deleteSource = false);
148148

149149
/*! \brief clear the cached version of the image with given id
150-
\param database id of the image
150+
\param textureID id of the image
151151
\sa GetCachedImage
152152
*/
153153
bool ClearCachedImage(int textureID);
@@ -206,15 +206,15 @@ class CTextureCache : public CJobQueue, public CPowerState
206206

207207
/*! \brief Get an image from the database
208208
Thread-safe wrapper of CTextureDatabase::GetCachedTexture
209-
\param image url of the original image
209+
\param url url of the original image
210210
\param details [out] texture details from the database (if available)
211211
\return true if we have a cached version of this image, false otherwise.
212212
*/
213213
bool GetCachedTexture(const std::string &url, CTextureDetails &details);
214214

215215
/*! \brief Clear an image from the database
216216
Thread-safe wrapper of CTextureDatabase::ClearCachedTexture
217-
\param image url of the original image
217+
\param url url of the original image
218218
\param cacheFile [out] url of the cached original (if available)
219219
\return true if we had a cached version of this image, false otherwise.
220220
*/
@@ -229,7 +229,7 @@ class CTextureCache : public CJobQueue, public CPowerState
229229

230230
/*! \brief Set a previously cached texture as valid in the database
231231
Thread-safe wrapper of CTextureDatabase::SetCachedTextureValid
232-
\param image url of the original image
232+
\param url url of the original image
233233
\param updateable whether this image should be checked for updates
234234
\return true if successful, false otherwise.
235235
*/

0 commit comments

Comments
 (0)