diff options
author | Benno Schulenberg | 2015-01-18 21:50:27 +0100 |
---|---|---|
committer | Karel Zak | 2015-01-26 11:22:15 +0100 |
commit | b295bdb1b50a634c34a465ad873f368bce1667d5 (patch) | |
tree | 043f4fe5fa4c59c5f17d3b00173fb07539054a33 /libsmartcols/src/table_print.c | |
parent | textual: put option and its description into a single translatable string (diff) | |
download | kernel-qcow2-util-linux-b295bdb1b50a634c34a465ad873f368bce1667d5.tar.gz kernel-qcow2-util-linux-b295bdb1b50a634c34a465ad873f368bce1667d5.tar.xz kernel-qcow2-util-linux-b295bdb1b50a634c34a465ad873f368bce1667d5.zip |
docs: fix two "maybe be" duplications in program comments
Also improve the grammar of the comments and some neighbours.
Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
Diffstat (limited to 'libsmartcols/src/table_print.c')
-rw-r--r-- | libsmartcols/src/table_print.c | 30 |
1 files changed, 14 insertions, 16 deletions
diff --git a/libsmartcols/src/table_print.c b/libsmartcols/src/table_print.c index 647692c0d..f08560c66 100644 --- a/libsmartcols/src/table_print.c +++ b/libsmartcols/src/table_print.c @@ -219,10 +219,10 @@ static void print_empty_cell(struct libscols_table *tb, fputc(' ', tb->out); } -/* fill-in all line with padding (or tree asci-art) +/* Fill the start of a line with padding (or with tree ascii-art). * - * This is necessary after long non-truncated colum where next column - * is printed in next line. For example (see 'DDD'): + * This is necessary after a long non-truncated column, as this requires the + * next column to be printed on the next line. For example (see 'DDD'): * * aaa bbb ccc ddd eee * AAA BBB CCCCCCC @@ -401,8 +401,8 @@ static int cell_to_buffer(struct libscols_table *tb, } /* - * Prints data, data maybe be printed in more formats (raw, NAME=xxx pairs) and - * control and non-printable chars maybe encoded in \x?? hex encoding. + * Prints data. Data can be printed in more formats (raw, NAME=xxx pairs), and + * control and non-printable characters can be encoded in the \x?? encoding. */ static int print_line(struct libscols_table *tb, struct libscols_line *ln, @@ -445,8 +445,7 @@ static int print_header(struct libscols_table *tb, struct libscols_buffer *buf) DBG(TAB, ul_debugobj(tb, "printing header")); - /* set width according to the size of data - */ + /* set the width according to the size of the data */ scols_reset_iter(&itr, SCOLS_ITER_FORWARD); while (rc == 0 && scols_table_next_column(tb, &itr, &cl) == 0) { rc = buffer_set_data(buf, scols_cell_get_data(&cl->header)); @@ -551,11 +550,11 @@ static void dbg_columns(struct libscols_table *tb) /* * This function counts column width. * - * For the SCOLS_FL_NOEXTREMES columns is possible to call this function two - * times. The first pass counts width and average width. If the column - * contains too large fields (width greater than 2 * average) then the column - * is marked as "extreme". In the second pass all extreme fields are ignored - * and column width is counted from non-extreme fields only. + * For the SCOLS_FL_NOEXTREMES columns it is possible to call this function + * two times. The first pass counts the width and average width. If the column + * contains fields that are too large (a width greater than 2 * average) then + * the column is marked as "extreme". In the second pass all extreme fields + * are ignored and the column width is counted from non-extreme fields only. */ static int count_column_width(struct libscols_table *tb, struct libscols_column *cl, @@ -653,8 +652,7 @@ static int recount_widths(struct libscols_table *tb, struct libscols_buffer *buf if (!tb->is_term) return 0; - /* reduce columns with extreme fields - */ + /* reduce columns with extreme fields */ if (width > tb->termwidth && extremes) { DBG(TAB, ul_debugobj(tb, " reduce width (extreme columns)")); @@ -710,7 +708,7 @@ static int recount_widths(struct libscols_table *tb, struct libscols_buffer *buf if (width < tb->termwidth && scols_table_is_maxout(tb)) { DBG(TAB, ul_debugobj(tb, " enlarge width (max-out)")); - /* try enlarge all columns */ + /* try enlarging all columns */ while (width < tb->termwidth) { scols_reset_iter(&itr, SCOLS_ITER_FORWARD); while (scols_table_next_column(tb, &itr, &cl) == 0) { @@ -735,7 +733,7 @@ static int recount_widths(struct libscols_table *tb, struct libscols_buffer *buf } /* bad, we have to reduce output width, this is done in two steps: - * 1/ reduce columns with a relative width and with truncate flag + * 1) reduce columns with a relative width and with truncate flag * 2) reduce columns with a relative width without truncate flag */ trunc_only = 1; |