diff --git a/README b/README
index 308cdb6..ca78809 100644
--- a/README
+++ b/README
@@ -36,6 +36,22 @@ INSTALLATION
     The default output directory for html reports will be
     /var/www/squidanalyzer/.
 
+    On FreeBSD, if make install is freezing and you have the following
+    messages:
+
+            FreeBSD: Registering installation in the package database
+            FreeBSD: Cannot determine short module description
+            FreeBSD: Cannot determine module description
+
+    please proceed as follow:
+
+            perl Makefile.PL INSTALLDIRS=site
+            make
+            make install
+
+    as the issue is related to an install into the default Perl vendor
+    installdirs it will then use Perl site installdirs.
+
   Custom install
     You can create your fully customized SquidAnalyzer installation by using
     the Makefile.PL Perl script. Here is a sample:
diff --git a/doc/SquidAnalyzer.pod b/doc/SquidAnalyzer.pod
index 732e925..6494f0c 100644
--- a/doc/SquidAnalyzer.pod
+++ b/doc/SquidAnalyzer.pod
@@ -42,6 +42,21 @@ the squid-analyzer Perl script will be copied under /usr/local/bin.
 
 The default output directory for html reports will be /var/www/squidanalyzer/.
 
+On FreeBSD, if make install is freezing and you have the following messages:
+
+	FreeBSD: Registering installation in the package database
+	FreeBSD: Cannot determine short module description
+	FreeBSD: Cannot determine module description
+
+please proceed as follow:
+
+	perl Makefile.PL INSTALLDIRS=site
+	make
+	make install
+
+as the issue is related to an install into the default Perl vendor installdirs
+it will then use Perl site installdirs.
+
 =head2 Custom install
 
 You can create your fully customized SquidAnalyzer installation by using the
diff --git a/doc/squidanalyzer.3 b/doc/squidanalyzer.3
index efff20a..ec91e94 100644
--- a/doc/squidanalyzer.3
+++ b/doc/squidanalyzer.3
@@ -133,7 +133,7 @@
 .\" ========================================================================
 .\"
 .IX Title "SQUIDANALYZER 1"
-.TH SQUIDANALYZER 1 "2012-12-24" "perl v5.10.1" "User Contributed Perl Documentation"
+.TH SQUIDANALYZER 1 "2013-01-28" "perl v5.10.1" "User Contributed Perl Documentation"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -178,6 +178,25 @@ library SquidAnalyzer.pm will be installed under your site_perl directory and
 the squid-analyzer Perl script will be copied under /usr/local/bin.
 .PP
 The default output directory for html reports will be /var/www/squidanalyzer/.
+.PP
+On FreeBSD, if make install is freezing and you have the following messages:
+.PP
+.Vb 3
+\&        FreeBSD: Registering installation in the package database
+\&        FreeBSD: Cannot determine short module description
+\&        FreeBSD: Cannot determine module description
+.Ve
+.PP
+please proceed as follow:
+.PP
+.Vb 3
+\&        perl Makefile.PL INSTALLDIRS=site
+\&        make
+\&        make install
+.Ve
+.PP
+as the issue is related to an install into the default Perl vendor installdirs
+it will then use Perl site installdirs.
 .SS "Custom install"
 .IX Subsection "Custom install"
 You can create your fully customized SquidAnalyzer installation by using the