diff --git a/README.asciidoc b/README.asciidoc
index b071fbd8a..4e26f6d12 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -5,6 +5,7 @@
 :travis-url: https://travis-ci.org/mawww/kakoune
 :icons: font
 :toc: right
+:pp: ++
 
 TL;DR
 -----
@@ -99,8 +100,8 @@ Building
 
 Kakoune dependencies are:
 
- * A C\+\+11 compliant compiler (GCC >= 5 or clang >= 3.4) along with its
-   associated C\+\+ standard library (libstdc\+\+ or libc\+\+)
+ * A {cpp}11 compliant compiler (GCC >= 5 or clang >= 3.4) along with its
+   associated {cpp} standard library (libstdc{pp} or libc{pp})
  * boost (>= 1.50)
  * ncurses with wide-characters support (>= 5.3, generally referred to as libncursesw)
  * asciidoc (for the `a2k` tool), to generate man pages
@@ -243,6 +244,7 @@ Just running *kak* launch a new kak session with a client on local terminal.
  * `-l`: list existing sessions, and check the dead ones
  * `-clear`: clear dead sessions socket files
  * `-ro`: prevent modifications to all buffers from being saved to disk
+ * `+line[:column]`: specify a target line and column for the first file
 
 Configuration
 ^^^^^^^^^^^^^
diff --git a/doc/kak.1.txt b/doc/kak.1.txt
index cacd6c5b6..4c7710c9e 100644
--- a/doc/kak.1.txt
+++ b/doc/kak.1.txt
@@ -7,7 +7,7 @@ kak - a vim inspired, selection oriented code editor
 
 SYNOPSIS
 --------
-*kak* [-q] [-n] [-l] [-ro] [-clear] [-ui ui_type] [-e command] [-f keys] [-p session_id] [-c session_id|[[-d] -s session_id] file ...
+*kak* [-q] [-n] [-l] [-ro] [-clear] [-ui ui_type] [-e command] [-f keys] [-p session_id] [-c session_id|[[-d] -s session_id] [+line[:column]] file ...
 
 DESCRIPTION
 -----------
@@ -51,7 +51,7 @@ OPTIONS
 	connect to the given session
 
 -s <session_id>::
-	rename the current session name to *session_id*
+	set the current session name to *session_id*
 
 -ui <type>::
 	select the user interface, can be one of 'ncurses', 'dummy' or 'json'
@@ -62,6 +62,9 @@ OPTIONS
 -ro::
 	enter in 'readonly mode', all the buffers opened will not be written to disk
 
++line[:column]::
+	specify a target line and column for the first file
+
 file::
 	one or more files to edit