torvalds · jaehj122 · Apr 7, 2024 · Apr 7, 2024 · Apr 7, 2024 · Apr 7, 2024
diff --git a/Kbuild b/Kbuild
@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: GPL-2.0
-#
+# This file is important for building the kernel
 # Kbuild for top-level directory of the kernel
 
 # Prepare global headers and check sanity before descending into sub-directories

diff --git a/Kconfig b/Kconfig
@@ -1,8 +1,7 @@
 # SPDX-License-Identifier: GPL-2.0
-#
-# For a description of the syntax of this configuration file,
-# see Documentation/kbuild/kconfig-language.rst.
-#
+# Do not mess with this file.
+# For a description of the syntax of this configuration file,see Documentation/kbuild/kconfig-language.rst.
+# This scirpt is to configure the Kernel.
 mainmenu "Linux/$(ARCH) $(KERNELVERSION) Kernel Configuration"
 
 source "scripts/Kconfig.include"
@@ -30,3 +29,5 @@ source "lib/Kconfig"
 source "lib/Kconfig.debug"
 
 source "Documentation/Kconfig"
+
+# Refer to kernal docs at https://docs.kernel.org/
diff --git a/Makefile b/Makefile
@@ -8,8 +8,7 @@ NAME = Baby Opossum Posse
 # *DOCUMENTATION*
 # To see a list of typical targets execute "make help"
 # More info can be located in ./README
-# Comments in this file are targeted only to the developer, do not
-# expect to learn how to build the kernel reading this file.
+# Comments in this file are targeted only to the developer, do not expect to learn how to build the kernel reading this file.
 
 ifeq ($(filter undefine,$(.FEATURES)),)
 $(error GNU Make >= 3.82 is required. Your Make version is $(MAKE_VERSION))
