Received-SPF: pass (google.com: domain of linux-kernel+bounces-106404-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3;
Message-ID: <41f28393-0211-4448-8add-ad3c55d02210@oracle.com>
Date: Mon, 18 Mar 2024 17:54:36 +0100
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH v2] docs: drop the version constraints for sphinx and
 dependencies
Content-Language: en-US
To: Donald Hunter <donald.hunter@gmail.com>,
        Lukas Bulwahn <lukas.bulwahn@gmail.com>
Cc: Jonathan Corbet <corbet@lwn.net>,
        Mauro Carvalho Chehab <mchehab@kernel.org>,
        Akira Yokosawa
 <akiyks@gmail.com>,
        Jani Nikula <jani.nikula@linux.intel.com>,
        Randy Dunlap <rdunlap@infradead.org>, linux-doc@vger.kernel.org,
        linux-kernel@vger.kernel.org
References: <20240301141800.30218-1-lukas.bulwahn@gmail.com>
 <m21q8732wo.fsf@gmail.com>
From: Vegard Nossum <vegard.nossum@oracle.com>
Autocrypt: addr=vegard.nossum@oracle.com; keydata=
 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 8A==
In-Reply-To: <m21q8732wo.fsf@gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: 
	=?utf-8?B?R1orcnZOczN0UHFCNkdqMUV1NTFRY0lLc3puSlpnNXBkYzIrWkZaNEJBWmhk?=
 =?utf-8?B?d3FKME1HS3JjRW96TER6Y2RqU2R0TnRIS3FPVlhqTGNuNUtSYTU3L0RSRy9v?=
 =?utf-8?B?ZjlibTB5RlI1Mk5TTjVQbFc2dHArTlpyNmpjSFJqTHI0akxaTE5kbllDZkFU?=
 =?utf-8?B?NGkxeUUwcEY0WWZ0YW13czN5S2YvNU5PR1dkVzAvdHJLSGduTVQ3UFIrS24x?=
 =?utf-8?B?Nkd5a0dUR3dxTG0zeEFTTHhicGVoemlxSEVlZ1JhdHhONmVmZW1VZjN2Zk1F?=
 =?utf-8?B?ZjY5enFoZGQ0VE1leG5LYk5sQkQxbDlxeC9FR2h1RXFCMm9MZHVDYnRzY2VF?=
 =?utf-8?B?SXJwTFZtOGtKKysvMXhLUnlaZkVkck03em1lMUlUM1N6Nm93YkNCRXZlRk9V?=
 =?utf-8?B?MitvY0ZlaTBsS2Q0WFdsMFU4eW82dkIxeTg4VUlvRkd6TU1MR21zSjRTS0Ur?=
 =?utf-8?B?em5oa0NHQmxZNTFIdG15eERYdGNHdWlieG5ITW9jNFZxaGc3UTdxRkVTMXVU?=
 =?utf-8?B?N3JhaHo0eHpKTWlMUTBScHhwc3ZML1FDZzBtMC9UM1hlUmtyVHA1TVpoM3FR?=
 =?utf-8?B?Z1YzalZ5VzlQVDJqUTJmc2FBTGV1Zm05U1Y3c25TUkVYSHkzVzFuUmhlRTBW?=
 =?utf-8?B?U29kOVg1aGg3eG8zRVJrcmNYS2h6TVhoQ3d5cjU2MDY4alFlNTRSOVlNUk9l?=
 =?utf-8?B?ZERlUVgra0RTeHNFNHR3bDBScEx4UCtheEFjUjFkNWhCNnVaN3RXQ1FRM1pP?=
 =?utf-8?B?QWo5ckk0TWxHVzdSSzc2cnhGZk5PTm5oZFRHMmZ6TEZZcEpFeU53d2cwdkxa?=
 =?utf-8?B?eFpEb2NMR1liNXgzbzlBTEFKWHZadGR3M284UUU2YzhkaFFKVC94SGZRWkxs?=
 =?utf-8?B?MTFjYkxiUG42NVlJTysyejcvTE83THJ6c1VtanIrQTA0S2s3d3VtTS9pRzBk?=
 =?utf-8?B?VEdEcnc5MG40SjRjK1hBbTNURmRXTlQraFR3ZndDY1ljc3h3SVg2RUxsdkV6?=
 =?utf-8?B?eFZBN0tpNGhLci9rSk5heEROUVNwL0dKa2JodlMvekU3MFpjM21ISUhVZ0N6?=
 =?utf-8?B?aGpTemx5MFltVFk3aklLS1ZsaWt5RS83ZkJlWGQyc1BtVXgzS0RKV0ZQNlFG?=
 =?utf-8?B?dENqMnQ1Y1JoeFcvOFMvd3J1YnZJWWNEN3RVNkx1SkYxUHdzMXkxT25xeXEw?=
 =?utf-8?B?ajRvNVE5MHl2SzZKdmJPRU5vcDhxRENQK2UrOGVYaUlOb3hWVmNNaXVEWmhZ?=
 =?utf-8?B?VnhKQlpHZms1bG9oYkdhRzFPdDFTVmg3ekJleUU5N3ZoT09JOGpSSG0wMmNE?=
 =?utf-8?B?QjNoV0ZqN1pBOHNVcVRXQ056U2sybFJWQkgrdERBeU1hMUhxd2ZxRGJzOVZw?=
 =?utf-8?B?bHE4b3c1Nk1ReUZ0dnZrVjZFckJmbmtmWllzWkR6eUdjNkJLRlFPWFJndHpa?=
 =?utf-8?B?RmRRVkovRVBrRUc0S2ZYcW5XdGpEK0ZxN1ZDQ0hkMURSS3I4aFFnbW5tWmNF?=
 =?utf-8?B?TTRubEFFWHJSK2VEVkZwRmFzVGppTFRxVlowVFpTTFhwdTVXMkk0SmJMbm4z?=
 =?utf-8?B?eSsrYTlGNXd1TXpiUW5GN3B5dTRZNGMzcHVoa1VUVUNaWGRXSFNINmZ3OW14?=
 =?utf-8?B?K00vK3QvNHNUbDZuTGVjV2FRdmV5dkN4bUF3SHByb3I1L0laeVlFeDB3QUNn?=
 =?utf-8?B?OUZEWXhSVzhhWk9TS0RVMVVTaFd2aldpcUx5ZjNkNS9vRE9Pd0dZZjZTWXhn?=
 =?utf-8?B?cGVYMFFFV3h5Mlo3ekFrYlA0TG1MUmREUi9rdThFSnBJc1d0bkc5VDAwQmtE?=
 =?utf-8?B?R3NaWCtJVXFiSFBHTUJNZGdudmhsRGNSZk5xU3pMQkJmSVh0L0E5MERtMFhI?=
 =?utf-8?B?NDBta1hkKzlVY09EekxhdXRqK24raDExUUxjMHdIbUV2V1lKMGl4TDA0ODAv?=
 =?utf-8?B?R0VTQ2JOUTNKWGJoWUltTDBiN3ZYZjlrc01waG5mWFlubnZNZkRNZmhOWkJV?=
 =?utf-8?B?Yk9lSWUrOE13aWFlM1AwdzVPbXR0Nm92VDl3ckliT1hkSGhOT0NVZyt5V2xX?=
 =?utf-8?B?MVRRL0JjdWVwSW5ydEJjT2Q0MVRtZXFUTlFNMEN2cmlrejVUK0ZGajRLK29l?=
 =?utf-8?B?YVptTnpXaFJ5YWF2cXRSOWpNd2ZzbnhDN2xWY3U3L0diblQ0VDlPTGYzUVlj?=
 =?utf-8?B?ckE9PQ==?=
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: 
	m02Bddn1ydm87jSeBPVD35KzEmNwQHhwuABnSoK91RXtnGaEKTgav7ByjTn0+xcDJ9QHGsFvdWuzDSV+OItrXZDOCXYpxmz3EpawrxHbU+jnvZayiPwtUrGRP6MUSKI1fVoyLojuy5nVRgfcLwuUdM+jE/31Eo5DSNEVOLczkc5wP6I1cMVF9KEl8g7VTDDLfnA3JYlX+lYG2beAJRNq//d7zPrQpWxGfqfkwPGY+0edow+QdKG9PN7ktMjQduLnrkU2cTvrFiZzOp8dHYP/XHgw68D9toZtelPr7R1AYUH/XFkXY3RIZhd3o07crKCfU5ovhXpQ5QHzRL8QTzmYnhJiuozzQm0+7E63+F5KCsTUhU62S5kZx966tQw2fdMrolcgu06+o5C8HF+a3n9JMWMyNHeIq0YdcsViy1xJFPvzWGNFGYVUpewQL5EGHWYboq/H8EsQ3w+rnI9n4crtscBQVwJuwtgM0J06lghjwXmQHCrKzulG/c7DSJXMlnXDMpPt7wvbiUbDgg6v9LDWLAetJdUAuvkyMo9jkC+DGDHLRowQBG3llVs4ZfFn/gjxG7n9vTsG2xPXXpi4BqUbgShxkf7LVqc3TX7ysnoiKf4=
