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, 36 insertions, 0 deletions

diff --git a/web/input/doc/faq/gnulib.md b/web/input/doc/faq/gnulib.md
new file mode 100644
index 0000000..328dfeb
--- /dev/null
+++ b/web/input/doc/faq/gnulib.md
@@ -0,0 +1,36 @@
+title: Gnulib
+parent: FAQ
+---
+
+# How do I use and update Gnulib?
+
+[Gnulib][gnulib] provides replacement implementations of functions that are
+not available on all (Unix-like) operating systems.  In order to sync with the
+latest Gnulib code, do something like:
+
+    git clone git://git.savannah.gnu.org/gnulib.git
+    cd gnulib
+    GNULIB_HEAD=$(git rev-parse --short HEAD)
+    cd ..
+    git clone git@github.com:nagios-plugins/nagios-plugins.git
+    cd nagios-plugins
+    ../gnulib/gnulib-tool --update
+    find gl -name '*~' -o -name '.gitignore' | xargs rm
+    git status
+    git add gl
+    git commit -m "Sync with latest Gnulib code ($GNULIB_HEAD)"
+
+In order to make a given function available via Gnulib (on systems which don't
+provide that function), the [corresponding module][modules] must be imported
+using `gnulib-tool`, e.g. (in order to add the `strcase` module):
+
+    ../gnulib/gnulib-tool --no-vc-files --import strcase
+    find gl -name '*~' | xargs rm
+    git status
+    git add gl
+    git commit -m 'Add Gnulib module "strcase"'
+
+[gnulib]: http://www.gnu.org/software/gnulib/ "Gnulib"
+[modules]: http://www.gnu.org/software/gnulib/MODULES.html "Gnulib Modules"
+
+<!--% # vim:set filetype=markdown textwidth=78 joinspaces: # %-->