Changeset 060d066 for doc/user-guide

Timestamp:

2011-02-01T13:05:58Z (14 years ago)

Author:

Wilmer van der Gaast <wilmer@…>

Branches:

master

Children:

da60f28

Parents:

00fd005

Message:

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.

File:

• doc/user-guide/commands.xml (modified) (5 diffs)

doc/user-guide/commands.xml

@@ -25 +25 @@
 
                                 <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>
@@ -1604 +1604 @@
         <bitlbee-command name="register">
                 <short-description>Register yourself</short-description>
-                <syntax>register &lt;password&gt;</syntax>
+                <syntax>register [&lt;password&gt;]</syntax>
 
                 <description>
@@ -1618 +1618 @@
                                 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>
 
@@ -1623 +1627 @@
 
         <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>
 
@@ -1641 +1645 @@
                         <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>