From 060d0661ff8c1465f394c307d0f4c2a22964c6b2 Mon Sep 17 00:00:00 2001
From: Wilmer van der Gaast <wilmer@google.com>
Date: Tue, 1 Feb 2011 13:05:58 +0000
Subject: More password paranoia: Allow omitting the identify/register password
 as well (and enter it using /OPER instead).

This is a gross hack and indeed still not solid: In irssi one can still
use /RAWLOG SAVE to find the OPER line sent to BitlBee (and of course not
everyone uses SSL to talk to remote BitlBee servers). This only works
within 10-30 minutes after entering the password though.
---
 doc/user-guide/commands.xml | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

(limited to 'doc/user-guide')

diff --git a/doc/user-guide/commands.xml b/doc/user-guide/commands.xml
index b86328b5..42a995c9 100644
--- a/doc/user-guide/commands.xml
+++ b/doc/user-guide/commands.xml
@@ -24,7 +24,7 @@
 				</para>
 
 				<para>
-					If you omit the password, you should use the IRC /OPER command to enter it separately. The advantage of this approach is that most IRC clients will not show OPER passwords on screen/save them in logs.
+					You can omit the password and enter it separately using the IRC /OPER command. This lets you enter your password without your IRC client echoing it on screen or recording it in logs.
 				</para>
 			</description>
 			
@@ -1603,7 +1603,7 @@
 
 	<bitlbee-command name="register">
 		<short-description>Register yourself</short-description>
-		<syntax>register &lt;password&gt;</syntax>
+		<syntax>register [&lt;password&gt;]</syntax>
 
 		<description>
 			<para>
@@ -1617,12 +1617,16 @@
 			<para>
 				To identify yourself in later sessions, you can use the <emphasis>identify</emphasis> command. To change your password later, you can use the <emphasis>set password</emphasis> command.
 			</para>
+
+			<para>
+				You can omit the password and enter it separately using the IRC /OPER command. This lets you enter your password without your IRC client echoing it on screen or recording it in logs.
+			</para>
 		</description>
 
 	</bitlbee-command>
 
 	<bitlbee-command name="identify">
-		<syntax>identify [-noload|-force] &lt;password&gt;</syntax>
+		<syntax>identify [-noload|-force] [&lt;password&gt;]</syntax>
 		<short-description>Identify yourself with your password</short-description>
 
 		<description>
@@ -1641,6 +1645,10 @@
 			<para>
 				<emphasis>-noload</emphasis> will log you in but not load any accounts and settings saved under your current nickname. These will be overwritten once you save your settings (i.e. when you disconnect).
 			</para>
+
+			<para>
+				You can omit the password and enter it separately using the IRC /OPER command. This lets you enter your password without your IRC client echoing it on screen or recording it in logs.
+			</para>
 		</description>
 	</bitlbee-command>
 
-- 
cgit v1.2.3