[DOC] Enhanced RDoc for ::ln_s

[BurdetteLamar]

No description provided.

[BurdetteLamar]

@jeremyevans, I'm still feeling my way here:

• There's has a separate fileset (with its own n) for each argset; this means that:
  • The reader doesn't have any carryover to remember.
  • Everything is still valid when we get to verbose: true at the bottom.
• Under verbose: true, should the five commands be interleaved with the five method calls?
• Alternatively, should each verbose call and its output be put with the corresponding example code above?

As our strategy evolves, I may need to revise some of the previous work here.

[jeremyevans]

This behavior when dest is a directory is the same when src is a file or a directory. I don't think we need a separate example block for it, maybe just update the above text to mention that it applies both when src is a file and when it is a directory.

[BurdetteLamar]

Cannot add this to the relevant list item above b/c the covering text says "When +src+ is the path to an existing file:".

[jeremyevans]

Then consider reorganizing the sections to avoid the repetition.

[BurdetteLamar]

Done. One section now, with examples with src as both file and directory.

[BurdetteLamar]

@jeremyevans, there's no re-review thingy, but this is ready for you to check.

[jeremyevans]

Please pick an example group to remove (see comment), then this is OK to merge without further review.

[jeremyevans]

Same behavior for both file/directory src cases, so let's just pick one and use it, there is no benefit for keeping both examples.

[BurdetteLamar]

@jeremyevans, I've re-confirmed the examples, including the verbose output, b/c of the renumbering.