From bf46264b744dfc66d216a149903c4597b96dd8d1 Mon Sep 17 00:00:00 2001
From: Amin Bandali <amin.bandali@savoirfairelinux.com>
Date: Thu, 29 Dec 2022 14:44:19 -0500
Subject: [PATCH] doc: Add and install jami(1) man page.

* CMakeLists.txt: Install the man page.
* doc/jami.1: Rewrite to be a proper man page.

Change-Id: If0b566556d41c5adada87c93db7e6097dfdfa1e8
---
 CMakeLists.txt |  5 ++++
 doc/jami.1     | 75 +++++++++++++++++++++++++++++++++++++++++++-------
 2 files changed, 70 insertions(+), 10 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index b640c2c7..17af0ff4 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -656,6 +656,11 @@ elseif (NOT APPLE)
     FILES ${DATA_DIR}/jami.appdata.xml
     DESTINATION ${CMAKE_INSTALL_PREFIX}/share/metainfo)
 
+  # man page
+  install(
+    FILES ${DOC_DIR}/jami.1
+    DESTINATION ${CMAKE_INSTALL_PREFIX}/share/man/man1)
+
   # Add a target to generate API documentation using Doxygen and
   # graphviz-dot.
   find_package(Doxygen)
diff --git a/doc/jami.1 b/doc/jami.1
index 9abc3139..ea5a5c3f 100644
--- a/doc/jami.1
+++ b/doc/jami.1
@@ -1,21 +1,76 @@
 .\" Manpage for jami.
-.TH man 8 "08 April 2021" "1.0" "jami man page"
+.TH JAMI 1 "2022-12-29" "Jami" "GNU"
 .SH NAME
-jami \- Client for jami.net
+jami \- Qt-based user interface for Jami
 .SH SYNOPSIS
 jami [options]
 .SH DESCRIPTION
-jami is a qt client for jami.net
+jami is a Qt-based client application (user interface) for Jami, an
+official GNU package for universal communication that respects the
+freedom and privacy of its users.
 .SH OPTIONS
-.B \-v, \-\-version
-Display the version and exit.
-.TP
-.B \-d, \-\-debug
-Enable debug.
 .TP
 .B \-h, \-\-help
-Display help text and exit.
+Display help on command line options and exit.
+.TP
+.B \-\-help\-all
+Display help including Qt-specific command line options and exit.
+.TP
+.B \-v, \-\-version
+Display version information and exit.
+.TP
+.B \-\-disable\-web\-security
+Don't enforce the same-origin policy.  This is currently used by jami
+by default to allow loading local resources in the chatview (for media
+and link preview, and emoji picker).
+
+This is a Qt WebEngine Chromium flag and is only applicable if jami
+was built with Qt WebEngine.
+.TP
+.B \-\-no\-sandbox
+Disable the security sandbox for Qt WebEngine's renderer and plugin
+processes.
+
+This is a Qt WebEngine Chromium flag and is only applicable if jami
+was built with Qt WebEngine.
+.TP
+.B \-\-single\-process
+Run Qt WebEngine's renderer and plugins in the same process as its
+browser, useful for getting stack traces for renderer crashes.  This
+is currently used by jami by default.
+
+This is a Qt WebEngine Chromium flag and is only applicable if jami
+was built with Qt WebEngine.
+.TP
+.B \-\-remote\-debugging\-port=<port_number>
+Local port to run the Qt WebEngine developer tools interface on,
+useful for inspecting and debugging web views.
+
+To access the Qt WebEngine developer tools after launching jami with
+this flag, open the address http://localhost:<port_number> in your web
+browser.
+
+This is a Qt WebEngine flag and is only applicable if jami was built
+with Qt WebEngine.
+.TP
+.B \-m, \-\-minimized
+Start jami minimized.
+.TP
+.B \-d, \-\-debug
+Enable debug mode for more verbose console output.
+.TP
+.B \-f, \-\-file=<file>
+Write debug output to <file>.
+.TP
+.B \-t, \-\-term
+Terminate all other currently running instances of jami.
+.TP
+.B \-q, \-\-quiet
+Mute daemon logging, useful for debugging only the Qt-based client
+application (user interface).
+
+This is only applicable when debug mode is enabled.
 .SH SEE ALSO
 jamid(1)
 .SH AUTHOR
-Alexandre Viau (alexandre.viau@savoirfairelinux.net)
+Amin Bandali (bandali@gnu.org)