diff --git a/Kbuild b/Kbuild index 464b34a08f51ef..26e6d000c2b95a 100644 --- 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 index 745bc773f56706..cb110b98c145c6 100644 --- 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 index 67ce3b7d558eb9..5e2fc6faac9b7a 100644 --- 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 index fd903645e6de06..23002e43f80755 100644 --- 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 index 975dd22a2dbd22..01762c95325552 100644 --- 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 index 2b112f3b75109a..7146d6716194a6 100644 --- 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 index aa0eae562b16d6..9ea291e8bc39c9 100644 --- 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 index c88c6d46a5bc01..cdd98f460172af 100644 --- 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 index f2b21c7a70ef6e..cc228d8d6fd479 100644 --- 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 index 94834c4b5e5ef2..f2707a66a760e0 100644 --- 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 index 07aa8ae0a058c5..143776f4de0b33 100644 --- 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 index e20d59221fc05b..01cf2b9ed2cf4e 100644 --- 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 index 8ec1ac07fc85cb..837975ea739803 100644 --- 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 index 5942311a4232c5..ea613e7dc6fd58 100644 --- 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/