1.1 --- a/tools/fix.sh Mon Dec 19 23:39:20 2016 +0100
1.2 +++ b/tools/fix.sh Tue Dec 20 15:55:29 2016 +0100
1.3 @@ -1,5 +1,24 @@
1.4 #!/bin/sh
1.5
1.6 +# This tool fixes permissions on data stores and published data, making sure
1.7 +# that the imip-agent can update the directories involved and that the
1.8 +# permissions persist.
1.9 +#
1.10 +# Copyright (C) 2015, 2016 Paul Boddie <paul@boddie.org.uk>
1.11 +#
1.12 +# This program is free software; you can redistribute it and/or modify it under
1.13 +# the terms of the GNU General Public License as published by the Free Software
1.14 +# Foundation; either version 3 of the License, or (at your option) any later
1.15 +# version.
1.16 +#
1.17 +# This program is distributed in the hope that it will be useful, but WITHOUT
1.18 +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
1.19 +# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
1.20 +# details.
1.21 +#
1.22 +# You should have received a copy of the GNU General Public License along with
1.23 +# this program. If not, see <http://www.gnu.org/licenses/>.
1.24 +
1.25 DIRNAME=`dirname "$0"`
1.26
1.27 if [ -e "$DIRNAME/config.sh" ]; then
2.1 --- a/tools/i18n_format.sh Mon Dec 19 23:39:20 2016 +0100
2.2 +++ b/tools/i18n_format.sh Tue Dec 20 15:55:29 2016 +0100
2.3 @@ -1,5 +1,23 @@
2.4 #!/bin/sh
2.5
2.6 +# This tool compiles textual messages from the message catalogues for
2.7 +# imip-agent using the gettext software.
2.8 +#
2.9 +# Copyright (C) 2015, 2016 Paul Boddie <paul@boddie.org.uk>
2.10 +#
2.11 +# This program is free software; you can redistribute it and/or modify it under
2.12 +# the terms of the GNU General Public License as published by the Free Software
2.13 +# Foundation; either version 3 of the License, or (at your option) any later
2.14 +# version.
2.15 +#
2.16 +# This program is distributed in the hope that it will be useful, but WITHOUT
2.17 +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
2.18 +# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
2.19 +# details.
2.20 +#
2.21 +# You should have received a copy of the GNU General Public License along with
2.22 +# this program. If not, see <http://www.gnu.org/licenses/>.
2.23 +
2.24 if ! which msgfmt > /dev/null 2>&1 ; then
2.25 exit 1
2.26 fi
3.1 --- a/tools/i18n_messages.sh Mon Dec 19 23:39:20 2016 +0100
3.2 +++ b/tools/i18n_messages.sh Tue Dec 20 15:55:29 2016 +0100
3.3 @@ -1,5 +1,23 @@
3.4 #!/bin/sh
3.5
3.6 +# This tool extracts textual messages from the imip-agent program files, using
3.7 +# the gettext software to merge updated messages with the existing catalogues.
3.8 +#
3.9 +# Copyright (C) 2015, 2016 Paul Boddie <paul@boddie.org.uk>
3.10 +#
3.11 +# This program is free software; you can redistribute it and/or modify it under
3.12 +# the terms of the GNU General Public License as published by the Free Software
3.13 +# Foundation; either version 3 of the License, or (at your option) any later
3.14 +# version.
3.15 +#
3.16 +# This program is distributed in the hope that it will be useful, but WITHOUT
3.17 +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
3.18 +# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
3.19 +# details.
3.20 +#
3.21 +# You should have received a copy of the GNU General Public License along with
3.22 +# this program. If not, see <http://www.gnu.org/licenses/>.
3.23 +
3.24 # Obtain messages from the Python files.
3.25
3.26 find imiptools imipweb -type f -name '*.py' \
4.1 --- a/tools/init.sh Mon Dec 19 23:39:20 2016 +0100
4.2 +++ b/tools/init.sh Tue Dec 20 15:55:29 2016 +0100
4.3 @@ -1,5 +1,25 @@
4.4 #!/bin/sh
4.5
4.6 +# This tool initialises a deployment of imip-agent, creating data stores and
4.7 +# published data directories, creating and initialising databases, and setting
4.8 +# filesystem permissions. It is configured using the contents of the config.sh
4.9 +# script.
4.10 +#
4.11 +# Copyright (C) 2015, 2016 Paul Boddie <paul@boddie.org.uk>
4.12 +#
4.13 +# This program is free software; you can redistribute it and/or modify it under
4.14 +# the terms of the GNU General Public License as published by the Free Software
4.15 +# Foundation; either version 3 of the License, or (at your option) any later
4.16 +# version.
4.17 +#
4.18 +# This program is distributed in the hope that it will be useful, but WITHOUT
4.19 +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
4.20 +# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
4.21 +# details.
4.22 +#
4.23 +# You should have received a copy of the GNU General Public License along with
4.24 +# this program. If not, see <http://www.gnu.org/licenses/>.
4.25 +
4.26 DIRNAME=`dirname "$0"`
4.27 CONFIG="$DIRNAME/config.sh"
4.28
5.1 --- a/tools/init_user.sh Mon Dec 19 23:39:20 2016 +0100
5.2 +++ b/tools/init_user.sh Tue Dec 20 15:55:29 2016 +0100
5.3 @@ -1,5 +1,23 @@
5.4 #!/bin/sh
5.5
5.6 +# This tool initialises users within data stores and published data
5.7 +# directories. It is configured using the contents of the config.sh script.
5.8 +#
5.9 +# Copyright (C) 2015, 2016 Paul Boddie <paul@boddie.org.uk>
5.10 +#
5.11 +# This program is free software; you can redistribute it and/or modify it under
5.12 +# the terms of the GNU General Public License as published by the Free Software
5.13 +# Foundation; either version 3 of the License, or (at your option) any later
5.14 +# version.
5.15 +#
5.16 +# This program is distributed in the hope that it will be useful, but WITHOUT
5.17 +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
5.18 +# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
5.19 +# details.
5.20 +#
5.21 +# You should have received a copy of the GNU General Public License along with
5.22 +# this program. If not, see <http://www.gnu.org/licenses/>.
5.23 +
5.24 DIRNAME=`dirname "$0"`
5.25
5.26 if [ -e "$DIRNAME/config.sh" ]; then
6.1 --- a/tools/install.sh Mon Dec 19 23:39:20 2016 +0100
6.2 +++ b/tools/install.sh Tue Dec 20 15:55:29 2016 +0100
6.3 @@ -1,5 +1,23 @@
6.4 #!/bin/sh
6.5
6.6 +# This tool installs the imip-agent software and message resources. It is
6.7 +# configured by the contents of the config.sh script.
6.8 +#
6.9 +# Copyright (C) 2014, 2015, 2016 Paul Boddie <paul@boddie.org.uk>
6.10 +#
6.11 +# This program is free software; you can redistribute it and/or modify it under
6.12 +# the terms of the GNU General Public License as published by the Free Software
6.13 +# Foundation; either version 3 of the License, or (at your option) any later
6.14 +# version.
6.15 +#
6.16 +# This program is distributed in the hope that it will be useful, but WITHOUT
6.17 +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
6.18 +# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
6.19 +# details.
6.20 +#
6.21 +# You should have received a copy of the GNU General Public License along with
6.22 +# this program. If not, see <http://www.gnu.org/licenses/>.
6.23 +
6.24 DIRNAME=`dirname "$0"`
6.25
6.26 if [ -e "$DIRNAME/config.sh" ]; then