This is the official manual for the latest Org-mode release.
By default code blocks are tangled to source-code files without any insertion
of comments beyond those which may already exist in the body of the code
:comments header argument can be set as follows to control
the insertion of extra comments into the tangled code file.
noThe default. No extra comments are inserted during tangling.
linkThe code block is wrapped in comments which contain pointers back to the original Org file from which the code was tangled.
yesA synonym for “link” to maintain backwards compatibility.
orgInclude text from the Org mode file as a comment. The text is picked from the leading context of the tangled code and is limited by the nearest headline or source block as the case may be.
bothTurns on both the “link” and “org” comment options.
nowebTurns on the “link” comment option, and additionally wraps expanded noweb references in the code block body in link comments.