<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 - option descriptions in man page diverges from --help and sometimes from actual behaviour"
href="https://bugs.llvm.org/show_bug.cgi?id=39143">39143</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>option descriptions in man page diverges from --help and sometimes from actual behaviour
</td>
</tr>
<tr>
<th>Product</th>
<td>lld
</td>
</tr>
<tr>
<th>Version</th>
<td>unspecified
</td>
</tr>
<tr>
<th>Hardware</th>
<td>PC
</td>
</tr>
<tr>
<th>OS</th>
<td>All
</td>
</tr>
<tr>
<th>Status</th>
<td>NEW
</td>
</tr>
<tr>
<th>Severity</th>
<td>normal
</td>
</tr>
<tr>
<th>Priority</th>
<td>P
</td>
</tr>
<tr>
<th>Component</th>
<td>ELF
</td>
</tr>
<tr>
<th>Assignee</th>
<td>unassignedbugs@nondot.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>edd-llvm@mr-edd.co.uk
</td>
</tr>
<tr>
<th>CC</th>
<td>llvm-bugs@lists.llvm.org
</td>
</tr></table>
<p>
<div>
<pre>As of r335947, the content of ELF LLD man page at docs/ld.lld.1 differs from
the --help in a number of places. In a couple of places, the information is
contradictory and the man page does not match actual behaviour.
Problems include but may not be limited to the following. I quickly scanned by
eye.
The following switches don't appear in the man page, but are in the --help:
-(, -), --apply-dynamic-relocs, -Bshareable, -b, --call-graph-ordering-file,
--call_shared, --check-sections, --cref, --dc, --dn, --dp, --dy, -d,
--end-group, --execute-only, -E, -e, --fix-cortex-a53-843419, -F, -f,
--gnu-unique, -h, --icf=safe, --ignore-data-address-equality,
--ignore-function-address-equality, --just-symbols, --keep-unique, --library,
--lto-debug-pass-manager, --lto-new-pass-manager, --lto-sample-profile,
--merge-exidx-entries, --mllvm, -M, -m, --no-allow-multiple-definition,
--no-apply-dynamic-relocs, --no-check-sections, --no-cref, --no-eh-frame-hdr,
--no-execute-only, --no-export-dynamic, --no-fatal-warnings, --no-gdb-index,
--no-merge-exidx-entries, --no-omagic, --no-pic-executable,
--no-print-gc-sections, --no-print-icf-sections, --no-toc-optimize,
--no-use-android-relr-tags, --no-warn-backrefs, --no-warn-common,
--no-warn-symbol-ordering, --non_shared, -N, --orphan-handling, --output,
--pack-dyn-relocs, --pic-executable, --plugin-opt, --plugin,
--print-icf-sections, -q, -R, -r, --start-group, -S, -s, --toc-optimize,
-Ttext-segment, -T, -t, --use-android-relr-tags, -u, --version,
--warn-symbol-ordering, -X, -x, -y, -z.
For --build-id, the man page mentions 'sha1', which isn't a supported value. It
also mentions 'tree', which is handled internally but is not mentioned by
--help.
For --color-diagnostics, the man page says the default is 'auto', whereas
--help says it's 'always'.
Perhaps there's a way to generate the --help and man page from the same source?</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>