linux/Documentation/process
Joe Perches b9918bdcac Documentation/process: Add fallthrough pseudo-keyword
Describe the fallthrough pseudo-keyword.

Convert the coding-style.rst example to the keyword style.
Add description and links to deprecated.rst.

Miguel Ojeda comments on the eventual [[fallthrough]] syntax:
 "Note that C17/C18 does not have [[fallthrough]].

  C++17 introduced it, as it is mentioned above. I would keep the
  __attribute__((fallthrough)) -> [[fallthrough]] change you did,
  though, since that is indeed the standard syntax (given the paragraph
  references C++17).

  I was told by Aaron Ballman (who is proposing them for C) that it is
  more or less likely that it becomes standardized in C2x. However, it
  is still not added to the draft (other attributes are already,
  though). See N2268 and N2269:

     http://www.open-std.org/jtc1/sc22/wg14/www/docs/n2268.pdf (fallthrough)
     http://www.open-std.org/jtc1/sc22/wg14/www/docs/n2269.pdf (attributes in general)"

Signed-off-by: Joe Perches <joe@perches.com>
Acked-by: Nick Desaulniers <ndesaulniers@google.com>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2019-10-11 09:26:05 -07:00
..
1.Intro.rst
2.Process.rst
3.Early-stage.rst
4.Coding.rst
5.Posting.rst
6.Followthrough.rst
7.AdvancedTopics.rst
8.Conclusion.rst
adding-syscalls.rst
applying-patches.rst
changes.rst Merge git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next 2019-07-11 10:55:49 -07:00
clang-format.rst
code-of-conduct-interpretation.rst
code-of-conduct.rst
coding-style.rst Documentation/process: Add fallthrough pseudo-keyword 2019-10-11 09:26:05 -07:00
deprecated.rst Documentation/process: Add fallthrough pseudo-keyword 2019-10-11 09:26:05 -07:00
development-process.rst
email-clients.rst doc: email-clients miscellaneous fixes 2019-07-31 13:05:37 -06:00
embargoed-hardware-issues.rst Documentation/process: Clarify disclosure rules 2019-09-29 12:43:18 +02:00
howto.rst docs: process: fix broken link 2019-08-24 15:14:38 -06:00
index.rst Documentation/process: Embargoed hardware security issues 2019-08-28 22:36:07 +02:00
kernel-docs.rst
kernel-driver-statement.rst
kernel-enforcement-statement.rst
license-rules.rst
magic-number.rst
maintainer-pgp-guide.rst Documentation: PGP: update for newer HW devices 2019-06-26 16:08:03 -06:00
management-style.rst
programming-language.rst
stable-api-nonsense.rst
stable-kernel-rules.rst
submit-checklist.rst docs: ioctl-number.txt: convert it to ReST format 2019-07-15 09:20:26 -03:00
submitting-drivers.rst
submitting-patches.rst docs: process: fix broken link 2019-08-24 15:14:38 -06:00
volatile-considered-harmful.rst