[epiphany/mcatanzaro/cli: 9/10] Update the manpage

[Michael Catanzaro <mcatanzaro src gnome org>]

commit e1633450b04cc2332caf637f3189c6187008fd2d
Author: Michael Catanzaro <mcatanzaro igalia com>
Date:   Thu Jan 3 16:31:54 2019 -0600

    Update the manpage
    
    All flags previously missing from the manpage have now been removed,
    except for --application-mode, so add documentation for that.

 data/epiphany.1 | 40 ++++++++++++++++++++++++----------------
 1 file changed, 24 insertions(+), 16 deletions(-)
---
diff --git a/data/epiphany.1 b/data/epiphany.1
index 78c40e354..fb6ae9a2b 100644
--- a/data/epiphany.1
+++ b/data/epiphany.1
@@ -1,37 +1,43 @@
 .\" Epiphany manpage.
-.\" Copyright © 2006 GNOME Foundation, Inc.
+.\" Copyright © 2006-2019 GNOME Foundation, Inc.
 .\"
-.TH EPIPHANY "1" "2018-01-23" "GNOME" ""
+.TH EPIPHANY "1" "January 2019"
 .SH NAME
-epiphany \- simple to use web browser for GNOME
+epiphany \- a simple, clean, beautiful view of the web
 .SH SYNOPSIS
 .B epiphany
 [\fIOPTION\fR...] [url]
 .SH DESCRIPTION
-Help options
-.TP
--?, \fB\-\-help\fR
-Show help options
-.PP
-Application options
+\fBepiphany\fR is the codename of GNOME Web, the web browser designed for the
+GNOME desktop and elementary OS.  It offers a simple, clean, beautiful view of
+the web featuring first-class GNOME and Pantheon desktop integration, using
+WebKitGTK+ for web rendering.
+.SH OPTIONS
 .TP
 \fB\-\-new\-window\fR
-Open a new browser window
+Open a new browser window instead of a new tab
 .TP
 \fB\-l\fR, \fB\-\-load\-session\fR=\fIFILE\fR
-Load the given session file
+Load the given session state file
 .TP
 \fB\-p\fR, \fB\-\-private\-instance\fR
-Start a private instance (temporary profile directory, not private browsing mode)
+Start a private instance with separate user data
 .TP
 \fB\-\-incognito\-mode\fR
-Start a private instance in incognito mode
+Start an incognito instance with a read-only view of user data
+.TP
+\fB\-a\fR, \fB\-\-application\-mode\fR[=\fIBASENAME\fR]
+Start a private instance in web application mode (requires passing either desktop file basename or
+.B \-\-profile)
 .TP
 \fB\-\-automation\-mode\fR
-Start the browser in automation mode, for WebDriver control
+Start a private instance for WebDriver control
 .TP
 \fB\-\-profile\fR=\fIFILE\fR
-Profile directory to use in the private instance
+Profile directory to use in the private instance (optional)
+.TP
+-?, \fB\-\-help\fR
+Show help options
 .TP
 \fB\-\-version\fR
 Show version
@@ -39,4 +45,6 @@ Show version
 Epiphany has a comprehensive help system.  Run the browser
 and select \fBHelp\fR from the menu.
 .SH AUTHOR
-Written by Marco Pesenti Gritti, Christian Persch and others.
+Written by Marco Pesenti Gritti (in memoriam), Christian Persch, Xan Lopez,
+Carlos Garcia Campos, Claudio Saavedra, Michael Catanzaro, Jan-Michael Brummer,
+and many others.