Commit 7210de3a authored by Linus Torvalds's avatar Linus Torvalds
Browse files

Merge tag 'docs-6.5-2' of git://git.lwn.net/linux 

Pull mode documentation updates from Jonathan Corbet:
 "A half-dozen late arriving docs patches. They are mostly fixes, but we
  also have a kernel-doc tweak for enums and the long-overdue removal of
  the outdated and redundant patch-submission comments at the top of the
  MAINTAINERS file"

* tag 'docs-6.5-2' of git://git.lwn.net/linux:
  scripts: kernel-doc: support private / public marking for enums
  Documentation: KVM: SEV: add a missing backtick
  Documentation: ACPI: fix typo in ssdt-overlays.rst
  Fix documentation of panic_on_warn
  docs: remove the tips on how to submit patches from MAINTAINERS
  docs: fix typo in zh_TW and zh_CN translation
parents 1793eac1 e27cb89a

Documentation/admin-guide/acpi/ssdt-overlays.rst

+1 −1
Original line number Diff line number Diff line
@@ -103,7 +103,7 @@ allows a persistent, OS independent way of storing the user defined SSDTs. There 
is also work underway to implement EFI support for loading user defined SSDTs

and using this method will make it easier to convert to the EFI loading

mechanism when that will arrive. To enable it, the

CONFIG_EFI_CUSTOM_SSDT_OVERLAYS shoyld be chosen to y.

CONFIG_EFI_CUSTOM_SSDT_OVERLAYS should be chosen to y.



In order to load SSDTs from an EFI variable the ``"efivar_ssdt=..."`` kernel

command line parameter can be used (the name has a limitation of 16 characters).

Documentation/admin-guide/kernel-parameters.txt

+1 −1
Original line number Diff line number Diff line
@@ -4064,7 +4064,7 @@ 
			extra details on the taint flags that users can pick

			to compose the bitmask to assign to panic_on_taint.



	panic_on_warn	panic() instead of WARN().  Useful to cause kdump

	panic_on_warn=1	panic() instead of WARN().  Useful to cause kdump

			on a WARN().



	parkbd.port=	[HW] Parallel port number the keyboard adapter is

Documentation/process/6.Followthrough.rst

+7 −0
Original line number Diff line number Diff line
@@ -51,6 +51,13 @@ mind: 
   working toward the creation of the best kernel they can; they are not

   trying to create discomfort for their employers' competitors.



 - Be prepared for seemingly silly requests for coding style changes

   and requests to factor out some of your code to shared parts of

   the kernel. One job the maintainers do is to keep things looking

   the same. Sometimes this means that the clever hack in your driver

   to get around a problem actually needs to become a generalized

   kernel feature ready for next time.



What all of this comes down to is that, when reviewers send you comments,

you need to pay attention to the technical observations that they are

making.  Do not let their form of expression or your own pride keep that

Documentation/translations/zh_CN/process/2.Process.rst

+1 −1
Original line number Diff line number Diff line
@@ -358,7 +358,7 @@ Andrew Morton 为有抱负的内核开发人员提供了如下建议 
	机器上始终完美运行”。通常的方法是和其他人一起解决问题（这可能需

	要坚持！），但就是如此——这是内核开发的一部分。



(http://lwn.net/articles/283982/)

(http://lwn.net/Articles/283982/)



在没有明显问题需要解决的情况下，通常建议开发人员查看当前的回归和开放缺陷

列表。从来都不缺少需要解决的问题；通过解决这些问题，开发人员将从该过程获得

Documentation/translations/zh_CN/process/3.Early-stage.rst

+1 −1
Original line number Diff line number Diff line
@@ -44,7 +44,7 @@ 
	试图向这些人传达用户需求是浪费时间。他们太“聪明”了，根本听不到少数

	人的话。



（http://lwn.net/articles/131776/）

（http://lwn.net/Articles/131776/）



实际情况却是不同的；与特定模块相比，内核开发人员更关心系统稳定性、长期维护

以及找到问题的正确解决方案。这个故事的寓意是把重点放在问题上——而不是具体的