Merge pull request #174 from xsuchy/pr141

clarify --offline option #141

tito.8.asciidoc

@@ -116,8 +116,8 @@ show this help message and exit
 print debug messages (can be also set using DEBUG environment variable)
 
 --offline::
-do not attempt any remote communication (avoid using
-this please)
+do not attempt any remote communication. Avoid using
+this please. See OFFLINE section below.
 
 -o 'OUTPUTDIR', --output='OUTPUTDIR'::
 Write temp files, tarballs and RPMs to 'OUTPUTDIR'.
@@ -183,8 +183,8 @@ show this help message and exit
 print debug messages (can be also set using DEBUG environment variable)
 
 --offline::
-do not attempt any remote communication (avoid using
-this please)
+do not attempt any remote communication. Avoid using
+this please. See OFFLINE section below.
 
 -o 'OUTPUTDIR', --output='OUTPUTDIR'::
 Write temp files, tarballs and RPMs to 'OUTPUTDIR'.
@@ -234,8 +234,8 @@ show this help message and exit
 print debug messages (can be also set using DEBUG environment variable)
 
 --offline::
-do not attempt any remote communication (avoid using
-this please)
+do not attempt any remote communication. Avoid using
+this please. See OFFLINE section below.
 
 -o 'OUTPUTDIR', --output='OUTPUTDIR'::
 Write temp files, tarballs and RPMs to 'OUTPUTDIR'.
@@ -251,6 +251,14 @@ Print out the list for all packages with changes
 between their most recent tag and HEAD. Useful for
 determining which packages are in need of a re-tag.
 
+OFFLINE
+-------
+
+Offline lets you potentially do builds you can't reproduce, normally we check
+that the tag you're building exists in the remote repo. If it hasn't been
+pushed, it's quite easy to do a build that will result in a checksum that is no
+longer the same. This is something you should try to avoid.
+
 EXAMPLES
 --------