[PATCH] docs: powerpc: add htm.rst to toctree

Vishal Parmar posted 1 patch 2 months, 1 week ago
Documentation/arch/powerpc/index.rst | 1 +
1 file changed, 1 insertion(+)
[PATCH] docs: powerpc: add htm.rst to toctree
Posted by Vishal Parmar 2 months, 1 week ago
The file Documentation/arch/powerpc/htm.rst is not included in the
index.rst toctree. This results in a warning when building the docs:

  WARNING: document isn't included in any toctree: htm.rst

Add it to the index.rst file so that it is properly included in the
PowerPC documentation TOC.

Signed-off-by: Vishal Parmar <vishistriker@gmail.com>
---
 Documentation/arch/powerpc/index.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Documentation/arch/powerpc/index.rst b/Documentation/arch/powerpc/index.rst
index 0560cbae5fa1..173a787b6cc3 100644
--- a/Documentation/arch/powerpc/index.rst
+++ b/Documentation/arch/powerpc/index.rst
@@ -36,6 +36,7 @@ powerpc
     vas-api
     vcpudispatch_stats
     vmemmap_dedup
+    htm
 
     features
 
-- 
2.39.5
Re: [PATCH] docs: powerpc: add htm.rst to toctree
Posted by Randy Dunlap 2 months, 1 week ago
Hi,

On 7/27/25 4:01 AM, Vishal Parmar wrote:
> The file Documentation/arch/powerpc/htm.rst is not included in the
> index.rst toctree. This results in a warning when building the docs:
> 
>   WARNING: document isn't included in any toctree: htm.rst
> 
> Add it to the index.rst file so that it is properly included in the
> PowerPC documentation TOC.
> 
> Signed-off-by: Vishal Parmar <vishistriker@gmail.com>

There is a fix is available and scheduled to be merged (when?).

See
https://lore.kernel.org/all/98a8a5ef-45fd-4b1e-a775-d1e1306ad682@linux.ibm.com/


| Yes. I am planning to send it as a fix patch in earliest rc for 6.16.

@Maddy, does that mean during the merge window after 6.16 or as a
merge into 6.16-rcX (which is now)?

Thanks.

> ---
>  Documentation/arch/powerpc/index.rst | 1 +
>  1 file changed, 1 insertion(+)
> 
> diff --git a/Documentation/arch/powerpc/index.rst b/Documentation/arch/powerpc/index.rst
> index 0560cbae5fa1..173a787b6cc3 100644
> --- a/Documentation/arch/powerpc/index.rst
> +++ b/Documentation/arch/powerpc/index.rst
> @@ -36,6 +36,7 @@ powerpc
>      vas-api
>      vcpudispatch_stats
>      vmemmap_dedup
> +    htm
>  
>      features
>  

-- 
~Randy
Re: [PATCH] docs: powerpc: add htm.rst to toctree
Posted by Madhavan Srinivasan 2 months, 1 week ago

On 7/27/25 9:11 PM, Randy Dunlap wrote:
> Hi,
> 
> On 7/27/25 4:01 AM, Vishal Parmar wrote:
>> The file Documentation/arch/powerpc/htm.rst is not included in the
>> index.rst toctree. This results in a warning when building the docs:
>>
>>   WARNING: document isn't included in any toctree: htm.rst
>>
>> Add it to the index.rst file so that it is properly included in the
>> PowerPC documentation TOC.
>>
>> Signed-off-by: Vishal Parmar <vishistriker@gmail.com>
> 
> There is a fix is available and scheduled to be merged (when?).
> 
> See
> https://lore.kernel.org/all/98a8a5ef-45fd-4b1e-a775-d1e1306ad682@linux.ibm.com/
> 
> 
> | Yes. I am planning to send it as a fix patch in earliest rc for 6.16.
> 
> @Maddy, does that mean during the merge window after 6.16 or as a
> merge into 6.16-rcX (which is now)?
> 

My bad. I lost track of this. I thought I did push this,
but then looks like not. Apologizes.

Will handle this as part of this merge.

Thanks
Maddy


> Thanks.
> 
>> ---
>>  Documentation/arch/powerpc/index.rst | 1 +
>>  1 file changed, 1 insertion(+)
>>
>> diff --git a/Documentation/arch/powerpc/index.rst b/Documentation/arch/powerpc/index.rst
>> index 0560cbae5fa1..173a787b6cc3 100644
>> --- a/Documentation/arch/powerpc/index.rst
>> +++ b/Documentation/arch/powerpc/index.rst
>> @@ -36,6 +36,7 @@ powerpc
>>      vas-api
>>      vcpudispatch_stats
>>      vmemmap_dedup
>> +    htm
>>  
>>      features
>>  
>