diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/LEAVERS | 2 | ||||
-rw-r--r-- | doc/NEW_STARTERS | 8 | ||||
-rw-r--r-- | doc/RELEASING | 15 | ||||
-rw-r--r-- | doc/developer-guidelines.sgml | 59 |
4 files changed, 38 insertions, 46 deletions
diff --git a/doc/LEAVERS b/doc/LEAVERS index 65af310..a52a600 100644 --- a/doc/LEAVERS +++ b/doc/LEAVERS | |||
@@ -10,5 +10,5 @@ Administration tasks: | |||
10 | - Remove from GitHub's project members. This will include Git access. | 10 | - Remove from GitHub's project members. This will include Git access. |
11 | - Remove access from project server | 11 | - Remove access from project server |
12 | - If applicable, remove from mailing list administrators | 12 | - If applicable, remove from mailing list administrators |
13 | - Keep on nagiosplug-team mailing list, unless specifically requested to be removed | 13 | - Keep on team mailing list, unless specifically requested to be removed |
14 | 14 | ||
diff --git a/doc/NEW_STARTERS b/doc/NEW_STARTERS index ba19449..2c5aac8 100644 --- a/doc/NEW_STARTERS +++ b/doc/NEW_STARTERS | |||
@@ -4,12 +4,12 @@ These are the steps for adding someone to the team. | |||
4 | 4 | ||
5 | Need to know: | 5 | Need to know: |
6 | - Name | 6 | - Name |
7 | - Primary email for nagiosplug-team mailings | 7 | - Primary email for team mailings |
8 | - GitHub account | 8 | - GitHub account |
9 | - Type of member (translator, developer, release manager, project administrator) | 9 | - Type of member (translator, developer, release manager, project administrator) |
10 | 10 | ||
11 | 1. Add member to nagiosplug-team mailing list (https://lists.sourceforge.net/lists/admin/nagiosplug-team) | 11 | 1. Add member to team mailing list (https://www.monitoring-plugins.org/list/listinfo/team/) |
12 | and to the nagiosplug-checkins mailing list (https://lists.sourceforge.net/lists/admin/nagiosplug-checkins, | 12 | and to the commits mailing list (https://www.monitoring-plugins.org/list/listinfo/commits/), |
13 | add sourceforge email address via Privacy Options->Sender filters) | 13 | add sourceforge email address via Privacy Options->Sender filters) |
14 | 2. Add Sourceforge access: | 14 | 2. Add Sourceforge access: |
15 | - Translator: CVS access, Shell access, Release Tech (no) | 15 | - Translator: CVS access, Shell access, Release Tech (no) |
@@ -21,4 +21,4 @@ Need to know: | |||
21 | 3. Create account on project server | 21 | 3. Create account on project server |
22 | - Add public ssh keys | 22 | - Add public ssh keys |
23 | 4. Add Git access on repos.or.cz | 23 | 4. Add Git access on repos.or.cz |
24 | 5. Send email to nagiosplug-team introducing new member | 24 | 5. Send email to team introducing new member |
diff --git a/doc/RELEASING b/doc/RELEASING index 34bed93..1eaec9d 100644 --- a/doc/RELEASING +++ b/doc/RELEASING | |||
@@ -1,8 +1,5 @@ | |||
1 | NOTES ON RELEASING NEW VERSION OF NAGIOSPLUG | 1 | NOTES ON RELEASING NEW VERSION OF NAGIOSPLUG |
2 | 2 | ||
3 | NB: A copy of this document is located at: | ||
4 | http://nagiosplugins.org/node/96 | ||
5 | |||
6 | *** Pre-release | 3 | *** Pre-release |
7 | git pull | 4 | git pull |
8 | . tools/devmode, if feeling adventurous | 5 | . tools/devmode, if feeling adventurous |
@@ -24,15 +21,15 @@ git push origin master | |||
24 | git push origin release-1.4.14 | 21 | git push origin release-1.4.14 |
25 | 22 | ||
26 | *** Checkout new version | 23 | *** Checkout new version |
27 | rm -fr /tmp/nagioslug | 24 | rm -fr /tmp/monitoringlug |
28 | # If you need to checkout the tag, don't forget to "checkout master" later to | 25 | # If you need to checkout the tag, don't forget to "checkout master" later to |
29 | # get back to your development branch: | 26 | # get back to your development branch: |
30 | git checkout tags/release-1.4.14 | 27 | git checkout tags/release-1.4.14 |
31 | # Beware: the trailing slash of --prefix is REQUIRED | 28 | # Beware: the trailing slash of --prefix is REQUIRED |
32 | git checkout-index --prefix=/tmp/nagioslug/ -a | 29 | git checkout-index --prefix=/tmp/monitoringlug/ -a |
33 | 30 | ||
34 | *** Build the tarball | 31 | *** Build the tarball |
35 | cd /tmp/nagioslug | 32 | cd /tmp/monitoringlug |
36 | tools/setup | 33 | tools/setup |
37 | ./configure | 34 | ./configure |
38 | make dist | 35 | make dist |
@@ -43,7 +40,7 @@ SF username and password | |||
43 | cd /uploads | 40 | cd /uploads |
44 | put file | 41 | put file |
45 | 42 | ||
46 | SF -> Submit News about release. Make sure it is called "Nagios Plugins" (with those caps) | 43 | SF -> Submit News about release. Make sure it is called "Monitoring Plugins" (with those caps) |
47 | Link to download at http://sourceforge.net/project/showfiles.php?group_id=29880 | 44 | Link to download at http://sourceforge.net/project/showfiles.php?group_id=29880 |
48 | Include contents of NEWS for this release | 45 | Include contents of NEWS for this release |
49 | List all people on team involved. | 46 | List all people on team involved. |
@@ -60,5 +57,5 @@ Step 3: *.tar.gz, Platform Independent, Source .gz | |||
60 | Step 4: Send notice | 57 | Step 4: Send notice |
61 | 58 | ||
62 | *** Announce new release | 59 | *** Announce new release |
63 | Send email to nagiosplug-help, nagios-announce with the news text | 60 | Send email to help, announce with the news text |
64 | Add a news item to http://nagiosplugins.org | 61 | Add a news item to https://monitoring-plugins.org |
diff --git a/doc/developer-guidelines.sgml b/doc/developer-guidelines.sgml index 61b9f17..d934028 100644 --- a/doc/developer-guidelines.sgml +++ b/doc/developer-guidelines.sgml | |||
@@ -1,18 +1,18 @@ | |||
1 | <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" > | 1 | <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN" > |
2 | <book> | 2 | <book> |
3 | <title>Nagios Plugin Development Guidelines</title> | 3 | <title>Monitoring Plugins Development Guidelines</title> |
4 | 4 | ||
5 | <bookinfo> | 5 | <bookinfo> |
6 | <authorgroup> | 6 | <authorgroup> |
7 | <author> | 7 | <author> |
8 | <affiliation> | 8 | <affiliation> |
9 | <orgname>Nagios Plugins Development Team</orgname> | 9 | <orgname>Monitoring Plugins Development Team</orgname> |
10 | </affiliation> | 10 | </affiliation> |
11 | </author> | 11 | </author> |
12 | </authorgroup> | 12 | </authorgroup> |
13 | 13 | ||
14 | <pubdate>2013</pubdate> | 14 | <pubdate>2013</pubdate> |
15 | <title>Nagios Plugin Development Guidelines</title> | 15 | <title>Monitoring Plugins Development Guidelines</title> |
16 | 16 | ||
17 | <revhistory> | 17 | <revhistory> |
18 | <revision> | 18 | <revision> |
@@ -23,7 +23,7 @@ | |||
23 | 23 | ||
24 | <copyright> | 24 | <copyright> |
25 | <year>2000 - 2013</year> | 25 | <year>2000 - 2013</year> |
26 | <holder>Nagios Plugins Development Team</holder> | 26 | <holder>Monitoring Plugins Development Team</holder> |
27 | </copyright> | 27 | </copyright> |
28 | 28 | ||
29 | </bookinfo> | 29 | </bookinfo> |
@@ -34,8 +34,8 @@ | |||
34 | the plugin developers and encourage the standarization of the | 34 | the plugin developers and encourage the standarization of the |
35 | different kind of plugins: C, shell, perl, python, etc.</para> | 35 | different kind of plugins: C, shell, perl, python, etc.</para> |
36 | 36 | ||
37 | <para>Nagios Plugin Development Guidelines Copyright (C) 2000-2013 | 37 | <para>Monitoring Plugins Development Guidelines Copyright (C) 2000-2013 |
38 | (Nagios Plugins Team)</para> | 38 | (Monitoring Plugins Team)</para> |
39 | 39 | ||
40 | <para>Permission is granted to make and distribute verbatim | 40 | <para>Permission is granted to make and distribute verbatim |
41 | copies of this manual provided the copyright notice and this | 41 | copies of this manual provided the copyright notice and this |
@@ -48,8 +48,8 @@ | |||
48 | <article> | 48 | <article> |
49 | <section id="DevRequirements"><title>Development platform requirements</title> | 49 | <section id="DevRequirements"><title>Development platform requirements</title> |
50 | <para> | 50 | <para> |
51 | Nagios Plugins are developed to the GNU standard, so any OS which is supported by GNU | 51 | Monitoring Plugins are developed to the GNU standard, so any OS which is supported by GNU |
52 | should run the plugins. While the requirements for compiling the Nagios Plugins release | 52 | should run the plugins. While the requirements for compiling the Monitoring Plugins release |
53 | are very basic, developing from the Git repository requires additional software to be | 53 | are very basic, developing from the Git repository requires additional software to be |
54 | installed. These are the minimum levels of software required: | 54 | installed. These are the minimum levels of software required: |
55 | 55 | ||
@@ -152,7 +152,7 @@ | |||
152 | <section><title>Plugin Return Codes</title> | 152 | <section><title>Plugin Return Codes</title> |
153 | <para>The return codes below are based on the POSIX spec of returning | 153 | <para>The return codes below are based on the POSIX spec of returning |
154 | a positive value. Netsaint prior to v0.0.7 supported non-POSIX | 154 | a positive value. Netsaint prior to v0.0.7 supported non-POSIX |
155 | compliant return code of "-1" for unknown. Nagios supports POSIX return | 155 | compliant return code of "-1" for unknown. Nagios supports POSIX return |
156 | codes by default.</para> | 156 | codes by default.</para> |
157 | 157 | ||
158 | <para>Note: Some plugins will on occasion print on STDOUT that an error | 158 | <para>Note: Some plugins will on occasion print on STDOUT that an error |
@@ -379,7 +379,7 @@ | |||
379 | </listitem> | 379 | </listitem> |
380 | </orderedlist> | 380 | </orderedlist> |
381 | 381 | ||
382 | <para>It is up to third party programs to convert the Nagios Plugins | 382 | <para>It is up to third party programs to convert the Monitoring Plugins |
383 | performance data into graphs.</para> | 383 | performance data into graphs.</para> |
384 | </section> | 384 | </section> |
385 | 385 | ||
@@ -678,11 +678,6 @@ To run a test, from the top level directory, run "make test". This will run | |||
678 | all the current tests and report an overall success rate. | 678 | all the current tests and report an overall success rate. |
679 | </para> | 679 | </para> |
680 | 680 | ||
681 | <para> | ||
682 | See the <ulink url="http://tinderbox.opsera.com">Nagios Plugins Tinderbox server</ulink> | ||
683 | for the daily test results. | ||
684 | </para> | ||
685 | |||
686 | <section><title>Test cases for plugins</title> | 681 | <section><title>Test cases for plugins</title> |
687 | <para>These use perl's Test::More. To do a one time test, run "cd plugins && perl t/check_disk.t". | 682 | <para>These use perl's Test::More. To do a one time test, run "cd plugins && perl t/check_disk.t". |
688 | </para> | 683 | </para> |
@@ -699,7 +694,7 @@ This runs the test in a summary format. | |||
699 | 694 | ||
700 | <para> | 695 | <para> |
701 | For a good and amusing tutorial on using Test::More, see this | 696 | For a good and amusing tutorial on using Test::More, see this |
702 | <ulink url="http://search.cpan.org/~mschwern/Test-Simple-0.62/lib/Test/Tutorial.pod"> | 697 | <ulink url="http://search.cpan.org/dist/Test-Simple/lib/Test/Tutorial.pod"> |
703 | link</ulink> | 698 | link</ulink> |
704 | </para> | 699 | </para> |
705 | 700 | ||
@@ -720,7 +715,7 @@ properly on non-FreeBSD systems. Install with 'CPPFLAGS="-UHAVE_LIBPTHREAD" ./co | |||
720 | </para> | 715 | </para> |
721 | 716 | ||
722 | <para> | 717 | <para> |
723 | When you run Nagios Plugins' configure, it will look for the tap library and will automatically | 718 | When you run Monitoring Plugins' configure, it will look for the tap library and will automatically |
724 | setup the tests. Run "make test" to run all the tests. | 719 | setup the tests. Run "make test" to run all the tests. |
725 | </para> | 720 | </para> |
726 | </section> | 721 | </section> |
@@ -752,9 +747,9 @@ setup the tests. Run "make test" to run all the tests. | |||
752 | </section> | 747 | </section> |
753 | 748 | ||
754 | <section><title>Commit Messages</title> | 749 | <section><title>Commit Messages</title> |
755 | <para>If the change is due to a contribution, please quote the contributor's name | 750 | <para>If the change is due to a contribution, please quote the contributor's name |
756 | and, if applicable, add the SourceForge Tracker number. Don't forget to | 751 | and, if applicable, add the GitHub Issue Tracker number. Don't forget to |
757 | update the THANKS.in file.</para> | 752 | update the THANKS.in file.</para> |
758 | <para>If you have a change that is useful for noting in the next release, please | 753 | <para>If you have a change that is useful for noting in the next release, please |
759 | update the NEWS file.</para> | 754 | update the NEWS file.</para> |
760 | <para>All commits will be written to a ChangeLog at release time. | 755 | <para>All commits will be written to a ChangeLog at release time. |
@@ -765,7 +760,7 @@ update the THANKS.in file.</para> | |||
765 | <para>To make the job easier for translators, please follow these guidelines:</para> | 760 | <para>To make the job easier for translators, please follow these guidelines:</para> |
766 | <orderedlist> | 761 | <orderedlist> |
767 | <listitem><para> | 762 | <listitem><para> |
768 | Before creating new strings, check the po/nagios-plugins.pot file to | 763 | Before creating new strings, check the po/monitoring-plugins.pot file to |
769 | see if a similar string | 764 | see if a similar string |
770 | already exists | 765 | already exists |
771 | </para></listitem> | 766 | </para></listitem> |
@@ -795,15 +790,15 @@ update the THANKS.in file.</para> | |||
795 | version you are using. For new features, please supply a diff against | 790 | version you are using. For new features, please supply a diff against |
796 | the Git "master" branch.</para> | 791 | the Git "master" branch.</para> |
797 | 792 | ||
798 | <para>Patches should be submitted via | 793 | <para>Patches should be submitted via |
799 | <ulink url="http://sourceforge.net/tracker/?group_id=29880&atid=397599">SourceForge's | 794 | <ulink url="https://github.com/monitoring-plugins/monitoring-plugins/pulls">GitHub's |
800 | tracker system for Nagiosplug patches</ulink> | 795 | Pull requests for Monitoring Plugins</ulink> |
801 | and be announced to the nagiosplug-devel mailing list.</para> | 796 | </para> |
802 | 797 | ||
803 | <para>Submission of a patch implies that the submmitter acknowledges that they | 798 | <para>Submission of a patch implies that the submmitter acknowledges that they |
804 | are the author of the code (or have permission from the author to release the code) | 799 | are the author of the code (or have permission from the author to release the code) |
805 | and agree that the code can be released under the GPL. The copyright for the changes will | 800 | and agree that the code can be released under the GPL. The copyright for the changes will |
806 | then revert to the Nagios Plugin Development Team - this is required so that any copyright | 801 | then revert to the Monitoring Plugins Development Team - this is required so that any copyright |
807 | infringements can be investigated quickly without contacting a huge list of copyright holders. | 802 | infringements can be investigated quickly without contacting a huge list of copyright holders. |
808 | Credit will always be given for any patches through a THANKS file in the distribution.</para> | 803 | Credit will always be given for any patches through a THANKS file in the distribution.</para> |
809 | </section> | 804 | </section> |
@@ -811,22 +806,22 @@ update the THANKS.in file.</para> | |||
811 | 806 | ||
812 | <section id="Contributedplugins"><title>Contributed plugins</title> | 807 | <section id="Contributedplugins"><title>Contributed plugins</title> |
813 | <para>Plugins that have been contributed to the project and | 808 | <para>Plugins that have been contributed to the project and |
814 | distributed with the Nagios Plugin files are held in the contrib/ directory and are not installed | 809 | distributed with the Monitoring Plugins files are held in the contrib/ directory and are not installed |
815 | by default. These plugins are not officially supported by the team. | 810 | by default. These plugins are not officially supported by the team. |
816 | The current policy is that these plugins should be owned and maintained by the original | 811 | The current policy is that these plugins should be owned and maintained by the original |
817 | contributor, preferably hosted on <ulink url="http://exchange.nagios.org">Nagios Exchange</ulink>. | 812 | contributor, preferably hosted on <ulink url="http://monitoringexchange.org">Monitoring Exchange</ulink>. |
818 | </para> | 813 | </para> |
819 | <para>If patches or bugs are raised to an contributed plugin, we will start communications with the | 814 | <para>If patches or bugs are raised to an contributed plugin, we will start communications with the |
820 | original contributor, but seek to remove the plugin from our distribution. | 815 | original contributor, but seek to remove the plugin from our distribution. |
821 | </para> | 816 | </para> |
822 | <para>The aim is to distribute only code that the Nagios Plugin team are responsible for. | 817 | <para>The aim is to distribute only code that the Monitoring Plugins team are responsible for. |
823 | </para> | 818 | </para> |
824 | </section> | 819 | </section> |
825 | 820 | ||
826 | <section id="Newplugins"><title>New plugins</title> | 821 | <section id="Newplugins"><title>New plugins</title> |
827 | <para>If you would like others to use your plugins, please add it to | 822 | <para>If you would like others to use your plugins, please add it to |
828 | the official 3rd party plugin repository, | 823 | the official 3rd party plugin repository, |
829 | <ulink url="http://exchange.nagios.org">Nagios Exchange</ulink>. | 824 | <ulink url="http://monitoringexchange.org">Monitoring Exchange</ulink>. |
830 | </para> | 825 | </para> |
831 | 826 | ||
832 | <para>We are not accepting requests for inclusion of plugins into | 827 | <para>We are not accepting requests for inclusion of plugins into |
@@ -837,7 +832,7 @@ update the THANKS.in file.</para> | |||
837 | <orderedlist> | 832 | <orderedlist> |
838 | <listitem> | 833 | <listitem> |
839 | <para>Include copyright and license information in all files. Copyright must be solely | 834 | <para>Include copyright and license information in all files. Copyright must be solely |
840 | granted to the Nagios Plugin Development Team</para> | 835 | granted to the Monitoring Plugins Development Team</para> |
841 | </listitem> | 836 | </listitem> |
842 | <listitem> | 837 | <listitem> |
843 | <para>The standard command options are supported (--help, --version, | 838 | <para>The standard command options are supported (--help, --version, |