Document macOS Installation

[mig8447]

I'm just leaving this for future reference:

After trying cpan Perl::LanguageServer in macOS Mojave 10.14, I ended up with

# Testing Perl::LanguageServer , Perl 5.018004, /usr/bin/perl
# Looks like you failed 1 test of 1.
FAILED--Further testing stopped.
make: *** [test_dynamic] Error 1
  GRICHTER/Perl-LanguageServer-2.0.2.tar.gz
4 dependencies missing (AnyEvent::AIO,Compiler::Lexer,IO::AIO,Coro); additionally test harness failed
  /usr/bin/make test -- NOT OK
//hint// to see the cpan-testers results for installing this module, try:
  reports GRICHTER/Perl-LanguageServer-2.0.2.tar.gz
Running make install
  make test had returned bad status, won't install without force

I then installed the language headers using

sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /

And the Compiled-Lexer package with

cpanm https://github.com/goccy/p5-Compiler-Lexer.git

And re-executed the installer

[richterger]

Hopefully this is more streamlined as soon as 2.1.0 is out, since then you can use Compiler::Lexer from CPAN and do not need to install it separately.

Could you please retest as soon as 2.1.0 is released.

[tangledhelix]

Installing anything against the system Perl in macOS is a recipe for pain.. use Homebrew perl or Perlbrew.