RE: index items for pg_stat_progress_xxx views

Поиск
Список
Период
Сортировка
От
Тема RE: index items for pg_stat_progress_xxx views
Дата
Msg-id 6168075bd02a4ef18ed75153ad2a85f0@MP-MSGSS-MBX001.msg.nttdata.co.jp
обсуждение исходный текст
Ответ на Re: index items for pg_stat_progress_xxx views  (Fujii Masao <masao.fujii@oss.nttdata.com>)
Ответы Re: index items for pg_stat_progress_xxx views  (Fujii Masao <masao.fujii@oss.nttdata.com>)
Список pgsql-docs
>>> Hi,
>>>
>>> The index items for pg_stat_progress_xxx views point to the "Viewing
>>> Statistics" section, but not to the dedicated section (e.g., "ANALYZE
>>> Progress
>>> Reporting") for each view. IMO this is very inconvenient when finding
>>> the section describing each pg_stat_progress_xxx view, from the index.
>>> So what about adding new pointer to the section for each view in the index?
>>> Patch attached.
>>>
>>> BTW, other stats views have both pointers in the index.
>>
>> When setting an <indexterm>, it's better to set the zone attribute to indicate
>which section it's associated with.
>>
>> For example,
>>   <indexterm zone="analyze-progress-reporting">
>>     <primary>pg_stat_progress_analyze</primary>
>>   </indexterm>
>
>Thanks for the review!
>
>I was thinking that the zone attribute doesn't need to be specified because the
>indexterm is defined under the section that the indexterm tries to point to. You
>can see the same situation at, for example, the section and indexterm of
>pg_stat_database. If I'm missing something, could you tell me why the zone
>attribute is necessary in this case?

I looked at lines 132-137 of monitoring.sgml, and I saw that zone is set for indexterm after <sect1>.
However, I haven't found the zone set for indexterm after <sect2>, so you may be right.

Regards,
Shinya Kato



В списке pgsql-docs по дате отправления:

Предыдущее
От: Michael Paquier
Дата:
Сообщение: Re: doc: index items for pg_stat_progress_xxx views
Следующее
От: Fujii Masao
Дата:
Сообщение: Re: index items for pg_stat_progress_xxx views