Added hints on --list advanced usage

README.rst

@@ -333,6 +333,27 @@ Additionally, the following options are available:
 ``-h, --help``
   Print help and exit
 
+Using bumpversion in a script
+=============================
+
+If you need to use the version generated by bumpversion in a script you can make use of
+the `--list` option, combined with `grep` and `sed`.
+
+Say for example that you are using git-flow to manage your project and want to automatically
+create a release. When you issue `git flow release start` you already need to know the
+new version, before applying the change.
+
+The standard way to get it in a bash script is
+
+    bumpversion --dry-run --list <part> | grep <field name> | sed -r s,"^.*=",,
+
+where <part> is as usual the part of the version number you are updating. You need to specify
+`--dry-run` to avoid bumpversion actually bumping the version number.
+
+For example, if you are updating the minor number and looking for the new version number this becomes
+
+    bumpversion --dry-run --list minor | grep new_version | sed -r s,"^.*=",,
+
 Development
 ===========