[GIT,1/1] kbuild: Add wrapping of long expressions at ORs
diff mbox

Message ID 2b001634fc74aaabc1ab988ffb1d388b@amelkin.online
State New
Headers show

Pull-request

https://github.com/AlexanderAmelkin/linux-wandboard.git

Commit Message

Alexander Amelkin May 10, 2017, 1:06 p.m. UTC
The following changes since commit 
a351e9b9fc24e982ec2f0e76379a49826036da12:

   Linux 4.11 (2017-04-30 19:47:48 -0700)

are available in the git repository at:

   https://github.com/AlexanderAmelkin/linux-wandboard.git 
tags/kconfig_wrapping

for you to fetch changes up to f4c95059bd2410ac96d6ef9f8848a0f0b757a17a:

   kconfig: Add wrapping of long expressions at ORs (2017-05-10 12:51:31 
+0300)

----------------------------------------------------------------
Some symbols in configuration may be selected by very-very long boolean
expressions. Reading through such long expressions, it is extremely hard
to identify what exactly selects the given option.

This commit adds a new line every time a boolean OR is encountered in
the "outer" expression. That is, it won't break apart separate
sub-expressions like OPTION_A && (OPTION_B || OPTION_C), but will add a
new line before OPTION_C in an expression like:

OPTION_A && OPTION_B || OPTION_C && OPTION_D

This commit also adds indentation of the wrapped lines to the label
position. That is, the expression on the new line will continue starting
at the same character position as it started in the first line, right
after the label such as "  Selected by:  ".

This commit also renames some variables to better reflect their purpose.

Signed-off-by: Alexander Amelkin <alexander@amelkin.msk.ru>
Cc: Yann E. MORIN <yann.morin.1998@free.fr>
Cc: linux-kbuild@vger.kernel.org

----------------------------------------------------------------
Alexander Amelkin (1):
       kconfig: Add wrapping of long expressions at ORs

  scripts/kconfig/expr.c | 48 
++++++++++++++++++++++++++++++++++++++++--------
  scripts/kconfig/lkc.h  | 15 ++++++++++++---
  scripts/kconfig/menu.c | 16 +++++++++++++---
  scripts/kconfig/util.c |  1 +
  4 files changed, 66 insertions(+), 14 deletions(-)


--
To unsubscribe from this list: send the line "unsubscribe linux-kbuild" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Comments

Randy Dunlap May 15, 2017, 10:16 p.m. UTC | #1
On 05/10/17 06:06, Alexander Amelkin wrote:
> The following changes since commit a351e9b9fc24e982ec2f0e76379a49826036da12:
> 
>   Linux 4.11 (2017-04-30 19:47:48 -0700)
> 
> are available in the git repository at:
> 
>   https://github.com/AlexanderAmelkin/linux-wandboard.git tags/kconfig_wrapping
> 
> for you to fetch changes up to f4c95059bd2410ac96d6ef9f8848a0f0b757a17a:
> 
>   kconfig: Add wrapping of long expressions at ORs (2017-05-10 12:51:31 +0300)

Once again I don't know who is going to merge this patch.  Andrew?


> ----------------------------------------------------------------
> Some symbols in configuration may be selected by very-very long boolean
> expressions. Reading through such long expressions, it is extremely hard
> to identify what exactly selects the given option.
> 
> This commit adds a new line every time a boolean OR is encountered in
> the "outer" expression. That is, it won't break apart separate
> sub-expressions like OPTION_A && (OPTION_B || OPTION_C), but will add a
> new line before OPTION_C in an expression like:
> 
> OPTION_A && OPTION_B || OPTION_C && OPTION_D
> 
> This commit also adds indentation of the wrapped lines to the label
> position. That is, the expression on the new line will continue starting
> at the same character position as it started in the first line, right
> after the label such as "  Selected by:  ".
> 
> This commit also renames some variables to better reflect their purpose.
> 
> Signed-off-by: Alexander Amelkin <alexander@amelkin.msk.ru>
> Cc: Yann E. MORIN <yann.morin.1998@free.fr>
> Cc: linux-kbuild@vger.kernel.org

Tested-by: Randy Dunlap <rdunlap@infradead.org>

I guess that your webmail client modified all of the tabs in the source
code into spaces... which wouldn't happen if I did a git clone, but
I'm not doing that.  Perhaps you could attach a copy of the patch that
contains tabs instead of spaces.  I had to edit the patch quite a bit
and then tell 'patch' to ignore whitespace issues.

Thanks.

> ----------------------------------------------------------------
> Alexander Amelkin (1):
>       kconfig: Add wrapping of long expressions at ORs
> 
>  scripts/kconfig/expr.c | 48 ++++++++++++++++++++++++++++++++++++++++--------
>  scripts/kconfig/lkc.h  | 15 ++++++++++++---
>  scripts/kconfig/menu.c | 16 +++++++++++++---
>  scripts/kconfig/util.c |  1 +
>  4 files changed, 66 insertions(+), 14 deletions(-)

Patch
diff mbox

diff --git a/scripts/kconfig/expr.c b/scripts/kconfig/expr.c
index cbf4996..b0d9765 100644
--- a/scripts/kconfig/expr.c
+++ b/scripts/kconfig/expr.c
@@ -1170,6 +1170,27 @@  void expr_fprint(struct expr *e, FILE *out)
         expr_print(e, expr_print_file_helper, out, E_NONE);
  }

