<html>
    <head>
      <base href="https://bugs.llvm.org/">
    </head>
    <body><table border="1" cellspacing="0" cellpadding="8">
        <tr>
          <th>Bug ID</th>
          <td><a class="bz_bug_link 
          bz_status_NEW "
   title="NEW - Recommend -fprofile-generate instead of -fprofile-instr-generate for PGO in Clang's user manual"
   href="https://bugs.llvm.org/show_bug.cgi?id=46323">46323</a>
          </td>
        </tr>

        <tr>
          <th>Summary</th>
          <td>Recommend -fprofile-generate instead of -fprofile-instr-generate for PGO in Clang's user manual
          </td>
        </tr>

        <tr>
          <th>Product</th>
          <td>Documentation
          </td>
        </tr>

        <tr>
          <th>Version</th>
          <td>trunk
          </td>
        </tr>

        <tr>
          <th>Hardware</th>
          <td>PC
          </td>
        </tr>

        <tr>
          <th>OS</th>
          <td>Linux
          </td>
        </tr>

        <tr>
          <th>Status</th>
          <td>NEW
          </td>
        </tr>

        <tr>
          <th>Severity</th>
          <td>enhancement
          </td>
        </tr>

        <tr>
          <th>Priority</th>
          <td>P
          </td>
        </tr>

        <tr>
          <th>Component</th>
          <td>General docs
          </td>
        </tr>

        <tr>
          <th>Assignee</th>
          <td>unassignedbugs@nondot.org
          </td>
        </tr>

        <tr>
          <th>Reporter</th>
          <td>hans@chromium.org
          </td>
        </tr>

        <tr>
          <th>CC</th>
          <td>george.burgess.iv@gmail.com, llvm-bugs@lists.llvm.org, xur@google.com
          </td>
        </tr></table>
      <p>
        <div>
        <pre>Clang's user manual currently recommends -fprofile-instr-generate for
instrumentation based profile-guided optimization
(<a href="https://clang.llvm.org/docs/UsersManual.html#profiling-with-instrumentation">https://clang.llvm.org/docs/UsersManual.html#profiling-with-instrumentation</a>)

Towards the end of that section, there is a part about -fprofile-generate
saying it's an alternative instrumentation method.


However, my understanding is that -fprofile-generate is really better for PGO
(it supports value profiling for example), and -fprofile-instr-generate is best
left for code coverage analysis.

If my understand is correct, can we update the docs to reflect this?</pre>
        </div>
      </p>


      <hr>
      <span>You are receiving this mail because:</span>

      <ul>
          <li>You are on the CC list for the bug.</li>
      </ul>
    </body>
</html>