diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/help/in/otr.in | 111 | ||||
| -rw-r--r-- | docs/help/in/statusbar.in | 51 | ||||
| -rw-r--r-- | docs/signals.txt | 6 |
3 files changed, 149 insertions, 19 deletions
diff --git a/docs/help/in/otr.in b/docs/help/in/otr.in new file mode 100644 index 00000000..f76a2d53 --- /dev/null +++ b/docs/help/in/otr.in @@ -0,0 +1,111 @@ + +OTR %|[OPTION] + +Command to control the OTR module. Without an option, /OTR INFO is printed. + +This help contains three sections which are %9options, quickstart and files.%n + +To add the OTR status bar (highly recommended): + +%9/statusbar window add otr%n + +%9Options:%n + +AUTH <secret> + Start or respond to an authentication process. + +AUTHQ <question> <secret> + Start a SMP authentication process. + + Example: %9/otr authq "My question is" "this is the secret"%n + +AUTHABORT + Abort an ongoing authentication process. + +CONTEXTS + List known contexts which basically list the known fingerprints and their + state. + +DEBUG + Turn on debugging. + +DISTRUST <fingerprint> + Distrust a specific fingerprint. This command can be done inside a private + window for which the current fingerprint of the other person will be used + or else set fp to a human readable OTR fingerprint available with the above + contexts command. + + Examples: %9/otr distrust 487FFADA 5073FEDD C5AB5C14 5BB6C1FF 6D40D48A%n + +FINISH + End the OTR session. This MUST be done inside a private conversation + window. + +FORGET <fingerprint> + Forget a specific fingerprint (deleted from the known fingerprints). The + behavior is the same as the distrust command explained above. + +GENKEY <name> + Generate OTR keys for a given account name. This is done automatically + if someone tries to establish a secure session. + + This process is done in a background worker and can take an arbitrary + amount of time. The completion is checked when another irssi event is + catched. + +HELP + Print this help. + +INFO + Display the OTR fingerprint(s) of all your account(s). + +INIT + Initialize an OTR conversation within a private conversation window. + +TRUST <fingerprint> + Trust a specific fingerprint. The behavior is the same as the forget and + distrust commands explained above. + +VERSION + Print the version of the OTR module. + +%9Quickstart:%n + +Start a private conversation with the person you want to initiate a secure +session. Once in the private message window: + +%9/otr init%n + +Key generation should start if no key is found for your account name. Once the +process is done, either type a message which should automatically start the +session or redo the init command. + +Time to authenticate the person. Either use a shared secret exchange through +phone or GPG-signed email or use the socialist millionaire problem mechanism +(SMP) which is basically to ask a question for which the answer can only be +known by the other person. + +%9/otr auth <shared-secret>%n OR %9/otr authq "A question" <shared-secret>%n + +Or to respond to an authentication: + +%9/otr auth <secret>%n + +%9Files:%n + +This otr modules creates a directory in %9$HOME/.irssi/otr%n and creates three +files: + +* %9otr.key%n + Contains your OTR private key(s). NEVER shared this directory with someone + else unless you know what you are doing. + +* %9otr.fp%n + The known fingerprints with their _trust_ status. + +* %9otr.instag + Instance tag of the libotr. This should NEVER be copied to an other + computer. If unsure, just ignore this file. + +For more information on OTR, see https://otr.cypherpunks.ca/ + diff --git a/docs/help/in/statusbar.in b/docs/help/in/statusbar.in index 7d64b816..9d68d1c9 100644 --- a/docs/help/in/statusbar.in +++ b/docs/help/in/statusbar.in @@ -5,27 +5,35 @@ %9Parameters:%9 - ENABLE: Adds a statusbar to the list of statusbars. - DISABLE: Removes a statusbar from the list. Note that for - built-in statusbars they can be enabled again should the - user wish to add back the default statusbars. + ADD: Adds a statusbar to the list of statusbars. + MODIFY: Modifies the configuration of a statusbar. RESET: Restores the default statusbar configuration. - TYPE: Sets the type of statusbar, for each split window or only + ADDITEM: Adds an item to the specified statusbar. It can be set to + appear before/after another item and left/right aligned + to a specified position on the screen. + MODIFYITEM: Changes an item position inside a bar. + REMOVEITEM: Removes an item from the specified statusbar. + INFO: List the current details and items of the specified + statusbar. + + -disable: Removes a statusbar from the list. + -type: Sets the type of statusbar, for each split window or only for the current root screen. - PLACEMENT: Sets the placement of the statusbar, either at the top or + -placement: Sets the placement of the statusbar, either at the top or the bottom of the screen. - POSITION: Sets the position of the statusbar. Represented as a + -position: Sets the position of the statusbar. Represented as a number, with 0 implying the first position. - VISIBLE: Sets the visibility of the statusbar or item. If set to + -visible: Sets the visibility of the statusbar or item. If set to always it is visible on all screens, otherwise if set to inactive or active then it is only visible on inactive or active screens, respectively. - ADD: Adds an item to the specified statusbar. It can be set to - appear before/after another item and left/right aligned - to a specified position on the screen. - REMOVE: Removes an item from the specified statusbar. + -before: This item is added before the other item. + -after: This item is added after the other item. + -priority: When the statusbar items overflow, the item with the + lowest priority is removed first + -alignment: Display the item on the right side. - Where name refers to the name of the statusbar; if no argument is + Where statusbar refers to the name of the statusbar; if no argument is given, the entire list of statusbars will be displayed. %9Description:%9 @@ -36,12 +44,17 @@ %9Examples:%9 /STATUSBAR - /STATUSBAR window - /STATUSBAR window REMOVE time - /STATUSBAR window ADD time - /STATUSBAR window RESET - /STATUSBAR topic DISABLE - /STATUSBAR topic ENABLE + /STATUSBAR INFO window + /STATUSBAR REMOVEITEM time window + /STATUSBAR ADDITEM time window + /STATUSBAR RESET window + /STATUSBAR MODIFY -disable topic + /STATUSBAR MODIFY -nodisable topic + +%9Remarks:%9 + + Statusbar syntax was changed in Irssi 1.2. The old syntax is still + accepted for backward compatibility, but no longer documented. %9See also:%9 WINDOW diff --git a/docs/signals.txt b/docs/signals.txt index 7776dad7..84d4518f 100644 --- a/docs/signals.txt +++ b/docs/signals.txt @@ -350,3 +350,9 @@ Perl ---- "script error", PERL_SCRIPT_REC, char *errormsg + +OTR Core +-------- + +otr.c: + "otr event", SERVER_REC, char *nick, char *status |