+static int str_chrcount(const char *s, char c)
+{
+       int count = 0;
+       const char *p = s;
+
+       while (NULL != (p = strchr(p, c))) {
+               p++;
+               count++;
+       }
+       return count;
+}
+
+static void str_newline_indented(struct gstr *gs)
+{
+       int i;
+
+       str_append(gs, "\\\n");
+       for (i = 0; i < gs->label_len; i++)
+               str_append(gs, " ");
+}
+
  static void expr_print_gstr_helper(void *data, struct symbol *sym, 
const char *str)
  {
         struct gstr *gs = (struct gstr*)data;
@@ -1179,25 +1200,36 @@  static void expr_print_gstr_helper(void *data, 
struct symbol *sym, const char *s
                 sym_str = sym_get_string_value(sym);

         if (gs->max_width) {
-               unsigned extra_length = strlen(str);
+               unsigned int added_length = strlen(str);
                 const char *last_cr = strrchr(gs->s, '\n');
-               unsigned last_line_length;
+               unsigned int this_line_length;

                 if (sym_str)
-                       extra_length += 4 + strlen(sym_str);
+                       added_length += 4 + strlen(sym_str);

                 if (!last_cr)
-                       last_cr = gs->s;
-
-               last_line_length = strlen(gs->s) - (last_cr - gs->s);
+                       /* Account for the label not included in the 
first line */
+                       this_line_length = strlen(gs->s) + 
gs->label_len;
+               else
+                       /* Subsequent lines already contain the indent 
inside them */
+                       this_line_length = strlen(last_cr + 1);

-               if ((last_line_length + extra_length) > gs->max_width)
-                       str_append(gs, "\\\n");
+               if ((this_line_length + added_length) > gs->max_width)
+                       str_newline_indented(gs);
         }

         str_append(gs, str);
         if (sym && sym->type != S_UNKNOWN)
                 str_printf(gs, " [=%s]", sym_str);
+
+       /* Break the line on an OR for 'outer' expressions,
+          don't break inside parentheses. */
+       if (str_chrcount(gs->s, '(') == str_chrcount(gs->s, ')')) {
+               int len = strlen(str);
+
+               if (len >= 4 && !strcmp(str + len - 4, " || "))
+                       str_newline_indented(gs);
+       }
  }

  void expr_gstr_print(struct expr *e, struct gstr *gs)
diff --git a/scripts/kconfig/lkc.h b/scripts/kconfig/lkc.h
index 91ca126..2bf6704 100644
--- a/scripts/kconfig/lkc.h
+++ b/scripts/kconfig/lkc.h
@@ -120,10 +120,19 @@  struct gstr {
         size_t len;
         char  *s;
         /*
-       * when max_width is not zero long lines in string s (if any) get
-       * wrapped not to exceed the max_width value
-       */
+        * when max_width is not zero long lines in string s (if any) 
get
+        * wrapped not to exceed the max_width value
+        */
         int max_width;
+       /*
+        * The label for the string. Usually the string is output to the 
right
+        * from the label in the same line. The label_len is used to 
indent
+        * lines when they are too long and wrapping is required.
+        *
+        * Set this property before calling expr_gstr_print() on a gstr 
if
+        * a long (wrappable) list of expressions is possible.
+        */
+       int label_len;
  };
  struct gstr str_new(void);
  void str_free(struct gstr *gs);
diff --git a/scripts/kconfig/menu.c b/scripts/kconfig/menu.c
index e935793..3a7d5a6 100644
--- a/scripts/kconfig/menu.c
+++ b/scripts/kconfig/menu.c
@@ -629,6 +629,7 @@  static void get_symbol_props_str(struct gstr *r, 
struct symbol *sym,
         for_all_properties(sym, prop, tok) {
                 if (!hit) {
                         str_append(r, prefix);
+                       r->label_len = strlen(prefix);
                         hit = true;
                 } else
                         str_printf(r, " && ");
@@ -667,7 +668,10 @@  static void get_symbol_str(struct gstr *r, struct 
symbol *sym,
                 str_printf(r, _("  Defined at %s:%d\n"), 
prop->menu->file->name,
                         prop->menu->lineno);
                 if (!expr_is_yes(prop->visible.expr)) {
-                       str_append(r, _("  Depends on: "));
+                       const char *label = _("  Depends on: ");
+
+                       r->label_len = strlen(label);
+                       str_append(r, label);
                         expr_gstr_print(prop->visible.expr, r);
                         str_append(r, "\n");
                 }
@@ -675,14 +679,20 @@  static void get_symbol_str(struct gstr *r, struct 
symbol *sym,

         get_symbol_props_str(r, sym, P_SELECT, _("  Selects: "));
         if (sym->rev_dep.expr) {
-               str_append(r, _("  Selected by: "));
+               const char *label = _("  Selected by: ");
+
+               r->label_len = strlen(label);
+               str_append(r, label);
                 expr_gstr_print(sym->rev_dep.expr, r);
                 str_append(r, "\n");
         }

         get_symbol_props_str(r, sym, P_IMPLY, _("  Implies: "));
         if (sym->implied.expr) {
-               str_append(r, _("  Implied by: "));
+               const char *label = _("  Implied by: ");
+
+               r->label_len = strlen(label);
+               str_append(r, label);
                 expr_gstr_print(sym->implied.expr, r);
                 str_append(r, "\n");
         }
diff --git a/scripts/kconfig/util.c b/scripts/kconfig/util.c
index 0e76042..79ddbf9 100644
--- a/scripts/kconfig/util.c
+++ b/scripts/kconfig/util.c
@@ -84,6 +84,7 @@  struct gstr str_new(void)
         gs.s = xmalloc(sizeof(char) * 64);
         gs.len = 64;
         gs.max_width = 0;
+       gs.label_len = 0;
         strcpy(gs.s, "\0");
         return gs;
  }