Release 1.7.2

thiell · thiell · commit 6c3cba7abbbe · 2016-06-20T07:57:00.000-07:00
Change-Id: I5c58391aadb8cc663a72c6659a2370a8c9fec25c
diff --git a/clustershell.spec.in b/clustershell.spec.in
@@ -101,6 +101,12 @@ rm -rf %{buildroot}
 %{vimdatadir}/syntax/groupsconf.vim
 
 %changelog
+* Sat Jun 18 2016 Stephane Thiell <sthiell@stanford.edu> 1.7.2-1
+- update to 1.7.2
+
+* Mon Feb 29 2016 Stephane Thiell <sthiell@stanford.edu> 1.7.1-1
+- update to 1.7.1
+
 * Tue Nov 10 2015 Stephane Thiell <sthiell@stanford.edu> 1.7-1
 - update to 1.7
 
diff --git a/doc/man/man1/clush.1 b/doc/man/man1/clush.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH CLUSH 1 "2016-06-16" "1.7.2" "ClusterShell User Manual"
+.TH CLUSH 1 "2016-06-18" "1.7.2" "ClusterShell User Manual"
 .SH NAME
 clush \- execute shell commands on a cluster
 .
@@ -276,6 +276,9 @@ limit time for command to run on the node
 .TP
 .BI \-R \ WORKER\fP,\fB \ \-\-worker\fB= WORKER
 worker name to use for connection (\fBexec\fP, \fBssh\fP, \fBrsh\fP, \fBpdsh\fP), default is \fBssh\fP
