SI-7491 deprecate overriding App.main and clarify documentation

App.main should never be overridden, so let's enforce it.
Merge pull request #3338 from gourlaysama/t7491

SI-7491 fix typo in scala.App documentation