linux.git/Documentation/process/4.Coding.rst, branch v7.3-rc1

coccinelle: update Coccinelle website URL

2026-08-23T20:12:10+00:00

The old Coccinelle project URL is no longer available. Replace it with
the current Coccinelle homepage already referenced by
Documentation/dev-tools/coccinelle.rst.

Signed-off-by: Akira Aiura 
Signed-off-by: Julia Lawall

Doc: correct spelling and wording mistakes

2026-01-06T21:39:58+00:00

Fixed capitalization and punctuation in process documentation.

Signed-off-by: Volodymyr Kot 
Signed-off-by: Jonathan Corbet 
Message-ID: <20251225133911.87512-1-volodymyr.kot.ua@gmail.com>

Docs: Move clang-format from process/ to dev-tools/

2024-06-26T22:36:00+00:00

'clang-format' is on 'Other material' section of 'process/index', but it
may fit more under 'dev-tools/' directory.  Move it.

Signed-off-by: SeongJae Park 
Acked-by: Miguel Ojeda 
Acked-by: Federico Vaga 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/20240624185312.94537-5-sj@kernel.org

Add .editorconfig file for basic formatting

2023-12-28T07:22:47+00:00

EditorConfig is a specification to define the most basic code formatting
stuff, and it's supported by many editors and IDEs, either directly or
via plugins, including VSCode/VSCodium, Vim, emacs and more.

It allows to define formatting style related to indentation, charset,
end of lines and trailing whitespaces. It also allows to apply different
formats for different files based on wildcards, so for example it is
possible to apply different configs to *.{c,h}, *.py and *.rs.

In linux project, defining a .editorconfig might help to those people
that work on different projects with different indentation styles, so
they cannot define a global style. Now they will directly see the
correct indentation on every fresh clone of the project.

See https://editorconfig.org

Co-developed-by: Danny Lin 
Signed-off-by: Danny Lin 
Signed-off-by: Íñigo Huguet 
Acked-by: Mickaël Salaün 
Reviewed-by: Vincent Mailhol 
Tested-by: Vincent Mailhol 
Signed-off-by: Masahiro Yamada

doc: use KCFLAGS instead of EXTRA_CFLAGS to pass flags from command line

2021-02-22T20:59:10+00:00

You should use KCFLAGS to pass additional compiler flags from the
command line. Using EXTRA_CFLAGS is wrong.

EXTRA_CFLAGS is supposed to specify flags applied only to the current
Makefile (and now deprecated in favor of ccflags-y).

It is still used in arch/mips/kvm/Makefile (and possibly in external
modules too). Passing EXTRA_CFLAGS from the command line overwrites
it and breaks the build.

I also fixed drivers/gpu/drm/tilcdc/Makefile because commit 816175dd1fd7
("drivers/gpu/drm/tilcdc: Makefile, only -Werror when no -W* in
EXTRA_CFLAGS") was based on the same misunderstanding.

Signed-off-by: Masahiro Yamada 
Reviewed-by: Alex Shi 
Acked-by: Federico Vaga 
Link: https://lore.kernel.org/r/20210221152524.197693-1-masahiroy@kernel.org
Signed-off-by: Jonathan Corbet

docs: remove mention of ENABLE_MUST_CHECK

2021-01-07T21:41:38+00:00

We removed ENABLE_MUST_CHECK in 196793946264 ("Compiler Attributes:
remove CONFIG_ENABLE_MUST_CHECK"), so let's remove docs' mentions.

At the same time, fix the outdated text related to
ENABLE_WARN_DEPRECATED that wasn't removed in 3337d5cfe5e08
("configs: get rid of obsolete CONFIG_ENABLE_WARN_DEPRECATED").

Finally, reflow the paragraph.

Signed-off-by: Miguel Ojeda 
Reviewed-by: Nathan Chancellor 
Reviewed-by: Nick Desaulniers 
Link: https://lore.kernel.org/r/20210105055815.GA5173@kernel.org
Signed-off-by: Jonathan Corbet

Replace HTTP links with HTTPS ones: Documentation/process

2020-06-26T17:19:43+00:00

Rationale:
Reduces attack surface on kernel devs opening the links for MITM
as HTTPS traffic is much harder to manipulate.

Deterministic algorithm:
For each file:
  If not .svg:
    For each line:
      If doesn't contain `\bxmlns\b`:
        For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`:
          If both the HTTP and HTTPS versions
          return 200 OK and serve the same content:
            Replace HTTP with HTTPS.

Signed-off-by: Alexander A. Klimov 
Acked-by: Miguel Ojeda 
Link: https://lore.kernel.org/r/20200621133630.46435-1-grandmaster@al2klimov.de
Signed-off-by: Jonathan Corbet

docs: fault-injection: convert docs to ReST and rename to *.rst

2019-06-14T20:21:07+00:00

The conversion is actually:
  - add blank lines and identation in order to identify paragraphs;
  - fix tables markups;
  - add some lists markups;
  - mark literal blocks;
  - adjust title markups.

At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.

Signed-off-by: Mauro Carvalho Chehab 
Acked-by: Federico Vaga 
Signed-off-by: Jonathan Corbet

configs: get rid of obsolete CONFIG_ENABLE_WARN_DEPRECATED

2019-03-08T02:32:02+00:00

This Kconfig option was removed during v4.19 development in commit
771c035372a0 ("deprecate the '__deprecated' attribute warnings entirely
and for good") so there's no point to keep it in defconfigs any longer.

FWIW defconfigs were patched with:
--------------------------->8----------------------
find . -name *_defconfig -exec sed -i '/CONFIG_ENABLE_WARN_DEPRECATED/d' {} \;
--------------------------->8----------------------

Link: http://lkml.kernel.org/r/20190128152434.41969-1-abrodkin@synopsys.com
Signed-off-by: Alexey Brodkin 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

doc:process: add links where missing

2018-12-06T17:21:19+00:00

Some documents are refering to others without links. With this
patch I add those missing links.

This patch affects only documents under process/ and labels where
necessary.

Signed-off-by: Federico Vaga 
Signed-off-by: Jonathan Corbet