NAME

       fix_include - Update the source code with iwyu output

SYNOPSIS

       fix_include  [options]  [filename]  ...  <  <output  from  include-what-you-use script> OR
       fix_include -s [other options] <filename> ...

DESCRIPTION

       fix_include reads the output from the include-what-you-use script on  stdin  --  run  with
       --v=1  (default)  verbose  or  above -- and, unless --sort_only or --dry_run is specified,
       modifies the files mentioned  in  the  output,  removing  their  old  #include  lines  and
       replacing them with the lines given by the include_what_you_use script.  It also sorts the
       #include and forward-declare lines.

       Only writable files (those opened for p4 edit) are modified (unless --checkout_command  is
       specified).   All  files mentioned in the include-what-you-use script are modified, unless
       filenames are specified on the commandline, in which case only those files are modified.

       The exit code is the number of files that were modified (or  that  would  be  modified  if
       --dry_run was specified) unless that number exceeds 100, in which case 100 is returned.

OPTIONS

       -h, --help
              show this help message and exit

       -b, --blank_lines
              Put  a  blank  line  between  primary  header  file and C/C++ system #includes, and
              another blank line between system #includes and google #includes [default]

       --noblank_lines

       --comments
              Put comments after the #include lines

       --nocomments

       --safe_headers
              Do not remove unused #includes/fwd-declares from header files; just  add  new  ones
              [default]

       --nosafe_headers

       -s, --sort_only
              Just sort #includes of files listed on cmdline; do not add or remove any #includes

       -n, --dry_run
              Do  not  actually edit any files; just print diffs.  Return code is 0 if no changes
              are needed, else min(the number of files that would be modified, 100)

       --ignore_re=IGNORE_RE
              fix_includes.py will  skip  editing  any  file  whose  name  matches  this  regular
              expression.

       --checkout_command=CHECKOUT_COMMAND
              A command, such as "p4 edit", to run on all the nonwriteable files before modifying
              them.  The filenames will be appended to the command after a  space.   The  command
              will not be run on any file that does not need to change.

       --create_cl_if_possible
              If  --checkout_command is "p4|g4|v4 edit" and all files to be modified needed to be
              checked out, then create a CL containing those files.

       --nocreate_cl_if_possible

       --append_to_cl=APPEND_TO_CL
              If provided, with a checkout_command, add files that need fixing to  the  specified
              existing CL.

       --separate_project_includes=SEPARATE_PROJECT_INCLUDES
              Sort  #includes for current project separately from all other #includes.  This flag
              specifies the root directory of the current  project.  If  the  value  is  "<tld>",
              #includes  that  share  the  same top-level directory are assumed to be in the same
              project.  If not specified, project #includes will be sorted with other  non-system
              #includes.

       --invoking_command_line=INVOKING_COMMAND_LINE
              Internal flag used by iwyu.py, It should be the command line used to invoke iwyu.py

       -m, --keep_iwyu_namespace_format
              Keep forward-declaration namespaces in IWYU format, eg. namespace n1 { namespace n2
              { class c1; } }. Do  not  convert  to  "normalized"  Google  format:  namespace  n1
              {\nnamespace n2 {\n class c1;\n}\n}.

       --nokeep_iwyu_namespace_format