+.TP
+.BI \-\-remote\fB= REMOTE
+whether to enable remote execution: in tree mode, \(aqyes\(aq forces connections to the leaf nodes for execution, \(aqno\(aq establishes connections up to the leaf parent nodes for execution (default is \(aqyes\(aq)
 .UNINDENT
 .UNINDENT
 .sp
diff --git a/doc/man/man1/nodeset.1 b/doc/man/man1/nodeset.1
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH NODESET 1 "2016-06-16" "1.7.2" "ClusterShell User Manual"
+.TH NODESET 1 "2016-06-18" "1.7.2" "ClusterShell User Manual"
 .SH NAME
 nodeset \- compute advanced nodeset operations
 .
diff --git a/doc/man/man5/clush.conf.5 b/doc/man/man5/clush.conf.5
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH CLUSH.CONF 5 "2016-02-28" "1.7.1" "ClusterShell User Manual"
+.TH CLUSH.CONF 5 "2016-06-18" "1.7.2" "ClusterShell User Manual"
 .SH NAME
 clush.conf \- Configuration file for clush
 .
diff --git a/doc/man/man5/groups.conf.5 b/doc/man/man5/groups.conf.5
@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH GROUPS.CONF 5 "2016-02-28" "1.7.1" "ClusterShell User Manual"
+.TH GROUPS.CONF 5 "2016-06-18" "1.7.2" "ClusterShell User Manual"
 .SH NAME
 groups.conf \- Configuration file for ClusterShell node groups
 .
diff --git a/doc/sphinx/conf.py b/doc/sphinx/conf.py
@@ -41,16 +41,16 @@
 
 # General information about the project.
 project = u'clustershell'
-copyright = u'2015, Stephane Thiell'
+copyright = u'2016, Stephane Thiell'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = '1.7.1'
+version = '1.7.2'
 # The full version, including alpha/beta/rc tags.
-release = '1.7.1'
+release = '1.7.2'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -240,7 +240,8 @@ def setup(app):
 #  dir menu entry, description, category)
 texinfo_documents = [
   ('index', 'clustershell', u'ClusterShell Documentation',
-   u'Stephane Thiell', 'clustershell', 'One line description of project.',
+   u'Stephane Thiell', 'clustershell',
+   'Manage node sets, node groups and execute commands on cluster',
    'Miscellaneous'),
 ]
 
diff --git a/doc/sphinx/release.rst b/doc/sphinx/release.rst
@@ -3,6 +3,27 @@
 Release Notes
 =============
 
+Version 1.7.2
+-------------
+
+This minor version fixes a defect in :ref:`tree mode <clush-tree>` that led
+to broken pipe errors or unwanted backtraces.
+
+The :class:`.NodeSet` class now supports the empty string as input. In
+practice, you may now safely reuse the output of a
+:ref:`nodeset <nodeset-tool>` command as input argument for another
+:ref:`nodeset <nodeset-tool>` command, even if the result is an empty string.
+
+A new option ``--pick`` is available for :ref:`clush <clush-pick>` and
+:ref:`nodeset <nodeset-pick>` to pick N node(s) at random from the resulting
+node set.
+
+For more details, please have a look at `GitHub Issues for 1.7.2 milestone`_.
+
+ClusterShell 1.7.2 is compatible with Python 2.4 up to Python 2.7 (for
+example: from RedHat EL5 to EL7). Upgrades from versions 1.6 or 1.7 are
+supported.
+
 Version 1.7.1
 -------------
 
@@ -249,4 +270,5 @@ configuration files::
 
 Please see :ref:`install-pip-user`.
 
-.. _GitHub Issues for 1.7.1 milestone: https://github.com/cea-hpc/clustershell/issues?utf8=%E2%9C%93&q=is%3Aissue+milestone%3A1.7.1+
+.. _GitHub Issues for 1.7.1 milestone: https://github.com/cea-hpc/clustershell/issues?utf8=%E2%9C%93&q=is%3Aissue+milestone%3A1.7.1
+.. _GitHub Issues for 1.7.2 milestone: https://github.com/cea-hpc/clustershell/issues?utf8=%E2%9C%93&q=is%3Aissue+milestone%3A1.7.2
diff --git a/doc/sphinx/tools/clush.rst b/doc/sphinx/tools/clush.rst
@@ -86,6 +86,8 @@ nodes, in the sense of ClusterShell node groups (see
     clush: External error: Not enough working external calls (all, or map +
     list) defined to get all node
 
+.. _clush-pick:
+
 Picking node(s) at random
 """""""""""""""""""""""""
 
diff --git a/doc/sphinx/tools/nodeset.rst b/doc/sphinx/tools/nodeset.rst
@@ -567,6 +567,7 @@ useful to fold along the last axis whatever number of dimensions used::
     $ nodeset --axis=-1 -f comp-[1-2]-[1-36],login-[1-2]
     comp-1-[1-36],comp-2-[1-36],login-[1-2]
 
+.. _nodeset-pick:
 
 Picking N node(s) at random
 """""""""""""""""""""""""""
diff --git a/doc/txt/clubak.txt b/doc/txt/clubak.txt
@@ -7,9 +7,9 @@ format output from clush/pdsh-like output and more
 --------------------------------------------------
 
 :Author: Stephane Thiell <sthiell@stanford.edu>
-:Date:   2016-02-28
+:Date:   2016-06-18
 :Copyright: CeCILL-C V1
-:Version: 1.7.1
+:Version: 1.7.2
 :Manual section: 1
 :Manual group: ClusterShell User Manual
 
diff --git a/doc/txt/clush.conf.txt b/doc/txt/clush.conf.txt
@@ -7,9 +7,9 @@ Configuration file for `clush`
 ------------------------------
 
 :Author: Stephane Thiell, <sthiell@stanford.edu>
-:Date:   2016-02-28
+:Date:   2016-06-18
 :Copyright: CeCILL-C V1
-:Version: 1.7.1
+:Version: 1.7.2
 :Manual section: 5
 :Manual group: ClusterShell User Manual
 
diff --git a/doc/txt/clush.txt b/doc/txt/clush.txt
@@ -7,7 +7,7 @@ execute shell commands on a cluster
 -----------------------------------
 
 :Author: Stephane Thiell <sthiell@stanford.edu>
-:Date:   2016-06-16
+:Date:   2016-06-18
 :Copyright: CeCILL-C V1
 :Version: 1.7.2
 :Manual section: 1
@@ -182,6 +182,7 @@ Connection options:
                       limit time for command to run on the node
   -R WORKER, --worker=WORKER
                       worker name to use for connection (``exec``, ``ssh``, ``rsh``, ``pdsh``), default is ``ssh``
+  --remote=REMOTE     whether to enable remote execution: in tree mode, 'yes' forces connections to the leaf nodes for execution, 'no' establishes connections up to the leaf parent nodes for execution (default is 'yes') 
 
 For a short explanation of these options, see ``-h, --help``.
 
diff --git a/doc/txt/groups.conf.txt b/doc/txt/groups.conf.txt
@@ -7,9 +7,9 @@ Configuration file for ClusterShell node groups
 -----------------------------------------------
 
 :Author: Stephane Thiell, <sthiell@stanford.edu>
-:Date:   2016-02-28
+:Date:   2016-06-18
 :Copyright: CeCILL-C V1
-:Version: 1.7.1
+:Version: 1.7.2
 :Manual section: 5
 :Manual group: ClusterShell User Manual
 
diff --git a/doc/txt/nodeset.txt b/doc/txt/nodeset.txt
@@ -7,7 +7,7 @@ compute advanced nodeset operations
 -----------------------------------
 
 :Author: Stephane Thiell <sthiell@stanford.edu>
-:Date:   2016-06-16
+:Date:   2016-06-18
 :Copyright: CeCILL-C V1
 :Version: 1.7.2
 :Manual section: 1
diff --git a/lib/ClusterShell/__init__.py b/lib/ClusterShell/__init__.py
@@ -48,8 +48,8 @@
   - ClusterShell.Task
 """
 
-__version__ = '1.7.1'
+__version__ = '1.7.2'
 __version_info__ = tuple([ int(_n) for _n in __version__.split('.')])
-__date__    = '2016/02/28'
+__date__    = '2016/06/18'
 __author__  = 'Stephane Thiell <sthiell@stanford.edu>'
 __url__     = 'http://clustershell.readthedocs.org/'
diff --git a/setup.py b/setup.py
@@ -49,7 +49,7 @@
     # User, in-prefix config install (rpmbuild or pip as user)
     CFGDIR = 'etc/clustershell'
 
-VERSION='1.7.1'
+VERSION='1.7.2'
 
 setup(name='ClusterShell',
       version=VERSION,
@@ -71,7 +71,7 @@
                'scripts/clush',
                'scripts/nodeset'],
       author='Stephane Thiell',
-      author_email='stephane.thiell@cea.fr',
+      author_email='sthiell@stanford.edu',
       license='CeCILL-C (French equivalent to LGPLv2+)',
       url='http://clustershell.sourceforge.net/',
       download_url='http://sourceforge.net/projects/clustershell/files/'

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`.\" Man page generated from reStructuredText.`
`2`	`2`	`.`
`3`		`-.TH NODESET 1 "2016-06-16" "1.7.2" "ClusterShell User Manual"`
	`3`	`+.TH NODESET 1 "2016-06-18" "1.7.2" "ClusterShell User Manual"`
`4`	`4`	`.SH NAME`
`5`	`5`	`nodeset \- compute advanced nodeset operations`
`6`	`6`	`.`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`.\" Man page generated from reStructuredText.`
`2`	`2`	`.`
`3`		`-.TH CLUSH.CONF 5 "2016-02-28" "1.7.1" "ClusterShell User Manual"`
	`3`	`+.TH CLUSH.CONF 5 "2016-06-18" "1.7.2" "ClusterShell User Manual"`
`4`	`4`	`.SH NAME`
`5`	`5`	`clush.conf \- Configuration file for clush`
`6`	`6`	`.`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`.\" Man page generated from reStructuredText.`
`2`	`2`	`.`
`3`		`-.TH GROUPS.CONF 5 "2016-02-28" "1.7.1" "ClusterShell User Manual"`
	`3`	`+.TH GROUPS.CONF 5 "2016-06-18" "1.7.2" "ClusterShell User Manual"`
`4`	`4`	`.SH NAME`
`5`	`5`	`groups.conf \- Configuration file for ClusterShell node groups`
`6`	`6`	`.`