[PATCH] D42963: Add initial ld.lld.1 man page

[Rui Ueyama via Phabricator via llvm-commits]

ruiu added a comment.

Thank you for doing this!



================
Comment at: docs/ld.lld.1:48
+Bind defined symbols locally.
+.It Fl -build-id= Ns Ar value
+Generate a build ID note.
----------------
"md5", "sha1", "tree", "uuid", 0x<hexstring> (e.g. 0xdeadbeef) and "none" are accepted. tree is a synonym to sha1.


================
Comment at: docs/ld.lld.1:52-55
+.It Fl -color-diagnostics= Ns Ar value
+Use colors in diagnostics.
+.It Fl -color-diagnostics
+Use colors in diagnostics.
----------------
-color-diagnostics={auto,always,never}
 - "auto" enables color output only when output is a terminal. It disables color output if the output is not a terminal (it uses isatty() internally.)

-color-diagnostics is a synonym to -color-diagnostics=auto


================
Comment at: docs/ld.lld.1:56
+Use colors in diagnostics.
+.It Fl -compress-debug-sections= Ns Ar value
+Compress DWARF debug sections.
----------------
-compress-debug-sections={none,zlib}

If zlib is specified, lld compresses debug sections in output.


================
Comment at: docs/ld.lld.1:60
+Assign space to common symbols.
+.It Fl -defsym= Ns Ar value
+Define a symbol alias.
----------------
-defsym=symbol=expression

expression can either be another symbol or a linker script expression. E.g.

-defsym=foo=bar
-defysm=foo=bar+0x100


================
Comment at: docs/ld.lld.1:121
+.It Fl -hash-style Ar value
+Specify hash style (sysv, gnu or both).
+.It Fl -help
----------------
both is default.


================
Comment at: docs/ld.lld.1:181
+Retain the executable output file whenever it is still usable.
+.It Fl -nopie
+Do not create a position independent executable.
----------------
-no-pie

(-nopie was a typo and I recently fixed that.)


================
Comment at: docs/ld.lld.1:185-191
+.It Fl -oformat Ar format
+Specify the binary format for the output object file.
+.It Fl -omagic
+Set the text and data sections to be readable and writable.
+.It Fl -opt-remarks-filename Ar value
+YAML output file for optimization remarks.
+.It Fl -opt-remarks-with-hotness
----------------
`--oformat`, `--omagic`, `--opt-remarks-filename` and `--opt-remarks-with-hotness`. An option that starts with "o" must be preceded by two dashes. Otherwise it's interpreted as -o foo (output file).


https://reviews.llvm.org/D42963