Import most FAQ items from old web site

Import most of the FAQ entries from our old web site.  A few outdated
questions have been omitted, many of the imported ones were updated in
one way or another, and the order of the development-related questions
has been changed.  Also, the phrasing of some questions has been
modified (just to make the headings shorter).

For the record, this is the original list of questions from the old web
site:

General
-------

* Who controls the Nagios Plugins project?
* What license is Nagios Plugins distributed under?
* Who owns the copyright for the Nagios Plugin code?
* Can I submit a patch to this project?
* Do you accept donations?

Compiling
---------

* ./configure appears to hang
* check_ldap, check_radius or check_pgsql don't compile even though
  configure output says the required libraries are present
* How come check_http/check_tcp doesn't work with --ssl?
* How do I compile the Nagios::Plugin perl module?
* I can't compile check_mysql on solaris
* I get '":types" is not exported by the Params::Validate module' when
  running tests
* Why does Solaris use pst3 for check_procs?

Installing
----------

* Some of the root plugins (check_dhcp and check_icmp) haven't been
  installed.  What's happening?
* Why aren't my plugins installed as the nagios user?  And what about
  root plugins?

Development
-----------

* How do I use Git?
* Can I add extra tests to the C routines?
* Can I use the Nagios Plugins in my own project?
* How can I find out more about writing a plugin?
* How do I make changes on nagiosmib?
* How do I prove the C routines work?
* How do I use and update Gnulib?
* How do I use the Nagios::Plugin perl module?
* How do the test parameters in NPTest.pm work?
* Private C APIs

1 files changed, 37 insertions, 0 deletions

diff --git a/web/input/doc/faq/use-perl-module.md b/web/input/doc/faq/use-perl-module.md
new file mode 100644
index 0000000..64ba18a
--- /dev/null
+++ b/web/input/doc/faq/use-perl-module.md
@@ -0,0 +1,37 @@
+title: Using Nagios::Plugin
+parent: FAQ
+---
+
+# How do I use the Nagios::Plugin module?
+
+The Nagios::Plugin Perl module can be obtained from two main locations:
+
+* from the Nagios Plugins tarball with an
+  [extra configure option][configure-module]
+* from [CPAN][cpan-module]
+
+If you install from the Nagios Plugins tarball, the Perl module will be
+installed in `$prefix/perl`.
+
+If you install from CPAN, the Perl module will be installed into your Perl's
+system directories by default.
+
+To write your plugin, you should start it with:
+
+    use FindBin;
+    use lib "$FindBin::Bin/../perl/lib";
+    use Nagios::Plugin;
+
+This bit of code tells Perl to look for the Nagios::Plugin module in a
+directory relative to where the plugin is executed - this is a hard
+dependency.  If Nagios::Plugin is not found there, Perl's system directories
+will be searched.
+
+This approach allows a system administrator to decide whether they want
+Nagios::Plugin installed via system directories or within the `$prefix` area
+of the plugins.
+
+[configure-module]: doc/faq/build-perl-module.html "configure with Nagios::Plugin"
+[cpan-module]: http://search.cpan.org/dist/Nagios-Plugin/ "Nagios::Plugin on CPAN"
+
+<!--% # vim:set filetype=markdown textwidth=78 joinspaces: # %-->