From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f180.google.com (mail-pf1-f180.google.com [209.85.210.180]) (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 9787B240611 for ; Mon, 17 Nov 2025 02:39:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.180 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763347198; cv=none; b=pFqSATNTfy2TGzOCTYYMBfmbeGr4y1at9creSphNX2lBGLcY1gmsfqbglsA7ddaFnX5ElWW+JYB7USypB4glaYKPCaqgVPpAa7f/ey3XoRqHEZOPa3ooiC6dClvye0VQnvALoFsi3YUKIvFDb2+43Iz30oxqgqXev+NupRxi6nw= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763347198; c=relaxed/simple; bh=HhdF9OYU+QV7SzB42QhUC87p9MkJlTtKwJScQKxAyo4=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=dYYC9TLB3ZqrZ4a6ubthW53Mb+pVgG5/t6iXaKTgLTxbxX0kEep8NZsaBO89+y4IeJdYyoCeeClIx+VBZ4oyg+jZH6sDTyqK118X1hp6NbSDGoQbPmgvz/kABlPNyDNGa1rx6rTM1Jye2EjumBf7zMQtSpnqLzldaX6OtljDgvE= 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=lkMCcl8+; arc=none smtp.client-ip=209.85.210.180 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="lkMCcl8+" Received: by mail-pf1-f180.google.com with SMTP id d2e1a72fcca58-7a435a3fc57so3498252b3a.1 for ; Sun, 16 Nov 2025 18:39:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1763347196; x=1763951996; darn=vger.kernel.org; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=eOf1IO3iV9NFMRVLrNnp7+aRuUjv89KLH0/8+weZfzo=; b=lkMCcl8+O32KSVUIdmti0TYGm8OzD+bpuovZcdvkKtiQd+rs5loYNf2NjvL+ul1fgm xjV1Yw4wEtHQrIJyltGHAaufeUjb8ooz5HOATDPyg/cz4mcafk4QRtH6eSZOrdlCWxuH L4KDtjMVq0thEWwwo9BBL4paa9kv7cMM7PaT2ve7t/McWWZOKE+7ds5DChmryXPhMbJa gMo4G9q7S7r6xHuj0ik4s1al2fTh8Jh6Ac/4jM5kHbHu9TKYVz2gr31Yx1p+o6gC1tJz ehNabG1YdIZMVGYWlKK9sPct/+HbUBVIekmuaA1XIaZbdGLDFfDbgJtYNll6ycKr/acV nTiA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1763347196; x=1763951996; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=eOf1IO3iV9NFMRVLrNnp7+aRuUjv89KLH0/8+weZfzo=; b=h63rVra3qAoGN8L1iaG8kUAWagZJaOhvnOZkWOvRQnQqfU6Q4quXXT2gIeEcYrcHe0 k2Yu/Pndukbqt36eUN+C3NENg38BQ8D9PvCQNj48eNh44sWgXQgPSnhaSsH7rDuydB1C 7R0pjP96pWGTASWulj6BTbn92/udfTIhdB4Ph/Oj+MGiTo/kzAUmcHeUbtl3fU7Kc3CW k1uN8scnFepAgGni2RsDi5toAtOKH5OgPmIw4zQcArp66oAQi7LAomTeckX/ZW3jrwWI kB5QDziMBdC80qIE5iTulhkn7bloSccu7eRWlS3ejdddkpc5SvWvM2e6nCkaEZ3+7vSN Lm+w== X-Forwarded-Encrypted: i=1; AJvYcCUhJ4LXenp1kafw0ckdqtJWjL2KZC9yRQclexsgCUUFSPJiPdbrUbAc0vGiIbMLyanqd4eBxLt617yGOWM=@vger.kernel.org X-Gm-Message-State: AOJu0Yy3AmBhV1PqqM8Cb8cqzd0u7uDDTh0SiE+3l2JiBkFHezhxHhkS 5SBIj8MQYkmKSqh/3DhgWjDbh/46J6AzrfxMHGQKq9ilXzVm/ZdmgS31 X-Gm-Gg: ASbGncveLBWKrPtyLNV+s2M7ei2B+ytH/iBOOL6kVzIdyIh1+joFj2IOTOEXSpH3N63 ZLGSH3/aCIPcNm0/hziOI5JAyLtm8YCQe1V/mb4dD24lmCysGN0dtcsqzFbOFlX8XimaSDTmza3 tqYiYdmapYm0yj0wtOYRJhXPH/KC4YYB9brpA2iqENCR/S5ae95dhvZ+NDMXaL9xu9QNA8uAIAd XagtEKF/VGwpBCH1uhzUgYtxBxtnBoi7YHcCY/9zq2EMgZC6PhZQAB3gtraIEFDcD77p42Q6VCD Kv4pXKB20NfFLHMVidBOuhhtV2/HBMEUS01QK5tIBZxodKtYuzaHiUMJlKv0yC7vJ5yodX4OJ8w MlkeTYRNmbwrGpcvhn6AtwB0VxmWYQ+pHELKokbjbsisKam7EKoCC3Si8GmWS9UO9vbpW/cCoq9 J3V2W8oRlIoyjqW7GU+yNqRFLbHW45jL/iEqGgkhCDFGlGDIEhQoAvZZH1 X-Google-Smtp-Source: AGHT+IH7X48eCGWixEiNwPlmpERSifoBu/b0ZTmcGSRhT4una/cpOnMf/79+MWXGYzANOF6NkR8O1A== X-Received: by 2002:a05:6a20:72ab:b0:334:a784:3046 with SMTP id adf61e73a8af0-35ba17aa0e5mr13313300637.38.1763347195661; Sun, 16 Nov 2025 18:39:55 -0800 (PST) Received: from [10.0.2.15] (KD106167137155.ppp-bb.dion.ne.jp. [106.167.137.155]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7b92782ad04sm11347998b3a.61.2025.11.16.18.39.53 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 16 Nov 2025 18:39:55 -0800 (PST) Message-ID: Date: Mon, 17 Nov 2025 11:39:52 +0900 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v4] docs: f2fs: wrap ASCII tables in literal blocks to fix LaTeX build To: Masaharu Noguchi Cc: corbet@lwn.net, linux-f2fs-devel@lists.sourceforge.net, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, bagasdotme@gmail.com, jaegeuk@kernel.org, chao@kernel.org References: <20251116102644.25400-1-nogunix@gmail.com> Content-Language: en-US From: Akira Yokosawa In-Reply-To: <20251116102644.25400-1-nogunix@gmail.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit On Sun, 16 Nov 2025 19:26:44 +0900, Masaharu Noguchi wrote: > Sphinx LaTeX builder fails on nested tables in f2fs.rst, producing: > > “Markup is unsupported in LaTeX: longtable does not support nesting a table.” > > Wrap the affected ASCII tables in literal code blocks so Sphinx renders them > verbatim. This avoids nested longtables and fixes the LaTeX build on Sphinx 8.2.x. > > Changes in v4: > - Rebased on 62242ac51061 > - Cleaned up Changelog placement (move version history above '---') This is not what I asked by saying: These background and change history should go out of the Changelog area. Changelog ends at '---'. See: https://www.kernel.org/doc/html/latest/process/submitting-patches.html#commentary > - Verified `make htmldocs` and `make pdfdocs` build fine > > Changes in v3: > - Replace TABs inside ASCII tables with spaces > > Changes in v2: > - Wrap nested ASCII tables in literal blocks and fix missing blank lines > > Acked-by: Bagas Sanjaya > Reviewed-by: Akira Yokosawa > Signed-off-by: Masaharu Noguchi > > Link: https://www.spinics.net/lists/kernel/msg5921848.html > Link: https://www.spinics.net/lists/kernel/msg5918264.html > Link: https://www.spinics.net/lists/kernel/msg5875662.html > --- > Documentation/filesystems/f2fs.rst | 131 +++++++++++++++-------------- > 1 file changed, 69 insertions(+), 62 deletions(-) ./scripts/checkpatch.pl emits the following: ------------------------------------------------------------------------ WARNING: Prefer a maximum 75 chars per line (possible unwrapped commit description?) #26: “Markup is unsupported in LaTeX: longtable does not support nesting a table.” ERROR: Please use git commit description style 'commit <12+ chars of sha1> ("")' - ie: 'commit 62242ac51061 ("Documentation: f2fs: Reword title")' #32: - Rebased on 62242ac51061 WARNING: Use lore.kernel.org archive links when possible - see https://lore.kernel.org/lists.html #46: Link: https://www.spinics.net/lists/kernel/msg5921848.html WARNING: Use lore.kernel.org archive links when possible - see https://lore.kernel.org/lists.html #47: Link: https://www.spinics.net/lists/kernel/msg5918264.html WARNING: Use lore.kernel.org archive links when possible - see https://lore.kernel.org/lists.html #48: Link: https://www.spinics.net/lists/kernel/msg5875662.html ------------------------------------------------------------------------ Also, please apply your patch on your own before submitting it and see the Changelog looks good to you. Thanks, Akira