git.lirion.de

Of git, get, and gud

summaryrefslogtreecommitdiffstats
path: root/nagios-plugins-contrib-24.20190301~bpo9+1/debian/README.source
diff options
context:
space:
mode:
Diffstat (limited to 'nagios-plugins-contrib-24.20190301~bpo9+1/debian/README.source')
-rw-r--r--nagios-plugins-contrib-24.20190301~bpo9+1/debian/README.source66
1 files changed, 66 insertions, 0 deletions
diff --git a/nagios-plugins-contrib-24.20190301~bpo9+1/debian/README.source b/nagios-plugins-contrib-24.20190301~bpo9+1/debian/README.source
new file mode 100644
index 0000000..a66d688
--- /dev/null
+++ b/nagios-plugins-contrib-24.20190301~bpo9+1/debian/README.source
@@ -0,0 +1,66 @@
+nagios-plugins-contrib - Plugins for nagios compatible monitoring systems
+--------------------------------------------------------------------------
+
+
+This README.source should give a short instruction about the
+way the pkg-nagios-plugins-contrib repository is structured
+and defines basic policies.
+
+* build-system: git-buildpackage. As we build a Debian native
+ package pristine-tar is not necessary.
+
+* debian/changelog:
+ - preferable generated using git-dch
+ - versioning schema: X.$(date '+%Y%m%d'). X will be
+ increased by one with each release. In case there are
+ bugfixes in stable releases necessary, use
+ X.$(date '+%Y%m%d').Y
+ See http://kitenet.net/~joey/blog/entry/version_numbers/
+ for details.
+
+* debian/copyright.in, debian/control.in:
+ Base files we fill automatically with information from
+ all plugins to generate the full files.
+ This is done in the clean target.
+ DO NOT MODIFY debian/control or debian/copyright!
+
+* nagios plugins:
+ - one directory per plugin
+ - required files:
+ * $plugin/control: file format similar to debian/control.
+ - Required is the Description and Uploaders part.
+ Add Build-Depends, Recommends, Suggests
+ and Homepage to have their content added to debian/control/
+ debian/copyright. Don't use Depends as we don't want to force
+ people to install dependencies for a plugin they might not
+ want to use.
+ - Add Version to be able to track an upstream version of
+ the plugin.
+ - Add Watch to check for new versions using
+ ./debian/packaging-helper.py
+ Format:
+ Watch URL python-regex
+ Watch URL SHA1:sha1sum
+ - Don't add empty lines - only the first paragraph will be
+ handled.
+ * $plugin/copyright: copyright information for the files
+ in $plugin. Will be added to debian/copyright
+ automatically, properly indented and with a header which
+ describes that the coming block is for the files in $plugin.
+ ** DEP-5 IS NOT SUPPORTED **
+ - what you should have:
+ Currently there are two options on how to build and install
+ plugins:
+ * you have a single script or file or need some hand-made
+ build system anyway:
+ add $plugin/Makefile and implement the all / install / clean
+ targets. include ../common.mk is there for common tasks.
+ If $plugin/Makefile exists the way described below *will not*
+ be built.
+ * your plugin comes with a fancy build system already:
+ extract the source in $plugin and let a symlink called 'src'
+ point to the subdirectory of $plugin.
+ If dh_auto_* is not able to build the plugin, please use
+ the Makefile way as described above.
+ Please ensure that a proper .cfg file will be installed.
+