prompt: We are currently solving the following issue within our repository. Here is the issue text:
  --- BEGIN ISSUE ---
  Add docstring for coala_modes.py mode_normal
  This function should have a proper docstring, and indicate that `log_printer` is unused & deprecated.
  
  --- END ISSUE ---
  
  Below are some code segments, each from a relevant file. One or more of these files may contain bugs.
  --- BEGIN FILES ---
  Path: `coalib/coala_modes.py`
  Content:
  ```
  1 def mode_normal(console_printer, log_printer, args, debug=False):
  2     import functools
  3 
  4     from coalib.coala_main import run_coala
  5     from coalib.output.ConsoleInteraction import (
  6         acquire_settings, nothing_done,
  7         print_results, print_section_beginning)
  8 
  9     partial_print_sec_beg = functools.partial(
  10         print_section_beginning,
  11         console_printer)
  12     results, exitcode, _ = run_coala(
  13         print_results=print_results,
  14         acquire_settings=acquire_settings,
  15         print_section_beginning=partial_print_sec_beg,
  16         nothing_done=nothing_done,
  17         console_printer=console_printer,
  18         args=args,
  19         debug=debug)
  20 
  21     return exitcode
  22 
  23 
  24 def mode_non_interactive(console_printer, args, debug=False):
  25     import functools
  26 
  27     from coalib.coala_main import run_coala
  28     from coalib.output.ConsoleInteraction import (
  29         print_results_no_input, print_section_beginning)
  30 
  31     partial_print_sec_beg = functools.partial(
  32         print_section_beginning,
  33         console_printer)
  34     results, exitcode, _ = run_coala(
  35         print_results=print_results_no_input,
  36         print_section_beginning=partial_print_sec_beg,
  37         force_show_patch=True,
  38         console_printer=console_printer,
  39         args=args,
  40         debug=debug)
  41 
  42     return exitcode
  43 
  44 
  45 def mode_json(args, debug=False):
  46     import json
  47 
  48     from coalib.coala_main import run_coala
  49     from coalib.output.Logging import configure_json_logging
  50     from coalib.output.JSONEncoder import create_json_encoder
  51 
  52     if args.log_json:
  53         log_stream = configure_json_logging()
  54 
  55     JSONEncoder = create_json_encoder(use_relpath=args.relpath)
  56 
  57     results, exitcode, _ = run_coala(args=args, debug=debug)
  58 
  59     retval = {'results': results}
  60 
  61     if args.log_json:
  62         retval['logs'] = [json.loads(line) for line in
  63                           log_stream.getvalue().splitlines()]
  64 
  65     if args.output:
  66         filename = str(args.output[0])
  67         with open(filename, 'w') as fp:
  68             json.dump(retval, fp,
  69                       cls=JSONEncoder,
  70                       sort_keys=True,
  71                       indent=2,
  72                       separators=(',', ': '))
  73     else:
  74         print(json.dumps(retval,
  75                          cls=JSONEncoder,
  76                          sort_keys=True,
  77                          indent=2,
  78                          separators=(',', ': ')))
  79 
  80     return 0 if args.show_bears else exitcode
  81 
  82 
  83 def mode_format(args, debug=False):
  84     from coalib.coala_main import run_coala
  85     from coalib.output.ConsoleInteraction import print_results_formatted
  86 
  87     _, exitcode, _ = run_coala(
  88             print_results=print_results_formatted, args=args, debug=debug)
  89     return exitcode
  90
  ```
  --- END FILES ---
  
  Please first localize the bug based on the issue statement, and then generate a patch according to the `git diff` format fenced by three backticks.
  
  Here is an example:
  
  ```diff
  diff --git a/examples/server_async.py b/examples/server_async.py
  --- a/examples/server_async.py
  +++ b/examples/server_async.py
  @@ -313,4 +313,4 @@
   
   
   if __name__ == "__main__":
  -    asyncio.run(run_async_server("."), debug=True)
  +    asyncio.run(run_async_server(), debug=True)
  diff --git a/examples/server_sync.py b/examples/server_sync.py
  --- a/examples/server_sync.py
  +++ b/examples/server_sync.py
  @@ -313,5 +313,5 @@
   
   
   if __name__ == "__main__":
  -    server = run_sync_server(".")
  +    server = run_sync_server()
       server.shutdown()
  
  ```
  
