From aea5de282ec6d7e8ed0a192c8c8eb0dbf6ff85b0 Mon Sep 17 00:00:00 2001
From: Olaf Alders <olaf@wundersolutions.com>
Date: Wed, 28 Feb 2018 10:26:44 -0500
Subject: [PATCH] Explain in more detail why perl checks are disabled by
 default

---
 doc/ale-perl.txt | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/ale-perl.txt b/doc/ale-perl.txt
index 414856bd..0a4adfff 100644
--- a/doc/ale-perl.txt
+++ b/doc/ale-perl.txt
@@ -3,6 +3,9 @@ ALE Perl Integration                                         *ale-perl-options*
 
 ALE offers a few ways to check Perl code. Checking code with `perl` is
 disabled by default, as `perl` code cannot be checked without executing it.
+Specifically, we use the `-c` flag to see if `perl` code compiles. This does
+not execute all of the code in a file, but it does run `BEGIN` and `CHECK`
+blocks. See `perl --help` and https://stackoverflow.com/a/12908487/406224
 
 See |g:ale_linters|.