cmds: improve help/errors for allow-offline

Better explain what's happening and why.

License: MIT
Signed-off-by: Steven Allen <[email protected]>

Author: Stebalien

core/commands/name/publish.go

@@ -20,7 +20,7 @@ import (
 )
 
 var (
-	errAllowOffline = errors.New("cannot publish in offline mode by default,using `--allow-offline` to publish again")
+	errAllowOffline = errors.New("can't publish while offline: pass `--allow-offline` to override")
 	errIpnsMount    = errors.New("cannot manually publish while IPNS is mounted")
 	errIdentityLoad = errors.New("identity not loaded")
 )
@@ -83,7 +83,7 @@ Alternatively, publish an <ipfs-path> using a valid PeerID (as listed by
 			`Time duration that the record will be valid for. <<default>>
     This accepts durations such as "300s", "1.5h" or "2h45m". Valid time units are
     "ns", "us" (or "µs"), "ms", "s", "m", "h".`).WithDefault("24h"),
-		cmdkit.BoolOption(allowOfflineOptionName, "Allow publish in offline mode"),
+		cmdkit.BoolOption(allowOfflineOptionName, "When offline, save the IPNS record to the the local datastore without broadcasting to the network instead of simply failing."),
 		cmdkit.StringOption(ttlOptionName, "Time duration this record should be cached for (caution: experimental)."),
 		cmdkit.StringOption(keyOptionName, "k", "Name of the key to be used or a valid PeerID, as listed by 'ipfs key list -l'. Default: <<default>>.").WithDefault("self"),
 	},