@@ -22,8 +21,7 @@ $(if $(filter __%, $(MAKECMDGOALS)), \
 PHONY := __all
 __all:
 
-# We are using a recursive build, so we need to do a little thinking
-# to get the ordering right.
+# We are using a recursive build, so we need to do a little thinking to get the ordering right.
 #
 # Most importantly: sub-Makefiles should only ever modify files in
 # their own directory. If in some directory we have a dependency on

diff --git a/README b/README
@@ -1,18 +1,18 @@
-Linux kernel
+Linux kernel 6.9-rc3
 ============
 
-There are several guides for kernel developers and users. These guides can
-be rendered in a number of formats, like HTML and PDF. Please read
-Documentation/admin-guide/README.rst first.
+There are several (very important) guides for kernel developers and users. These guides can
+be rendered in a number of formats, like HTML and PDF. Please read Documentation/admin-guide/README.rst first.
 
-In order to build the documentation, use ``make htmldocs`` or
+In order to build the documentation, use the commands ``make htmldocs`` or
 ``make pdfdocs``.  The formatted documentation can also be read online at:
 
-    https://www.kernel.org/doc/html/latest/
+    https://www.kernel.org/doc/html/latest/ (Important)
 
-There are various text files in the Documentation/ subdirectory,
-several of them using the reStructuredText markup notation.
+There are various text files in the Documentation/ subdirectory, several of them using the reStructuredText markup notation.
 
-Please read the Documentation/process/changes.rst file, as it contains the
-requirements for building and running the kernel, and information about
-the problems which may result by upgrading your kernel.
+Please read the Documentation/process/changes.rst file, as it contains the requirements for building and running the kernel, and information about the problems whic
+h may result by upgrading your kernel.
+Do not upgrade to the latest kernel version if your Distro doesn't have it in repo updates yet!
+This is very important, for not only kernel devs but also common users compiling the linux kernal for the first time
+Warning: If you configure the kernel wrong, your system might not work!
diff --git a/arch/Kconfig b/arch/Kconfig
@@ -1,7 +1,7 @@
 # SPDX-License-Identifier: GPL-2.0
 #
 # General architecture dependent options
-#
+#Do not mess with this file
 
 #
 # Note: arch/$(SRCARCH)/Kconfig needs to be included first so that it can

diff --git a/arch/arm64/kernel/Makefile b/arch/arm64/kernel/Makefile
@@ -1,7 +1,7 @@
 # SPDX-License-Identifier: GPL-2.0
-#
+# Do not modify unless you need to do so
 # Makefile for the linux kernel.
-#
+# arm_64 only, no x86 code here
 
 CFLAGS_armv8_deprecated.o := -I$(src)
 

diff --git a/arch/m68k/mac/Makefile b/arch/m68k/mac/Makefile
@@ -1,7 +1,7 @@
 # SPDX-License-Identifier: GPL-2.0-only
-#
+# This kernal makefile is for macs that have the m68k chip archecuitecure
 # Makefile for Linux arch/m68k/mac source directory
-#
+# No powerpc mac code
 
 obj-y		:= config.o macints.o iop.o via.o oss.o psc.o \
 			baboon.o macboing.o misc.o
diff --git a/arch/powerpc/Kconfig b/arch/powerpc/Kconfig
@@ -86,12 +86,12 @@ config NR_IRQS
 config NMI_IPI
 	bool
 	depends on SMP && (DEBUGGER || KEXEC_CORE || HARDLOCKUP_DETECTOR)
-	default y
+	default yes
 
 config PPC_WATCHDOG
 	bool
 	depends on HARDLOCKUP_DETECTOR_ARCH
-	default y
+	default yes
 	help
 	  This is a placeholder when the powerpc hardlockup detector
 	  watchdog is selected (arch/powerpc/kernel/watchdog.c). It is
@@ -100,24 +100,24 @@ config PPC_WATCHDOG
 
 config STACKTRACE_SUPPORT
 	bool
-	default y
+	default yes
 
 config LOCKDEP_SUPPORT
 	bool
-	default y
+	default yes
 
 config GENERIC_LOCKBREAK
 	bool
-	default y
+	default yes
 	depends on SMP && PREEMPTION && !PPC_QUEUED_SPINLOCKS
 
 config GENERIC_HWEIGHT
 	bool
-	default y
+	default yes
 
 config PPC
 	bool
-	default y
+	default yes
 	#
 	# Please keep this list sorted alphabetically.
 	#

diff --git a/arch/s390/Makefile b/arch/s390/Makefile
@@ -1,10 +1,8 @@
 # SPDX-License-Identifier: GPL-2.0
-#
+# S390 code only
 # s390/Makefile
 #
-# This file is included by the global makefile so that you can add your own
-# architecture-specific flags and dependencies.
-#
+# This file is included by the global makefile so that you can add your own architecture-specific flags and dependencies.
 # Copyright (C) 1994 by Linus Torvalds
 #
 

diff --git a/arch/x86/Makefile_32.cpu b/arch/x86/Makefile_32.cpu
@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: GPL-2.0
-# CPU tuning section - shared with UML.
+# CPU fine-tuning section - shared with UML.
 # Must change only cflags-y (or [yn]), not CFLAGS! That makes a difference for UML.
 
 tune		= $(call cc-option,-mtune=$(1),$(2))

diff --git a/drivers/android/Kconfig b/drivers/android/Kconfig
@@ -4,7 +4,7 @@ menu "Android"
 config ANDROID_BINDER_IPC
 	bool "Android Binder IPC Driver"
 	depends on MMU
-	default n
+	default no
 	help
 	  Binder is used in Android for both communication between processes,
 	  and remote method invocation.
@@ -16,7 +16,7 @@ config ANDROID_BINDER_IPC
 config ANDROID_BINDERFS
 	bool "Android Binderfs filesystem"
 	depends on ANDROID_BINDER_IPC
-	default n
+	default no
 	help
 	  Binderfs is a pseudo-filesystem for the Android Binder IPC driver
 	  which can be mounted per-ipc namespace allowing to run multiple

diff --git a/fs/ext4/Kconfig b/fs/ext4/Kconfig
@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: GPL-2.0-only
-# Ext3 configs are here for backward compatibility with old configs which may
+# The Ext3 configs are here for backward compatibility with old configs which may
 # have EXT3_FS set but not EXT4_FS set and thus would result in non-bootable
 # kernels after the removal of ext3 driver.
 config EXT3_FS
@@ -91,7 +91,7 @@ config EXT4_FS_SECURITY
 	  labels in the ext4 filesystem.
 
 	  If you are not using a security module that requires using
-	  extended attributes for file security labels, say N.
+	  extended attributes for file security labels, say No.
 
 config EXT4_DEBUG
 	bool "Ext4 debugging support"
@@ -117,4 +117,4 @@ config EXT4_KUNIT_TESTS
 	  For more information on KUnit and unit tests in general please refer
 	  to the KUnit documentation in Documentation/dev-tools/kunit/.
 
-	  If unsure, say N.
+	  If unsure, say No.
diff --git a/include/soc/tegra/common.h b/include/soc/tegra/common.h
@@ -12,7 +12,7 @@
 struct device;
 
 /**
- * Tegra SoC core device OPP table configuration
+ * Nvidia Tegra SoC core device OPP table configuration
  *
  * @init_state: pre-initialize OPP state of a device
  */

diff --git a/sound/Makefile b/sound/Makefile
@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: GPL-2.0
 # Makefile for the Linux sound card driver
-#
+# Upgrade to Pipewire for sound if your distro supports it!
 
 obj-$(CONFIG_SOUND) += soundcore.o
 obj-$(CONFIG_DMASOUND) += oss/dmasound/