golden_diff: diff --git a/coalib/coala_modes.py b/coalib/coala_modes.py
  --- a/coalib/coala_modes.py
  +++ b/coalib/coala_modes.py
  @@ -1,4 +1,13 @@
   def mode_normal(console_printer, log_printer, args, debug=False):
  +    """
  +    This is the default coala mode. User interaction is allowed in this mode.
  +
  +    :param console_printer: Object to print messages on the console.
  +    :param log_printer:     Deprecated.
  +    :param args:            Alternative pre-parsed CLI arguments.
  +    :param debug:           Run in debug mode, bypassing multiprocessing,
  +                            and not catching any exceptions.
  +    """
       import functools
   
       from coalib.coala_main import run_coala
  
verification_info: {"golden_diff": "diff --git a/coalib/coala_modes.py b/coalib/coala_modes.py\n--- a/coalib/coala_modes.py\n+++ b/coalib/coala_modes.py\n@@ -1,4 +1,13 @@\n def mode_normal(console_printer, log_printer, args, debug=False):\n+    \"\"\"\n+    This is the default coala mode. User interaction is allowed in this mode.\n+\n+    :param console_printer: Object to print messages on the console.\n+    :param log_printer:     Deprecated.\n+    :param args:            Alternative pre-parsed CLI arguments.\n+    :param debug:           Run in debug mode, bypassing multiprocessing,\n+                            and not catching any exceptions.\n+    \"\"\"\n     import functools\n \n     from coalib.coala_main import run_coala\n", "issue": "Add docstring for coala_modes.py mode_normal\nThis function should have a proper docstring, and indicate that `log_printer` is unused & deprecated.\n", "before_files": [{"content": "def mode_normal(console_printer, log_printer, args, debug=False):\n    import functools\n\n    from coalib.coala_main import run_coala\n    from coalib.output.ConsoleInteraction import (\n        acquire_settings, nothing_done,\n        print_results, print_section_beginning)\n\n    partial_print_sec_beg = functools.partial(\n        print_section_beginning,\n        console_printer)\n    results, exitcode, _ = run_coala(\n        print_results=print_results,\n        acquire_settings=acquire_settings,\n        print_section_beginning=partial_print_sec_beg,\n        nothing_done=nothing_done,\n        console_printer=console_printer,\n        args=args,\n        debug=debug)\n\n    return exitcode\n\n\ndef mode_non_interactive(console_printer, args, debug=False):\n    import functools\n\n    from coalib.coala_main import run_coala\n    from coalib.output.ConsoleInteraction import (\n        print_results_no_input, print_section_beginning)\n\n    partial_print_sec_beg = functools.partial(\n        print_section_beginning,\n        console_printer)\n    results, exitcode, _ = run_coala(\n        print_results=print_results_no_input,\n        print_section_beginning=partial_print_sec_beg,\n        force_show_patch=True,\n        console_printer=console_printer,\n        args=args,\n        debug=debug)\n\n    return exitcode\n\n\ndef mode_json(args, debug=False):\n    import json\n\n    from coalib.coala_main import run_coala\n    from coalib.output.Logging import configure_json_logging\n    from coalib.output.JSONEncoder import create_json_encoder\n\n    if args.log_json:\n        log_stream = configure_json_logging()\n\n    JSONEncoder = create_json_encoder(use_relpath=args.relpath)\n\n    results, exitcode, _ = run_coala(args=args, debug=debug)\n\n    retval = {'results': results}\n\n    if args.log_json:\n        retval['logs'] = [json.loads(line) for line in\n                          log_stream.getvalue().splitlines()]\n\n    if args.output:\n        filename = str(args.output[0])\n        with open(filename, 'w') as fp:\n            json.dump(retval, fp,\n                      cls=JSONEncoder,\n                      sort_keys=True,\n                      indent=2,\n                      separators=(',', ': '))\n    else:\n        print(json.dumps(retval,\n                         cls=JSONEncoder,\n                         sort_keys=True,\n                         indent=2,\n                         separators=(',', ': ')))\n\n    return 0 if args.show_bears else exitcode\n\n\ndef mode_format(args, debug=False):\n    from coalib.coala_main import run_coala\n    from coalib.output.ConsoleInteraction import print_results_formatted\n\n    _, exitcode, _ = run_coala(\n            print_results=print_results_formatted, args=args, debug=debug)\n    return exitcode\n", "path": "coalib/coala_modes.py"}], "after_files": [{"content": "def mode_normal(console_printer, log_printer, args, debug=False):\n    \"\"\"\n    This is the default coala mode. User interaction is allowed in this mode.\n\n    :param console_printer: Object to print messages on the console.\n    :param log_printer:     Deprecated.\n    :param args:            Alternative pre-parsed CLI arguments.\n    :param debug:           Run in debug mode, bypassing multiprocessing,\n                            and not catching any exceptions.\n    \"\"\"\n    import functools\n\n    from coalib.coala_main import run_coala\n    from coalib.output.ConsoleInteraction import (\n        acquire_settings, nothing_done,\n        print_results, print_section_beginning)\n\n    partial_print_sec_beg = functools.partial(\n        print_section_beginning,\n        console_printer)\n    results, exitcode, _ = run_coala(\n        print_results=print_results,\n        acquire_settings=acquire_settings,\n        print_section_beginning=partial_print_sec_beg,\n        nothing_done=nothing_done,\n        console_printer=console_printer,\n        args=args,\n        debug=debug)\n\n    return exitcode\n\n\ndef mode_non_interactive(console_printer, args, debug=False):\n    import functools\n\n    from coalib.coala_main import run_coala\n    from coalib.output.ConsoleInteraction import (\n        print_results_no_input, print_section_beginning)\n\n    partial_print_sec_beg = functools.partial(\n        print_section_beginning,\n        console_printer)\n    results, exitcode, _ = run_coala(\n        print_results=print_results_no_input,\n        print_section_beginning=partial_print_sec_beg,\n        force_show_patch=True,\n        console_printer=console_printer,\n        args=args,\n        debug=debug)\n\n    return exitcode\n\n\ndef mode_json(args, debug=False):\n    import json\n\n    from coalib.coala_main import run_coala\n    from coalib.output.Logging import configure_json_logging\n    from coalib.output.JSONEncoder import create_json_encoder\n\n    if args.log_json:\n        log_stream = configure_json_logging()\n\n    JSONEncoder = create_json_encoder(use_relpath=args.relpath)\n\n    results, exitcode, _ = run_coala(args=args, debug=debug)\n\n    retval = {'results': results}\n\n    if args.log_json:\n        retval['logs'] = [json.loads(line) for line in\n                          log_stream.getvalue().splitlines()]\n\n    if args.output:\n        filename = str(args.output[0])\n        with open(filename, 'w') as fp:\n            json.dump(retval, fp,\n                      cls=JSONEncoder,\n                      sort_keys=True,\n                      indent=2,\n                      separators=(',', ': '))\n    else:\n        print(json.dumps(retval,\n                         cls=JSONEncoder,\n                         sort_keys=True,\n                         indent=2,\n                         separators=(',', ': ')))\n\n    return 0 if args.show_bears else exitcode\n\n\ndef mode_format(args, debug=False):\n    from coalib.coala_main import run_coala\n    from coalib.output.ConsoleInteraction import print_results_formatted\n\n    _, exitcode, _ = run_coala(\n            print_results=print_results_formatted, args=args, debug=debug)\n    return exitcode\n", "path": "coalib/coala_modes.py"}]}