<html>
    <head>
      <base href="http://llvm.org/bugs/" />
    </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 --- - IR Builder: Ability to insert comments"
   href="http://llvm.org/bugs/show_bug.cgi?id=15873">15873</a>
          </td>
        </tr>

        <tr>
          <th>Summary</th>
          <td>IR Builder: Ability to insert comments
          </td>
        </tr>

        <tr>
          <th>Product</th>
          <td>libraries
          </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>Bitcode Writer
          </td>
        </tr>

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

        <tr>
          <th>Reporter</th>
          <td>superjoe30@gmail.com
          </td>
        </tr>

        <tr>
          <th>CC</th>
          <td>llvmbugs@cs.uiuc.edu
          </td>
        </tr>

        <tr>
          <th>Classification</th>
          <td>Unclassified
          </td>
        </tr></table>
      <p>
        <div>
        <pre>When writing a program that uses the IR Builder to generate IR code, it would
be extremely helpful to be able to insert comments so that when you look at
module.Dump() you can see some debug information.

For example, something like this:

LLVMBasicBlockRef entry = LLVMAppendBasicBlock(fac, "entry");
LLVMPrependComment(entry, "converted from such and such code");
...
LLVMValueRef If = LLVMBuildICmp(builder, LLVMIntEQ, n,
LLVMConstInt(LLVMInt32Type(), 0, 0), "n == 0");
LLVMPrependComment(If, "blah blah blah");

And when the module is dumped, looks something like this:

; converted from such and such code
entry:

...

; blah blah blah
%0 = icmp eq i32 0, 0</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>