From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pj2-f12.google.com (mail-pj2-f12.google.com [74.125.227.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7E8B638DC7F for ; Mon, 14 Sep 2026 09:52:12 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.227.140 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1789379534; cv=none; b=FZEThWN5dUJ/TGW5J3prHFa4TTvcEye2dZ91QielOSMNgL6msTQL1Q6Z0soOrCAA2Nqo6KOxMzZMS4eVQO9iCwCiypkORkj3iZG060UPVG/AQR12cWXt8tupnZsR0uRpCeiXC87xaYooW9WgKHbOGvsy/hs4GZb9u6MKBLc9p0U= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1789379534; c=relaxed/simple; bh=NwHFKXeGfWvXfFDB8Dx4MlVGi15SX/g36tkiFox1vmM=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=ENHxrKS5nE+RuvfpC/NRYmMuKf8QHWoZER/wy/J9+XRkswBPp6Z3jiW6szik8ELEcKdG/FcwO3z27qZVdXbwMbPQzejcICEbx4qPWrjQKAWlvqdE0WyJeRSPqPpIYjcT40ftrS4GRqdWdFVzI0C05TDuyuYHiwPi1IBWs0tVYgQ= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=R3MNSyKB; arc=none smtp.client-ip=74.125.227.140 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="R3MNSyKB" Received: by mail-pj2-f12.google.com with SMTP id d9443c01a7336-2d6ff2f2c50so2183055ad.2 for ; Mon, 14 Sep 2026 02:52:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1789379532; x=1789984332; darn=vger.kernel.org; h=in-reply-to:content-disposition:content-type:mime-version :references:message-id:subject:cc:to:from:date:from:to:cc:subject :date:message-id:reply-to:content-type; bh=CugJTnFpNDzD6RvkvwHqkwu4HooaScng7d0KUVoknX0=; b=R3MNSyKBLpH0R4jKdW57KBEweLMlACLe75vanhA0QnCXBaJJhRgieYJLBX3yi41elH W/Uq2IA2jl5YHFCTJBmW+No2f8nQ/yOw3svMQU4ljo6g444drtK4fG2mN+ZgK0Juhzmh eKZHwX3jTzN5N4V57K9CrYs9FnLtUo7W5wyjMXSIoaZmQHccWc5qmmo1q2SziEORRNxk SBA3IrjQyyl4P7tduirAWY+X63fE37wM6NW7qfBlYOyd/JWDjFyEc3dZ/O8l1un+K1TT qiVpVBa+QeTzXc9Av7z24OnwgrojZT+CjjrCwR7+KPEub60MElecKPabhuZGGVs5MEoS EZnw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1789379532; x=1789984332; h=in-reply-to:content-disposition:content-type:mime-version :references:message-id:subject:cc:to:from:date:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=CugJTnFpNDzD6RvkvwHqkwu4HooaScng7d0KUVoknX0=; b=D/qHCXUrRtITh3HX8dcIKxFsQX/rToLv3I6OuWnjrNdCb4zqvojak5Me2MW25zNK4+ kAVXmhtMogvPwKOWPOonldYjRKR6NI4dpsR7/aFJKXkZ4rp5a/nOeu8M8see0/e5ck8y ya9JraHaprKEb7wrWjO7kK8bv0LPz5o1fsLLI7KL/54jut2AC90E3DHv+NgdXWto+3QY MKSo2zxbedCKhgGjjHZ7pG7dDwcGZT+rKuYNhF7BC0b/U0gMg6vR32JJWkWWc0ytI3YN aDyJJ4vnrOmXnJCwpTl+QqqZFtOMpr0he/zYSo3UCyYPqD0FFfAHGfxTHzRuqUhKFK9w /XNw== X-Forwarded-Encrypted: i=1; AKwUvBxPp3Ghj54R3uQVFvlqDvFtrKWAuETb0oj+i/53E830zcsIFeHBCZCWnn4QVpV9wnu3fLVgi/tanJQ=@vger.kernel.org X-Gm-Message-State: AFuF++nzZz6C2HTyMbXmDQFOZzUprxG0w1T6GhDUJfn7sIgjoOwed7OQ x88hw5CAxBx05Ah4TUdaKrQQzxHSpfFV2VEv0PkQAxZ1oSea0IoT1/mZ X-Gm-Gg: AYBFou3xTJimJ5wsVsqI1XkCAhXcLog8csdTGTnklqJ67KgqqGiwAAuYumnuTLuIGYn ZPSEfn2k4+KburXV+jaF65ZMUxXb7Us6nOV+1ZG/r8XgoYXmeLMRpabxEuigFSXgNt3dr2BCPTq agQfZXFz02Z25u+nfXyzVTOt2ZbAtIcAGhX6sBME8z0Ky2erxqpIBU4E8Dqg/qbCnKbY9tMNcRV Ntlni+d/nijo6mp1yxlWinVzfhod5Jr0TeRbkITp0vAkrlUrhMJDZ1/prUf9L8JZe8IEk/t8PWf Vuu7P+SQDgpGRozIaLD8ykmNA2ne6bY6S9dB31Cx7t//AVyWHRi8XkDGohnhtLD5dKERG3ZIalw GpubiQ/fdmaA8QhJwd3htN9Ybire0pv7VVjqk2M/tyeJ0Ep8tZt5ZjL0FIml9zGwGkSl8JQKWSx DblwONo0miM3sdv7L01ZvyAL/XDu27J79UnGO4ETHsB37+dTZzJuQOxGSB5rk27/fsMhNlri5O5 C+IgyM4 X-Received: by 2002:a05:6a20:d80d:b0:3c3:94bb:ceb8 with SMTP id adf61e73a8af0-3db404fcb8bmr2241794637.1.1789379531607; Mon, 14 Sep 2026 02:52:11 -0700 (PDT) Received: from elitemini ([2400:4050:d860:9700:75bf:9e2e:8ac9:3001]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-86b287c2775sm4183562b3a.9.2026.09.14.02.52.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 14 Sep 2026 02:52:10 -0700 (PDT) Date: Mon, 14 Sep 2026 18:52:06 +0900 From: Masaharu Noguchi To: Mauro Carvalho Chehab Cc: Mauro Carvalho Chehab , Jonathan Corbet , Shuah Khan , Randy Dunlap , Akira Yokosawa , Chen Miao , Bagas Sanjaya , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] docs: sphinx-pre-install: warn about unsupported Docutils versions Message-ID: References: <20260913-docs-sphinx-pre-install-docutils-v1-1-d923c769af91@gmail.com> <20260914074206.05579309@foz.lan> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20260914074206.05579309@foz.lan> Hi Mauro, Thank you for looking at this. Both directions you suggest are ones I went down first; here is what I measured. On Mon, 14 Sep 2026 07:42:06 +0200, Mauro Carvalho Chehab wrote: > If so, maybe a more interesting patch would be to adjust pdf generaion > to use a more reasonable memory limit, as 6GB sounds too little. main_memory is counted in words rather than bytes, so that 6000000 is not 6 GB -- but raising it does not help either. Fedora 44, the broken pairing held fixed, varying only extra_mem_top/extra_mem_bot: core-api admin-guide ---------------------------------------------------------------- stock FAILS 26x Dim 1194p FAILS capacity 13p +60M words FAILS 26x Dim 1194p FAILS 40x Dim 2886p, no capacity core-api does not move at all, and admin-guide, once TeX has all the memory it asks for, fails on "Dimension too large" instead: the memory was masking those boxes, not causing them. Neither produces a PDF. > This is also another parameter that may require adjustments. > If I'm not mistaken, this is related to the maximum level depth > on titles. That one is maxlistdepth, which Documentation/conf.py already sets to 10. \fb@put@frame is framed.sty's frame placement macro, and what it reports is a box past TeX's maximum dimension, 16383.99998pt, which no setting raises. Bisecting a single block under the kernel's LaTeX settings, 1450 lines builds and 1500 does not, at stock memory and at ten times it; memory-barriers.txt is 3016 lines. I wrote an override for \fb@put@frame too, and dropped it: the same content passes unframed under an older Docutils. > On both cases, I don't think you can blame docutils or sphinx > version: those are distro-specific configuration parameters. This is what I should have shown in v1. Same container, same TeX Live, same unmodified texmf.cnf, same tree; only the two Python packages differ: sphinx docutils core-api admin-guide ------------------------------------------ 8.2.3 0.21.2 ok ok 8.2.3 0.22.4 FAILS FAILS 9.0.4 0.22.4 FAILS FAILS 9.1.0 0.22.4 ok ok The 9.0.4 row is a plain "pip install sphinx==9.0.4": 9.0.x declares "docutils>=0.20,<0.23" upstream, so pip resolves Docutils to 0.22.4 by itself, with no distribution involved. You are right that it takes a combination, and I will say that plainly rather than pointing at one package. > I don't mind having a warning One thing needs fixing regardless: Akira pointed out that the fix for this, sphinx-doc/sphinx#3099, landed in Sphinx 9.1.0 rather than 9.0.0, so v1's constant skips the 9.0.4 row above. I think that calls for a v2, with the constant fixed and the commit message reworded as described. Thanks, Masaharu