Cosmetics.
[selector.git] / selector.c
index 7dc1848..d7e0820 100644 (file)
@@ -67,7 +67,7 @@ int attr_modeline, attr_focus_line, attr_error;
 
 /*********************************************************************/
 
-void inject_into_tty_buffer(char *string) {
+void inject_into_tty_buffer(char *string, int add_control_qs) {
   struct termios oldtio, newtio;
   const char *k;
   const char control_q = '\021';
@@ -111,7 +111,9 @@ int string_to_positive_integer(char *string) {
   } else error = 1;
 
   if(error) {
-    fprintf(stderr, "Selector: Value `%s' is not a positive integer.\n", string);
+    fprintf(stderr,
+            "Selector: Value `%s' is not a positive integer.\n",
+            string);
     exit(1);
   }
 
@@ -126,11 +128,13 @@ void error_feedback() {
   }
 }
 
+/*********************************************************************/
+
 /* A quick and dirty hash table */
 
-/* The table itself stores indexes of the strings taken in a char
-   **table. When a string is added, if it was already in the table,
-   **the new index replaces the previous one.  */
+/* The table itself stores indexes of the strings taken in a char**
+   table. When a string is added, if it was already in the table, the
+   new index replaces the previous one.  */
 
 typedef struct {
   int size;
@@ -248,7 +252,8 @@ void initialize_matcher(int use_regexp, int case_sensitive,
 
   if(use_regexp) {
     matcher->nb_patterns = -1;
-    matcher->regexp_error = regcomp(&matcher->preg, pattern, case_sensitive ? 0 : REG_ICASE);
+    matcher->regexp_error = regcomp(&matcher->preg, pattern,
+                                    case_sensitive ? 0 : REG_ICASE);
   } else {
     matcher->regexp_error = 0;
     matcher->nb_patterns = 1;
@@ -260,8 +265,11 @@ void initialize_matcher(int use_regexp, int case_sensitive,
       }
     }
 
-    matcher->splitted_patterns = (char *) malloc((strlen(pattern) + 1) * sizeof(char));
-    matcher->patterns = (char **) malloc(matcher->nb_patterns * sizeof(char *));
+    matcher->splitted_patterns =
+      (char *) malloc((strlen(pattern) + 1) * sizeof(char));
+
+    matcher->patterns =
+      (char **) malloc(matcher->nb_patterns * sizeof(char *));
 
     strcpy(matcher->splitted_patterns, pattern);
 
@@ -338,13 +346,15 @@ void kill_after_cursor(char *buffer, int *position) {
 
 /*********************************************************************/
 
-int previous_visible(int current_line, int nb_lines, char **lines, matcher_t *matcher) {
+int previous_visible(int current_line, int nb_lines, char **lines,
+                     matcher_t *matcher) {
   int line = current_line - 1;
   while(line >= 0 && !match(lines[line], matcher)) line--;
   return line;
 }
 
-int next_visible(int current_line, int nb_lines, char **lines, matcher_t *matcher) {
+int next_visible(int current_line, int nb_lines, char **lines,
+                 matcher_t *matcher) {
   int line = current_line + 1;
   while(line < nb_lines && !match(lines[line], matcher)) line++;
 
@@ -356,15 +366,14 @@ int next_visible(int current_line, int nb_lines, char **lines, matcher_t *matche
 
 /*********************************************************************/
 
-/* The value passed to this routine in current_focus_line is the index
-   of the line we should have highlighted if there was no motion and if
-   it matched the matcher. So, the line actually highlighted is the
-   first one matching the matcher in that order: (1)
-   current_focus_line after motion, (2) the first with a greater
-   index, (3) the first with a lesser index.
+/* The line highlighted is the first one matching the matcher in that
+   order: (1) current_focus_line after motion, if it does not match,
+   then (2) the first with a greater index, if none matches, then (3)
+   the first with a lesser index.
 
    The index of the line actually shown highlighted is written in
-   displayed_focus_line (it can be -1)
+   displayed_focus_line (it can be -1 if no line at all matches the
+   matcher)
 
    If there is a motion and a line is actually shown highlighted, its
    value is written in current_focus_line. */
@@ -389,22 +398,30 @@ void update_screen(int *current_focus_line, int *displayed_focus_line,
 
   use_default_colors();
 
+  /* Add an empty line where we will print the modeline at the end */
+
   addstr("\n");
 
-  /* First, we find a visible line. */
+  /* If the regexp is erroneous, print a message saying so */
 
   if(matcher.regexp_error) {
     attron(attr_error);
     addnstr("Regexp syntax error", console_width);
     attroff(attr_error);
-  } else if(nb_lines > 0) {
+  }
+
+  /* Else, and we do have lines to select from, find a visible line. */
+
+  else if(nb_lines > 0) {
     int new_focus_line;
     if(match(lines[*current_focus_line], &matcher)) {
       new_focus_line = *current_focus_line;
     } else {
-      new_focus_line = next_visible(*current_focus_line, nb_lines, lines, &matcher);
+      new_focus_line = next_visible(*current_focus_line, nb_lines, lines,
+                                    &matcher);
       if(new_focus_line < 0) {
-        new_focus_line = previous_visible(*current_focus_line, nb_lines, lines, &matcher);
+        new_focus_line = previous_visible(*current_focus_line, nb_lines, lines,
+                                          &matcher);
       }
     }
 
@@ -431,17 +448,20 @@ void update_screen(int *current_focus_line, int *displayed_focus_line,
       }
     }
 
-    /* Here new_focus_line is either a line number matching the pattern, or -1 */
+    /* Here new_focus_line is either a line number matching the
+       pattern, or -1 */
 
     if(new_focus_line >= 0) {
 
-      int first_line = new_focus_line, last_line = new_focus_line, nb_match = 1;
+      int first_line = new_focus_line, last_line = new_focus_line;
+      int nb_match = 1;
 
       /* We find the first and last line to show, so that the total of
          visible lines between them (them included) is
          console_height-1 */
 
-      while(nb_match < console_height-1 && (first_line > 0 || last_line < nb_lines - 1)) {
+      while(nb_match < console_height-1 &&
+            (first_line > 0 || last_line < nb_lines - 1)) {
 
         if(first_line > 0) {
           first_line--;
@@ -519,7 +539,11 @@ void update_screen(int *current_focus_line, int *displayed_focus_line,
       addnstr("No selection", console_width);
       attroff(attr_error);
     }
-  } else {
+  }
+
+  /* Else, print a message saying that there are no lines to select from */
+
+  else {
     attron(attr_error);
     addnstr("Empty choice", console_width);
     attroff(attr_error);
@@ -563,6 +587,9 @@ void update_screen(int *current_focus_line, int *displayed_focus_line,
     addstr(" ");
   }
 
+  /* Add a few info about the mode we are in (regexp and/or case
+     sensitive) */
+
   if(use_regexp || case_sensitive) {
     addstr(" [");
     if(use_regexp) {
@@ -591,37 +618,38 @@ void update_screen(int *current_focus_line, int *displayed_focus_line,
 /*********************************************************************/
 
 void store_line(hash_table_t *hash_table,
-                const char *t,
-                int nb_lines_max, int *nb_lines, char **lines) {
+                const char *new_line,
+                int *nb_lines, char **lines) {
   int dup;
 
   /* Remove the zsh history prefix */
 
-  if(zsh_history && *t == ':') {
-    while(*t && *t != ';') t++;
-    if(*t == ';') t++;
+  if(zsh_history && *new_line == ':') {
+    while(*new_line && *new_line != ';') new_line++;
+    if(*new_line == ';') new_line++;
   }
 
   /* Remove the bash history prefix */
 
   if(bash_history) {
-    while(*t == ' ') t++;
-    while(*t >= '0' && *t <= '9') t++;
-    while(*t == ' ') t++;
+    while(*new_line == ' ') new_line++;
+    while(*new_line >= '0' && *new_line <= '9') new_line++;
+    while(*new_line == ' ') new_line++;
   }
 
   /* Check for duplicates with the hash table and insert the line in
      the list if necessary */
 
   if(hash_table) {
-    dup = add_and_get_previous_index(hash_table, t, *nb_lines, lines);
+    dup = add_and_get_previous_index(hash_table,
+                                     new_line, *nb_lines, lines);
   } else {
     dup = -1;
   }
 
   if(dup < 0) {
-    lines[*nb_lines] = (char *) malloc((strlen(t) + 1) * sizeof(char));
-    strcpy(lines[*nb_lines], t);
+    lines[*nb_lines] = (char *) malloc((strlen(new_line) + 1) * sizeof(char));
+    strcpy(lines[*nb_lines], new_line);
   } else {
     /* The string was already in there, so we do not allocate a new
        string but use the pointer to the first occurence of it */
@@ -637,7 +665,7 @@ void read_file(hash_table_t *hash_table,
                int nb_lines_max, int *nb_lines, char **lines) {
 
   char raw_line[BUFFER_SIZE];
-  int start, end, k;
+  int start, end, eol, k;
   FILE *file;
 
   file = fopen(input_filename, "r");
@@ -651,9 +679,15 @@ void read_file(hash_table_t *hash_table,
   end = 0;
 
   while(*nb_lines < nb_lines_max && (end > start || !feof(file))) {
-    int eol = start;
+    eol = start;
+
+    /* Look for the end of a line in what is already in the buffer */
     while(eol < end && raw_line[eol] != '\n') eol++;
 
+    /* if we did not find the of a line, move what has not been
+       processed and is in the buffer to the beginning of the buffer,
+       fill the buffer with new data from the file, and look for the
+       end of a line */
     if(eol == end) {
       for(k = 0; k < end - start; k++) {
         raw_line[k] = raw_line[k + start];
@@ -665,18 +699,25 @@ void read_file(hash_table_t *hash_table,
       while(eol < end && raw_line[eol] != '\n') eol++;
     }
 
+    /* The end of the line is the buffer size, which means the line is
+       too long */
+
     if(eol == BUFFER_SIZE) {
       raw_line[BUFFER_SIZE - 1] = '\0';
-      fprintf(stderr, "Selector: Line too long (max is %d characters):\n", BUFFER_SIZE);
+      fprintf(stderr, "Selector: Line too long (max is %d characters):\n",
+              BUFFER_SIZE);
       fprintf(stderr, raw_line);
       fprintf(stderr, "\n");
       exit(1);
     }
 
+    /* If we got a line, we replace the carriage return by a \0 to
+       finish the string */
+
     raw_line[eol] = '\0';
 
     store_line(hash_table, raw_line + start,
-               nb_lines_max, nb_lines, lines);
+               nb_lines, lines);
 
     start = eol + 1;
   }
@@ -720,7 +761,10 @@ int main(int argc, char **argv) {
   strcpy(output_filename, "");
 
   i = 1;
-  while(!error && !show_help && i < argc && argv[i][0] == '-' && !rest_are_files) {
+
+  while(!error && !show_help &&
+        i < argc && argv[i][0] == '-' &&
+        !rest_are_files) {
 
     if(strcmp(argv[i], "-o") == 0) {
       check_opt(argc, argv, i, 1, "<output filename>");
@@ -811,7 +855,8 @@ int main(int argc, char **argv) {
     }
 
     else if(strcmp(argv[i], "-c") == 0) {
-      check_opt(argc, argv, i, 4, "<fg modeline> <bg modeline> <fg highlight> <bg highlight>");
+      check_opt(argc, argv, i, 4,
+                "<fg modeline> <bg modeline> <fg highlight> <bg highlight>");
       color_fg_modeline = string_to_positive_integer(argv[i + 1]);
       color_bg_modeline = string_to_positive_integer(argv[i + 2]);
       color_fg_highlight = string_to_positive_integer(argv[i + 3]);
@@ -846,7 +891,8 @@ int main(int argc, char **argv) {
     fprintf(out, "Selector version %s-R%s\n", VERSION, REVISION_NUMBER);
     fprintf(out, "Written by Francois Fleuret <francois@fleuret.org>.\n");
     fprintf(out, "\n");
-    fprintf(out, "Usage: %s [options] [<filename1> [<filename2> ...]]\n", argv[0]);
+    fprintf(out, "Usage: %s [options] [<filename1> [<filename2> ...]]\n",
+            argv[0]);
     fprintf(out, "\n");
     fprintf(out, " -h      show this help\n");
     fprintf(out, " -v      inject the selected line in the tty\n");
@@ -933,10 +979,12 @@ int main(int argc, char **argv) {
     int e = 0;
     const char *u;
     t = lines[l];
+
     while(*t && *t != label_separator) {
       u = unctrl(*t++);
       e += strlen(u);
     }
+
     labels[l] = (char *) malloc((e + 1) * sizeof(char));
     t = lines[l];
     s = labels[l];
@@ -956,7 +1004,6 @@ int main(int argc, char **argv) {
   initscr();
   cbreak();
   noecho();
-  /* nonl(); */
   intrflush(stdscr, FALSE);
 
   /* So that the arrow keys work */
@@ -976,7 +1023,8 @@ int main(int argc, char **argv) {
        color_bg_highlight < 0 || color_bg_highlight >= COLORS) {
       echo();
       endwin();
-      fprintf(stderr, "Selector: Color numbers have to be between 0 and %d.\n", COLORS - 1);
+      fprintf(stderr, "Selector: Color numbers have to be between 0 and %d.\n",
+              COLORS - 1);
       exit(1);
     }
 
@@ -1081,7 +1129,8 @@ int main(int argc, char **argv) {
     }
 
     else if(key == '\014') { /* ^L */
-      /* I suspect that we may sometime mess up the display */
+      /* I suspect that we may sometime mess up the display, so ^L is
+         here to force a full refresh */
       clear();
     }
 
@@ -1114,7 +1163,7 @@ int main(int argc, char **argv) {
     }
 
     if(output_to_vt_buffer && t) {
-      inject_into_tty_buffer(t);
+      inject_into_tty_buffer(t, add_control_qs);
     }
 
     if(output_filename[0]) {
@@ -1125,7 +1174,9 @@ int main(int argc, char **argv) {
         }
         fprintf(out, "\n");
       } else {
-        fprintf(stderr, "Selector: Can not open %s for writing.\n", output_filename);
+        fprintf(stderr,
+                "Selector: Can not open %s for writing.\n",
+                output_filename);
         exit(1);
       }
       fclose(out);