[PATCH] D49938: [ELF] Update ld.lld.1

[Ed Maste via Phabricator via llvm-commits]

emaste added a comment.

For reference I had a discussion on markup for option aliases with Ingo Schwarze and he wrote:

> The standard method for achieving similar output as in the GNU ld(1) manual page goes as follows (without the comments i'm inserting/appending, of course):



  The options are as follows:
  .Pp \" You need this if you use -compact on the next line.
  .Bl -tag -width Ds -compact
  .It Fl l Ar libName
  .\" No paragraph break here.
  .It Fl -library Ns = Ns Ar libName
  Add archive file ...
  .Pp \" You need this between items if you use -compact above.
  .It Fl L Ar searchdir
  .It Fl -library-path Ns = Ns Ar searchdir
  Add path ...
  .El
  .Pp \" You always need this if some text follows, even without -compact.



> Then again, if the the options all fit on one output line, i don't really see the need and would rather recommend simply:

  The options are as follows:
  .Bl -tag -width Ds
  .It Fl l Ar libName , Fl -library Ns = Ns Ar libName
  Add archive file ...
  .It Fl L Ar searchdir , Fl -library-path Ns = Ns Ar searchdir
  Add path ...
  .El
  .Pp



> If you do this, always put the short option left of the long one, and decide alphabetic ordering by the short one, not by the long one.


Repository:
  rLLD LLVM Linker

https://reviews.llvm.org/D49938