mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: Weijie Yuan <kernel@wyuan.org>
To: Dongliang Mu <dzm91@hust.edu.cn>
Cc: Weijie Yuan <wy@wyuan.org>, Alex Shi <alexs@kernel.org>,
	Yanteng Si <si.yanteng@linux.dev>,
	Jonathan Corbet <corbet@lwn.net>,
	Shuah Khan <skhan@linuxfoundation.org>,
	linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: How to attempt to gradually eliminate the compilation output?
Date: Wed, 4 Nov 2026 14:46:58 +0800	[thread overview]
Message-ID: <aurU4uKyIUBl9-CJ@wyuan.org> (raw)

On Fri, Aug 21, 2026 at 07:18:56PM +0800, Dongliang Mu wrote:
> On 8/21/26 3:22 PM, Weijie Yuan wrote:
> > On Fri, Aug 21, 2026 at 02:54:59PM +0800, Dongliang Mu wrote:
> > > On 8/21/26 1:13 AM, Weijie Yuan wrote:
> > > > The script says:
> > > > 
> > > > $ tools/docs/checktransupdate.py Documentation/translations/zh_CN/process/maintainer-pgp-guide.rst
> > > > [1787244823.341547] Documentation/translations/zh_CN/process/maintainer-pgp-guide.rst
> > > > [1787244823.630509] commit 54857c52452a ("docs: maintainer-pgp-guide.rst: add a reference for kernel.org sign")
> > > > [1787244823.680849] commit 6c5c07bc8589 ("docs: process: maintainer-pgp-guide: update kernel.org docs link")
> > > > [1787244823.730027] commit 273aa250f138 ("Documentation: Improve wording on requirements for a free Nitrokey")
> > > > [1787244823.779408] commit f44a29784f68 ("Documentation: update maintainer-pgp-guide for latest best practices")
> > > > [1787244823.779522] 4 commits needs resolving in total
> > > > 
> > > > So I updated this document in chronological order, created four patches
> > > > based on these four outdated commits to make it easier for you to
> > > > review. Hence, you can freely squash them when applying them.
> > > > 
> > > > Tested with make htmldocs, no warning or error made by these patches.
> > > Hi Weijie,
> > > 
> > > Please make sure you execute "  make cleandocs & make htmldocs". Some
> > > warnings may be ignored by further compilation.
> > Hi!
> > 
> > Thanks for emphasizing this. While I do remember I used "make cleandocs
> > && make htmldocs", and checked among those long lines of red warning
> > output to find anything caused by my commit, I indeed didn't notice this
> > warning appearing at the early stage of the compilation.
> > 
> > It seems that I need to have my eyes checked soon. ;-)
> > 
> > Apologize for my recklessness.
> > 
> > Even so, do we have any way to distinguish these long-standing warnings
> > from the new warnings that appear during compilation? In fact, every
> > time I was worried that I might not have noticed the newly appeared
> > warning. Unfortunately, this time it really happened. (For example,
> > setting a new color? for new warnings?) Do you have a better idea or
> > tips for this?
> 
> My suggestion is to keep the log in each file, and you can easily observe
> the diff. Otherwise, even I can ignore some warnings.
> 
> And many contributors are coming together to fix those warnings. If they are
> done, all new warnings are easily captured. Let us do more contribution to
> help this.

Recently I've sent several patches to fix warnings.  But since I am not
familiar with the actual codes of theirs, I'm not confident enough to
touch some parts, but only the most obvious ones.

Since this is a goal that Jon has spent years for, I'm wondering if it's
possible to periodically send out some email notifications, which will
use the file paths from the compiled output to find the recipients and
kindly ask them to to deal with these annoying outputs? Perhaps we could
use a script to do this.?

Thanks.

             reply	other threads:[~2026-11-04  6:47 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-11-04  6:46 Weijie Yuan [this message]
2026-11-04  7:20 ` Jonathan Corbet
2026-11-04  8:14   ` Weijie Yuan
2026-11-04  8:42     ` Jonathan Corbet
2026-11-04  8:56       ` Weijie Yuan

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=aurU4uKyIUBl9-CJ@wyuan.org \
    --to=kernel@wyuan.org \
    --cc=alexs@kernel.org \
    --cc=corbet@lwn.net \
    --cc=dzm91@hust.edu.cn \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=si.yanteng@linux.dev \
    --cc=skhan@linuxfoundation.org \
    --cc=wy@wyuan.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®