erlang: install manpages only in lib/erlang/man

Some erlang man pages have generic names that conflict with other
packages. The recommended installation location is lib/erlang/man, and
in fact they must be there for the "erl -man" command to find them.
Currently we use symlinks to make this work.

Instead let's only install them to lib/erlang/man and avoid all
conflicts. Users can add $(brew --prefix erlang)/lib/erlang/man to
MANPATH if they really want to use man to find them.

Fixes #21634.
Closes #22452.

1 files changed, 9 insertions, 6 deletions

diff --git a/Library/Formula/erlang.rb b/Library/Formula/erlang.rb
index 9d7c6b3eb..4de58c7c7 100644
--- a/Library/Formula/erlang.rb
+++ b/Library/Formula/erlang.rb
@@ -93,17 +93,20 @@ class Erlang < Formula
 
     unless build.include? 'no-docs'
       manuals = build.head? ? ErlangHeadManuals : ErlangManuals
-      manuals.new.brew {
-        man.install Dir['man/*']
-        # erl -man expects man pages in lib/erlang/man
-        (lib+'erlang').install_symlink man
-      }
-
+      manuals.new.brew { (lib/'erlang').install 'man' }
       htmls = build.head? ? ErlangHeadHtmls : ErlangHtmls
       htmls.new.brew { doc.install Dir['*'] }
     end
   end
 
+  def caveats; <<-EOS.undent
+    Man pages can be found in:
+      #{opt_prefix}/lib/erlang/man
+
+    Access them with `erl -man`, or add this directory to MANPATH.
+    EOS
+  end
+
   def test
     `#{bin}/erl -noshell -eval 'crypto:start().' -s init stop`