From mboxrd@z Thu Jan 1 00:00:00 1970 From: Christian Couder Subject: [PATCH] documentation: help: add info about "man..cmd" config var Date: Tue, 25 Mar 2008 07:21:10 +0100 Message-ID: <20080325072111.7a8774bd.chriscool@tuxfamily.org> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: git@vger.kernel.org To: Junio Hamano , Pascal Obry , Xavier Maillard , =?UTF-8?Q?=E3=81=97=E3=82=89=E3=81=84=E3=81=97?= =?UTF-8?Q?=E3=81=AA=E3=81=AA=E3=81=93?= X-From: git-owner@vger.kernel.org Tue Mar 25 07:16:25 2008 Return-path: Envelope-to: gcvg-git-2@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1Je2SH-0001BS-4d for gcvg-git-2@gmane.org; Tue, 25 Mar 2008 07:16:17 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754590AbYCYGPg (ORCPT ); Tue, 25 Mar 2008 02:15:36 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1753631AbYCYGPf (ORCPT ); Tue, 25 Mar 2008 02:15:35 -0400 Received: from smtp1-g19.free.fr ([212.27.42.27]:42949 "EHLO smtp1-g19.free.fr" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751332AbYCYGPf (ORCPT ); Tue, 25 Mar 2008 02:15:35 -0400 Received: from smtp1-g19.free.fr (localhost.localdomain [127.0.0.1]) by smtp1-g19.free.fr (Postfix) with ESMTP id AB9141AB2D7; Tue, 25 Mar 2008 07:15:33 +0100 (CET) Received: from localhost.boubyland (gre92-7-82-243-130-161.fbx.proxad.net [82.243.130.161]) by smtp1-g19.free.fr (Postfix) with SMTP id 542F51AB2BA; Tue, 25 Mar 2008 07:15:33 +0100 (CET) X-Mailer: Sylpheed 2.5.0beta1 (GTK+ 2.12.9; i486-pc-linux-gnu) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: This patch also describes the current behavior for "konqueror" and how to modify it using "man..cmd" if needed. Signed-off-by: Christian Couder --- Documentation/config.txt | 5 ++++ Documentation/git-help.txt | 48 +++++++++++++++++++++++++++++++++++++++---- 2 files changed, 48 insertions(+), 5 deletions(-) This should be applied on top of my previous patches: [PATCH 1/2] help: use man viewer path from "man..path" config var [PATCH 2/2] documentation: help: add "man..path" config variable [PATCH] help: use "man..cmd" as custom man viewer command I can resend a 4 patches series if needed. diff --git a/Documentation/config.txt b/Documentation/config.txt index 81a6b2c..6d9a3e2 100644 --- a/Documentation/config.txt +++ b/Documentation/config.txt @@ -761,6 +761,11 @@ man.viewer:: Specify the programs that may be used to display help in the 'man' format. See linkgit:git-help[1]. +man..cmd:: + Specify the command to invoke the specified man viewer. The + specified command is evaluated in shell with the man page + passed as argument. (See linkgit:git-help[1].) + man..path:: Override the path for the given tool that may be used to display help in the 'man' format. See linkgit:git-help[1]. diff --git a/Documentation/git-help.txt b/Documentation/git-help.txt index 4c6cb21..bfbba9e 100644 --- a/Documentation/git-help.txt +++ b/Documentation/git-help.txt @@ -82,22 +82,28 @@ man.viewer ~~~~~~~~~~ The 'man.viewer' config variable will be checked if the 'man' format -is chosen. Only the following values are currently supported: +is chosen. The following values are currently supported: * "man": use the 'man' program as usual, * "woman": use 'emacsclient' to launch the "woman" mode in emacs (this only works starting with emacsclient versions 22), -* "konqueror": use a man KIO slave in konqueror. +* "konqueror": use 'kfmclient' to open the man page in a new konqueror +tab (see 'Note about konqueror' below). -Multiple values may be given to this configuration variable. Their -corresponding programs will be tried in the order listed in the -configuration file. +Values for other tools can be used if there is a corresponding +'man..cmd' configuration entry (see below). + +Multiple values may be given to the 'man.viewer' configuration +variable. Their corresponding programs will be tried in the order +listed in the configuration file. For example, this configuration: +------------------------------------------------ [man] viewer = konqueror viewer = woman +------------------------------------------------ will try to use konqueror first. But this may fail (for example if DISPLAY is not set) and in that case emacs' woman mode will be tried. @@ -113,6 +119,38 @@ can configure the absolute path to konqueror by setting 'man.konqueror.path'. Otherwise, 'git help' assumes the tool is available in PATH. +man..cmd +~~~~~~~~~~~~~~ + +When the man viewer, specified by the 'man.viewer' configuration +variables, is not among the supported ones, then the corresponding +'man..cmd' configuration variable will be looked up. If this +variable exists then the specified tool will be treated as a custom +command and a shell eval will be used to run the command with the man +page passed as arguments. + +Note about konqueror +~~~~~~~~~~~~~~~~~~~~ + +When 'konqueror' is specified in the 'man.viewer' configuration +variable, we launch 'kfmclient' to try to open the man page on an +already opened konqueror in a new tab if possible. + +For consistency, we also try such a trick if 'man.konqueror.path' is +set to something like 'A_PATH_TO/konqueror'. That means we will try to +launch 'A_PATH_TO/kfmclient' instead. + +If you really want to use 'konqueror', then you can use something like +the following: + +------------------------------------------------ + [man] + viewer = konq + + [man "konq"] + cmd = A_PATH_TO/konqueror +------------------------------------------------ + Note about git config --global ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 1.5.5.rc0.124.g91c15.dirty