added comments for translators

Give translators hints about the meaning of some difficult messages.

diff --git a/src/command.c b/src/command.c
index 09d021c55ef121114877001fa3378af2cd110f5b..c73f26fead3692bcebbf54615513f03b9de28896 100644 (file)
--- a/src/command.c
+++ b/src/command.c
@@ -76,9 +76,9 @@ static command_definition_t cmds[] = {
        { { DWN, 'j', 0 }, 0, CMD_LIST_NEXT, "down",
          N_("Move cursor down") },
        { { HOME, 0x01, 0 }, 0, CMD_LIST_FIRST, "home",
-         N_("Home ") },
+         N_("Home") },
        { { END, 0x05, 0 }, 0, CMD_LIST_LAST, "end",
-         N_("End ") },
+         N_("End") },
        { { PGUP, 0, 0 }, 0, CMD_LIST_PREVIOUS_PAGE, "pgup",
          N_("Page up") },
        { { PGDN, 0, 0 }, 0, CMD_LIST_NEXT_PAGE, "pgdn",
@@ -162,8 +162,12 @@ static command_definition_t cmds[] = {
 
        /* ncmpc options */
        { { 'w', 0, 0 }, 0, CMD_TOGGLE_FIND_WRAP, "wrap-mode",
+         /* translators: toggle between wrapping and non-wrapping
+            search */
          N_("Toggle find mode") },
        { { 'U', 0, 0 }, 0, CMD_TOGGLE_AUTOCENTER, "autocenter-mode",
+         /* translators: the auto center mode always centers the song
+            currently being played */
          N_("Toggle auto center mode") },
 
 
@@ -201,6 +205,8 @@ static command_definition_t cmds[] = {
        { {'7', F7, 0 }, 0, CMD_SCREEN_LYRICS, "screen-lyrics",
          N_("Lyrics screen") },
        { {ESC, 0, 0 }, 0, CMD_INTERRUPT, "lyrics-interrupt",
+         /* translators: interrupt the current background action,
+            e.g. stop loading lyrics from the internet */
          N_("Interrupt action") },
        { {'u', 0, 0 }, 0, CMD_LYRICS_UPDATE, "lyrics-update",
          N_("Update Lyrics") },

diff --git a/src/conf.c b/src/conf.c
index 6d4bf887662f8d9d89796b1426369544bfb68fa3..2b63b9b3623162f1ef4eeca9c40312fec5555b56 100644 (file)
--- a/src/conf.c
+++ b/src/conf.c
@@ -126,6 +126,8 @@ parse_key_definition(char *str)
        while (i < len && str[i] != '=' && !g_ascii_isspace(str[i]))
                buf[j++] = str[i++];
        if( (cmd=get_key_command_from_name(buf)) == CMD_NONE ) {
+               /* the hotkey configuration contains an unknown
+                  command */
                print_error(_("Unknown command"), buf);
                return -1;
        }
@@ -138,6 +140,7 @@ parse_key_definition(char *str)
        memset(buf, 0, MAX_LINE_LENGTH);
        g_strlcpy(buf, str+i, MAX_LINE_LENGTH);
        if (*buf == 0) {
+               /* the hotkey configuration line is incomplete */
                print_error(_("Incomplete hotkey configuration"), str);
                return -1;
        }
@@ -166,6 +169,10 @@ parse_timedisplay_type(const char *str)
        if (!strcmp(str,"elapsed") || !strcmp(str,"remaining"))
                return str;
        else {
+               /* translators: ncmpc supports displaying the
+                  "elapsed" or "remaining" time of a song being
+                  played; in this case, the configuration file
+                  contained an invalid setting */
                print_error(_("Bad time display type"), str);
                return DEFAULT_TIMEDISPLAY_TYPE;
        }
@@ -179,6 +186,8 @@ separate_value(char *p)
 
        value = strchr(p, '=');
        if (value == NULL) {
+               /* an equals sign '=' was expected while parsing a
+                  configuration file line */
                fprintf(stderr, "%s\n", _("Missing '='"));
                return NULL;
        }
@@ -291,6 +300,8 @@ check_screen_list(char *value)
        while( tmp && tmp[i] ) {
                char *name = g_ascii_strdown(tmp[i], -1);
                if (screen_lookup_name(name) == NULL) {
+                       /* an unknown screen name was specified in the
+                          configuration file */
                        print_error(_("Unknown screen name"), name);
                        free(name);
                } else {

diff --git a/src/screen_browser.c b/src/screen_browser.c
index 4d911e0d7a618368f0caa3ab0e1ffd3fff438215..6e1637db4e5b2401409eb6e0d11fb3106222b4f9 100644 (file)
--- a/src/screen_browser.c
+++ b/src/screen_browser.c
@@ -312,6 +312,7 @@ add_directory(mpdclient_t *c, char *dir)
        char *dirname;
 
        dirname = utf8_to_locale(dir);
+       /* translators: a directory is being added the to playlist */
        screen_status_printf(_("Adding directory %s...\n"), dirname);
        doupdate();
        g_free(dirname);

diff --git a/src/screen_file.c b/src/screen_file.c
index d104341679d26093b7cdc4b1c69da9d64cc1e92d..827f16b059129ee48a5ba312046a7021d2d3fde8 100644 (file)
--- a/src/screen_file.c
+++ b/src/screen_file.c
@@ -121,6 +121,9 @@ handle_delete(mpdclient_t *c)
        entity = entry->entity;
 
        if( entity->type!=MPD_INFO_ENTITY_TYPE_PLAYLISTFILE ) {
+               /* translators: the "delete" command is only possible
+                  for playlists; the user attempted to delete a song
+                  or a directory or something else */
                screen_status_printf(_("Deleting this item is not possible"));
                screen_bell();
                return -1;
@@ -133,6 +136,7 @@ handle_delete(mpdclient_t *c)
        key = tolower(screen_getch(screen.status_window.w, buf));
        g_free(buf);
        if( key != YES[0] ) {
+               /* translators: a dialog was aborted by the user */
                screen_status_printf(_("Aborted"));
                return 0;
        }
@@ -140,6 +144,8 @@ handle_delete(mpdclient_t *c)
        if( mpdclient_cmd_delete_playlist(c, plf->path) )
                return -1;
 
+       /* translators: MPD deleted the playlist, as requested by the
+          user */
        screen_status_printf(_("Playlist deleted"));
        return 0;
 }

diff --git a/src/screen_lyrics.c b/src/screen_lyrics.c
index dd0553cb5e5ddb0756b58595557c17f4dcd8ae31..ce11b4473e469fdf033719e513ef7e06d1014be7 100644 (file)
--- a/src/screen_lyrics.c
+++ b/src/screen_lyrics.c
@@ -100,6 +100,7 @@ screen_lyrics_callback(const GString *result, G_GNUC_UNUSED void *data)
        if (result != NULL)
                screen_lyrics_set(result);
        else
+               /* translators: no lyrics were found for the song */
                screen_status_message (_("No lyrics"));
 
        plugin_stop(current.loader);
@@ -199,7 +200,10 @@ lyrics_title(char *str, size_t size)
 {
        if (current.loader != NULL) {
                snprintf(str, size, "%s (%s)",
-                        _("Lyrics"), _("loading..."));
+                        _("Lyrics"),
+                        /* translators: this message is displayed
+                           while data is retrieved */
+                        _("loading..."));
                return str;
        } else if (current.artist != NULL && current.title != NULL &&
                   !screen_text_is_empty(&text)) {
@@ -233,6 +237,7 @@ lyrics_cmd(mpdclient_t *c, command_t cmd)
        case CMD_ADD:
                if (current.loader == NULL && current.artist != NULL &&
                    current.title != NULL && store_lyr_hd() == 0)
+                       /* lyrics for the song were saved on hard disk */
                        screen_status_message (_("Lyrics saved"));
                return true;
        case CMD_LYRICS_UPDATE: