From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dy1-f193.google.com (mail-dy1-f193.google.com [74.125.82.193]) (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 4ADD837B409 for ; Sat, 13 Jun 2026 23:28:34 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.193 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1781393315; cv=none; b=ocUGSTrNgn/94l6bf4L3Te6zmn/Lkl/C4t4Yclu2668P60L0Xw+Nuhml/Uo5h6oGE77BKAWV2b3cgVq0ns2MIOzxgF1OJbNeEK3lC21v/ep0DTi/4AYZBwqNvpdhF69YI0HFPIjI9IB5bP4DKIt5puDEoTaefef7h8RIgMMdpDI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1781393315; c=relaxed/simple; bh=/V+oEILKx/Lzli+MpHnzgkO8YbwX6Skih2zsBDPEXMY=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=Iq2I4rByph9Ex5Fq6GRF7KM8G9BWx6BcEY7Ql0nuFL2gfz8yWWczDWhFXBxBVJsup5qSoGll6Pj2R1dOvosxx2aI8Gt7Vb+UglaH7fAxApbrJV3BQWrukgm/alLc1/Tniosv9Rndp6Cs+EjNn5D9BoIlel82+49YDa00uK1thKY= 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=qSteVIZw; arc=none smtp.client-ip=74.125.82.193 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="qSteVIZw" Received: by mail-dy1-f193.google.com with SMTP id 5a478bee46e88-307d0405e07so3343409eec.1 for ; Sat, 13 Jun 2026 16:28:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1781393313; x=1781998113; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=WgPAND3Xg5aNuvMPGBlXEs+pI9ZCxyG9L+4QLg1/iFg=; b=qSteVIZw2o0mmmYKZ9pvb5BjWvgnKcuS+olbhKMMmo6xjxh+V1fLSfS3vgov5ExVur OooPlFX+K0Zbg5I2vLfN6VbqlWMBskPATGRNHOeqjx5d+N1BQs95pg7fNYtw0xlLCmcv NT2ya4WntZgfnf7jtxot0i9cATIh4OWDQe2QURcIwEXIT72mL/YFJUFUoa1sn2DG0QyJ vOzlQZXncD2ey3ykrzRsbJpT4aHBkcGenmal+1u3Lm3DEC1y1SX4mJj3rWSrKVz4EY8o VZGEevfCX6rX9EzF5eX/hn9cxa6S8BKzIFqTQZmrdRvkfk8QPaQa0ce1mfJ4BjGMcOwO sO1A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1781393313; x=1781998113; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=WgPAND3Xg5aNuvMPGBlXEs+pI9ZCxyG9L+4QLg1/iFg=; b=EyUkcfHlUA7S+foPYa/lwuYd4N0KBxJSvPvxYUCzeQPAe0qGM93RhCQCZ9i3ZEqUJP PBwFFzfwXT3dp7WZPMDtIVZyAZzMgffsNap6wDlSZr05SzmmGLm5WgDLLR+bUKX6J+vO 2d5XhL7tozbPPptPkhTxrLh6sFBLHCZCMh8wxyAKj3Hu83DuhB3FFwbdSIg42DkoH7Gg Sjs0Q1+EWq9SXNqxHP/yYiqbwKUFgZzl65I9BqvwhD+IJmpZeMZSAEyVE4LSCEGGBxkd jD6Rz5VB4FQ9NxKl9dMp7Owd8HycMguis2pjKxG0pa5rfGDT2Z+YmS/4MzGmTM4ENExN y2mA== X-Forwarded-Encrypted: i=1; AFNElJ8lnIWnpI9GcW+aFsDT/3nl0eiARP8nLbxo2bh7hRhVRG57cRy3GtwORf6v3zzpp39NOXEA+Tnhuw182bo=@vger.kernel.org X-Gm-Message-State: AOJu0YwttNPlYqVw+mxL47usyzdSw/8KsZjM/l+uNQNj9UL8vcCGaYPj DOaFMnpylxKHZoubiqXYRomAGzZbmlgNtoMGjoOVmeSgq0RBY1tHRbaa X-Gm-Gg: Acq92OFp1y3wQRnFC1RnRlco1R93LtZExy8vTflHZNsp/mPb87eGaPMcz/PF7/dgFYn X2nnSrEY873CE0GVvEVLH8jsU0dUZ3pdo1dFM76t5pXmkmYGnOyJhpqpjhIJL+J3Fl9V2GTXF1F YNhS+dETDEsEiP44GchSDMwG5VpTKTXhe72EC7umrRpd34F2HYwHk7FURIybjBLad4hKtB7aJER 6XcEJrgU/RBrEd9VdwPSNzPt6CPQBZ2SB+MEIvIgwoTMM0LvDjpuZ+N670BJBAfCPK9Dwm8zzP7 vxSwNyPBqH6EfAkcV0ftBv8regZp6UbULFxSXLPNtvwyhoUeg7CmRIH4PwFko1ecVgkE/RBJJBS 9paHOBu22RFrWK1H0yudCJ4Pnu0TojUlvqeh7Fop2Cjdy0CyKT2T9euD3YeNG0UD7/qpc35C1Y7 eKV1Id0cVu6kMFqEvEGNa7aVGdH0Ke7MtzLec3I6ZVZtnQC2k7XBc4/Q0Z4cH0fIcvAF+TqbQtA EfuzotzZX7/V8lPrJdCXWRD2b99IwscvNEq2NRE0aNzUwN6esBhxZXzl5sYx5R4SCIx2R2qZLW4 sm00ycLIDm+Bt9lRXg== X-Received: by 2002:a05:7300:642a:b0:2da:a813:a5fd with SMTP id 5a478bee46e88-3093bf08f59mr2726519eec.22.1781393313361; Sat, 13 Jun 2026 16:28:33 -0700 (PDT) Received: from ethan-latitude5420.. (host-127-24.cafrjco.fresno.ca.us.clients.pavlovmedia.net. [68.180.127.24]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-3081e4898c0sm9430028eec.3.2026.06.13.16.28.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Jun 2026 16:28:33 -0700 (PDT) From: Ethan Nelson-Moore To: Shuah Khan , Chen Pei , Randy Dunlap , Jonathan Corbet , Ethan Nelson-Moore , linux-kbuild@vger.kernel.org, linux-doc@vger.kernel.org Cc: Nathan Chancellor , Nicolas Schier Subject: [PATCH] docs: kbuild: remove ISDN references in Makefile examples Date: Sat, 13 Jun 2026 16:28:27 -0700 Message-ID: <20260613232830.147116-1-enelsonmoore@gmail.com> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kbuild@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Documentation/kbuild/makefiles.rst uses some extracts from now-removed ISDN code as examples. While they are harmless, they appeared in my checks for CONFIG_* symbols referenced but not defined in the kernel. Replace them with generic examples. Signed-off-by: Ethan Nelson-Moore --- Documentation/kbuild/makefiles.rst | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/Documentation/kbuild/makefiles.rst b/Documentation/kbuild/makefiles.rst index 24a4708d26e8..dfac8c9611f4 100644 --- a/Documentation/kbuild/makefiles.rst +++ b/Documentation/kbuild/makefiles.rst @@ -127,11 +127,8 @@ controllers are detected, and thus your disks are renumbered. Example:: - #drivers/isdn/i4l/Makefile - # Makefile for the kernel ISDN subsystem and device drivers. - # Each configuration option enables a list of files. - obj-$(CONFIG_ISDN_I4L) += isdn.o - obj-$(CONFIG_ISDN_PPP_BSDCOMP) += isdn_bsdcomp.o + obj-$(CONFIG_FOO) += foo.o + obj-$(CONFIG_BAR) += bar.o Loadable module goals - obj-m ----------------------------- @@ -145,10 +142,9 @@ simply adds the file to $(obj-m). Example:: - #drivers/isdn/i4l/Makefile - obj-$(CONFIG_ISDN_PPP_BSDCOMP) += isdn_bsdcomp.o + obj-$(CONFIG_FOO) += foo.o -Note: In this example $(CONFIG_ISDN_PPP_BSDCOMP) evaluates to "m" +Note: In this example $(CONFIG_FOO) evaluates to "m". If a kernel module is built from several source files, you specify that you want to build a module in the same way as above; however, @@ -158,13 +154,12 @@ variable. Example:: - #drivers/isdn/i4l/Makefile - obj-$(CONFIG_ISDN_I4L) += isdn.o - isdn-y := isdn_net_lib.o isdn_v110.o isdn_common.o + obj-$(CONFIG_FOO) += foo.o + foo-y := foo_1.o foo_2.o foo_3.o -In this example, the module name will be isdn.o. Kbuild will -compile the objects listed in $(isdn-y) and then run -``$(LD) -r`` on the list of these files to generate isdn.o. +In this example, the module name will be foo.o. Kbuild will +compile the objects listed in $(foo-y) and then run +``$(LD) -r`` on the list of these files to generate foo.o. Due to kbuild recognizing $(-y) for composite objects, you can use the value of a ``CONFIG_`` symbol to optionally include an -- 2.43.0