X-OriginatorOrg: oracle.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 4c9720e3-39d9-4496-37c3-08dc476c1b87
X-MS-Exchange-CrossTenant-AuthSource: PH0PR10MB5433.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 Mar 2024 16:54:42.4959
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: GdPWy1d+8ysj3WRey7TeoWasb+wq6D6zycy1Q170RGauiTHYq1fV1/p+HSHHp9w9UpiD2cURYK/dYnhy832ROptRxeFgijd/lyrsNa6FfHI=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO1PR10MB4466
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.272,Aquarius:18.0.1011,Hydra:6.0.619,FMLib:17.11.176.26
 definitions=2024-03-18_12,2024-03-18_02,2023-05-22_02
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0
 phishscore=0 adultscore=0 bulkscore=0 mlxscore=0 spamscore=0
 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1
 engine=8.12.0-2403140000 definitions=main-2403180127
X-Proofpoint-ORIG-GUID: YaZHTFALFbRF-GKK4ujtiGkHez3OWpPi
X-Proofpoint-GUID: YaZHTFALFbRF-GKK4ujtiGkHez3OWpPi


On 18/03/2024 17:44, Donald Hunter wrote:
> With Sphinx 2.4.4 I always get timings in this ballpark:
> 
> % time make htmldocs
> ...
> real	4m5.417s
> user	17m0.379s
> sys	1m11.889s
> 
> With Sphinx 7.2.6 it's typically over 9 minutes:
> 
> % time make htmldocs
> ...
> real	9m0.533s
> user	15m38.397s
> sys	1m0.907s

Was this running 'make cleandocs' (or otherwise removing the output
directory) in between? Sphinx is known to be slower if you already have
an output directory with existing-but-obsolete data, I believe this is
the case even when switching from one Sphinx version to another. Akira
also wrote about the 7.x performance:

https://lore.kernel.org/linux-doc/6e4b66fe-dbb3-4149-ac7e-8ae333d6fc9d@gmail.com/

> I have an experimental fix that uses a dict for lookups. With the fix, I
> consistently get times in the sub 5 minute range:

Fantastic!

There is a github issue for the C++ domain but I believe it's the same
issue for both C and C++ domains:

https://github.com/sphinx-doc/sphinx/issues/10966


Vegard