Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.kernel > #1314817

Re: [PATCH v13 05/23] perf config: Document variables for 'help' section in man page

Path csiph.com!news.freedyn.net!aioe.org!bofh.it!news.nic.it!robomod
From Taeung Song <treeze.taeung@gmail.com>
Newsgroups linux.kernel
Subject Re: [PATCH v13 05/23] perf config: Document variables for 'help' section in man page
Date Fri, 22 Jan 2016 09:10:02 +0100
Message-ID <qTEX8-1ic-11@gated-at.bofh.it> (permalink)
References <qODIl-67Q-3@gated-at.bofh.it> <qODIo-67Q-71@gated-at.bofh.it> <qToIG-6z7-27@gated-at.bofh.it>
X-Original-To Arnaldo Carvalho de Melo <arnaldo.melo@gmail.com>
Dkim-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=subject:to:references:cc:from:message-id:date:user-agent :mime-version:in-reply-to:content-type:content-transfer-encoding; bh=G4WaJy3L+HeeDrnnaMbm17368Czm6UwaI4/cwtn1V+4=; b=oOvgu0vysYRVqhpjre6jUTAID3YG/yXV6K8h89E6w/OTK7A2f7+TcvP/Y7r1Ix1B5W LvaqL0riN6ahawgh0s6VlKOrH9YnkwajARMttVODAHTq51om5uCRxEgVod36fwLSEQ3L 9WMrsrB7TfVezQ6AcVarFZYQcRydGcoIEdPhmgjpr9VrsS4VFq1NXcX4K3o6ujN6v4YM m8m2m9LIvE/BaPABO9VP3KRvfld+0I0jynCZk90CgMRkzLDIHh6vX0m1rhi8fbNeHckJ J5/s8RtZHK2CfOBIkTrD8kizW8MV6Ty01P1H6HOu1KX2vUYuDAsr+12YYbm2pt2tIgjE Ckaw==
X-Google-Dkim-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:subject:to:references:cc:from:message-id:date :user-agent:mime-version:in-reply-to:content-type :content-transfer-encoding; bh=G4WaJy3L+HeeDrnnaMbm17368Czm6UwaI4/cwtn1V+4=; b=eDxXedaUHkUAmMz9GaY/zKUb62/LDILXwgN4lf/lmAOFQyi+5ceUkDmQiKtQDM46Uv ZjRuVwKOLYME97hEAQcnsGm1+sOINnbq0FIah/x4FRBZjDmEhfsgxDUHaD/eDyjrFQg6 VUEj/RUB79vN3LtO7AWCFULRV2NWrV1iWVJk/Abw7zP0nCJvtFKf0xZG5GHWBBjmTveK 5w7K9R3SPBBvElEg6uwwhtVmWTtvGZm9qtVPOGpM2/05kCJED6OlZtRSnqcwBiBw1ecQ oF0Vbk176L3pgY6NOY50NLEj3xdOXmHvL32Eul/ltHlIeJiT11+Z5P2rZ51PiiJ9XPXo 0xCw==
X-Gm-Message-State AG10YORJxTW/aCmw/hzsJyxf5dhm6xr8PbXJga2md4GFvIPzvGEjmS5ywU+kkhlQjsV1qA==
X-Received by 10.98.71.157 with SMTP id p29mr2422316pfi.45.1453449640486; Fri, 22 Jan 2016 00:00:40 -0800 (PST)
User-Agent Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.5.1
MIME-Version 1.0
Content-Type text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding 8bit
Sender robomod@news.nic.it
List-ID <linux-kernel.vger.kernel.org>
X-Mailing-List linux-kernel@vger.kernel.org
Approved robomod@news.nic.it
Lines 46
Organization linux.* mail to news gateway
X-Original-Cc linux-kernel@vger.kernel.org, Jiri Olsa <jolsa@kernel.org>, Namhyung Kim <namhyung@kernel.org>, Ingo Molnar <mingo@kernel.org>
X-Original-Date Fri, 22 Jan 2016 17:00:37 +0900
X-Original-Message-ID <56A1E1A5.8090109@gmail.com>
X-Original-References <1452253193-30502-1-git-send-email-treeze.taeung@gmail.com> <1452253193-30502-6-git-send-email-treeze.taeung@gmail.com> <20160121144641.GB4034@kernel.org>
X-Original-Sender linux-kernel-owner@vger.kernel.org
Xref csiph.com linux.kernel:1314817

Show key headers only | View raw


On 01/21/2016 11:46 PM, Arnaldo Carvalho de Melo wrote:
> Em Fri, Jan 08, 2016 at 08:39:35PM +0900, Taeung Song escreveu:
>> Explain 'help.format' variables.
>>
>> Cc: Namhyung Kim <namhyung@kernel.org>
>> Cc: Jiri Olsa <jolsa@kernel.org>
>> Signed-off-by: Taeung Song <treeze.taeung@gmail.com>
>> ---
>>   tools/perf/Documentation/perf-config.txt | 4 ++++
>>   1 file changed, 4 insertions(+)
>>
>> diff --git a/tools/perf/Documentation/perf-config.txt b/tools/perf/Documentation/perf-config.txt
>> index 85b811f..aaf1791 100644
>> --- a/tools/perf/Documentation/perf-config.txt
>> +++ b/tools/perf/Documentation/perf-config.txt
>> @@ -278,6 +278,10 @@ annotate.*::
>>
>>   		99.93 │      mov    %eax,%eax
>>
>> +help.*::
>> +	help.format::
>> +		A format of manual page can be 'man' that is default.
>> +
>
> Huh? If this is the case, i.e. we have something that is configurable
> but admits only one option, maybe we should trow this alltogether and
> remove the need to document it? :-)
>

Hum.. I think so.

I tested config variables 'help.format' and 'man.viewer', again.
Selecting which manual page viewer can be done by both
this config variables.

So IMHO I think even if 'help.format' is removed,
it hasn't problem because this functionality is duplicated.
And I think it seems to be tidy that the whole 'help' section
is removed or just don't document it on perf-config doc.

Would I keep working on perf-config patchkit excluding 'help' section ?


Thanks,
Taeung

Back to linux.kernel | Previous | NextPrevious in thread | Find similar | Unroll thread


Thread

Re: [PATCH v13 05/23] perf config: Document variables for 'help'  section in man page Arnaldo Carvalho de Melo <acme@kernel.org> - 2016-01-21 15:50 +0100
  Re: [PATCH v13 05/23] perf config: Document variables for 'help'  section in man page Taeung Song <treeze.taeung@gmail.com> - 2016-01-22 09:10 +0100

csiph-web