From: Andre Noll <maan@systemlinux.org>
Date: Wed, 4 Sep 2013 20:05:00 +0000 (+0000)
Subject: score: Improve documentation of score_update().
X-Git-Tag: v0.5.1~12^2~8
X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=commitdiff_plain;h=0ba6319436121431d8c74249c70285458a666996

score: Improve documentation of score_update().

Remove a stray "and" and the list of possible errors, which is not
very useful and possibly incomplete.
---

diff --git a/score.c b/score.c
index ca94e8de..37f4c550 100644
--- a/score.c
+++ b/score.c
@@ -168,13 +168,11 @@ static int get_nth_score(unsigned n, long *score)
  * \param aft_row Determines the audio file to change.
  * \param percent The position to re-insert the audio file.
  *
- * The percent parameter must be between \p 0 and 100 and. A value of zero
- * means to re-insert the audio file into the score table with a score lower
- * than any other admissible file.
+ * The percent parameter must be between 0 and 100. A value of zero means to
+ * re-insert the audio file into the score table with a score lower than any
+ * other admissible file.
  *
- * \return Positive on success, negative on errors. Possible errors: Errors
- * returned by osl_get_row(), get_num_admissible_files(), osl_get_nth_row(),
- * osl_get_object(), osl_update_object().
+ * \return Positive on success, negative on errors.
  */
 int score_update(const struct osl_row *aft_row, long percent)
 {