2018-08-21 12:35:28 +02:00
|
|
|
# EditorConfig is a file format and collection of text editor plugins
|
|
|
|
|
# for maintaining consistent coding styles between different editors
|
|
|
|
|
# and IDEs. Most popular editors support this either natively or via
|
|
|
|
|
# plugin.
|
|
|
|
|
#
|
|
|
|
|
# Check https://editorconfig.org for details.
|
2021-03-05 14:48:39 +00:00
|
|
|
#
|
|
|
|
|
# Emacs: you need https://github.com/10sr/editorconfig-custom-majormode-el
|
|
|
|
|
# to automatically enable the appropriate major-mode for your files
|
|
|
|
|
# that aren't already caught by your existing config.
|
|
|
|
|
#
|
2018-08-21 12:35:28 +02:00
|
|
|
|
2017-07-17 12:15:47 +02:00
|
|
|
root = true
|
|
|
|
|
|
|
|
|
|
[*]
|
|
|
|
|
end_of_line = lf
|
|
|
|
|
insert_final_newline = true
|
|
|
|
|
charset = utf-8
|
|
|
|
|
|
2018-08-21 12:35:28 +02:00
|
|
|
[*.mak]
|
|
|
|
|
indent_style = tab
|
|
|
|
|
indent_size = 8
|
2021-03-05 14:48:39 +00:00
|
|
|
emacs_mode = makefile
|
2018-08-21 12:35:28 +02:00
|
|
|
|
2017-07-17 12:15:47 +02:00
|
|
|
[Makefile*]
|
|
|
|
|
indent_style = tab
|
|
|
|
|
indent_size = 8
|
2021-03-05 14:48:39 +00:00
|
|
|
emacs_mode = makefile
|
2017-07-17 12:15:47 +02:00
|
|
|
|
2020-02-04 12:41:01 +01:00
|
|
|
[*.{c,h,c.inc,h.inc}]
|
2017-07-17 12:15:47 +02:00
|
|
|
indent_style = space
|
|
|
|
|
indent_size = 4
|
2021-03-05 14:48:39 +00:00
|
|
|
emacs_mode = c
|
2018-08-21 12:35:28 +02:00
|
|
|
|
2019-05-30 10:40:28 +01:00
|
|
|
[*.sh]
|
|
|
|
|
indent_style = space
|
|
|
|
|
indent_size = 4
|
|
|
|
|
|
2019-05-08 14:42:51 +01:00
|
|
|
[*.{s,S}]
|
|
|
|
|
indent_style = tab
|
|
|
|
|
indent_size = 8
|
2021-03-05 14:48:39 +00:00
|
|
|
emacs_mode = asm
|
2019-05-08 14:42:51 +01:00
|
|
|
|
2018-08-21 12:35:28 +02:00
|
|
|
[*.{vert,frag}]
|
2021-03-05 14:48:39 +00:00
|
|
|
emacs_mode = glsl
|
2018-08-21 12:35:28 +02:00
|
|
|
|
|
|
|
|
[*.json]
|
|
|
|
|
indent_style = space
|
2021-03-05 14:48:39 +00:00
|
|
|
emacs_mode = python
|
2025-01-16 16:02:56 +00:00
|
|
|
|
|
|
|
|
# by default follow QEMU's style
|
|
|
|
|
[*.pl]
|
|
|
|
|
indent_style = space
|
|
|
|
|
indent_size = 4
|
|
|
|
|
emacs_mode = perl
|
|
|
|
|
|
|
|
|
|
# but user kernel "style" for imported scripts
|
scripts/kernel-doc: Delete the old Perl kernel-doc script
We can now delete the old Perl kernel-doc script. For posterity,
this is a complete diff of the local changes that we were carrying
between the kernel's Perl script as of kernel commit 72b97d0b911872ba
(the last time we synced it) and our local copy:
--- /tmp/kdoc 2025-08-14 10:42:47.620331939 +0100
+++ scripts/kernel-doc 2025-02-17 10:44:34.528421457 +0000
@@ -1,5 +1,5 @@
#!/usr/bin/env perl
-# SPDX-License-Identifier: GPL-2.0
+# SPDX-License-Identifier: GPL-2.0-only
use warnings;
use strict;
@@ -224,12 +224,12 @@
my $type_fp_param = '\@(\w+)\(\)'; # Special RST handling for func ptr params
my $type_fp_param2 = '\@(\w+->\S+)\(\)'; # Special RST handling for structs with func ptr params
my $type_env = '(\$\w+)';
-my $type_enum = '\&(enum\s*([_\w]+))';
-my $type_struct = '\&(struct\s*([_\w]+))';
-my $type_typedef = '\&(typedef\s*([_\w]+))';
-my $type_union = '\&(union\s*([_\w]+))';
-my $type_member = '\&([_\w]+)(\.|->)([_\w]+)';
-my $type_fallback = '\&([_\w]+)';
+my $type_enum = '#(enum\s*([_\w]+))';
+my $type_struct = '#(struct\s*([_\w]+))';
+my $type_typedef = '#(([A-Z][_\w]*))';
+my $type_union = '#(union\s*([_\w]+))';
+my $type_member = '#([_\w]+)(\.|->)([_\w]+)';
+my $type_fallback = '(?!)'; # this never matches
my $type_member_func = $type_member . '\(\)';
# Output conversion substitutions.
@@ -1745,6 +1745,9 @@
)+
\)\)\s+//x;
+ # Strip QEMU specific compiler annotations
+ $prototype =~ s/QEMU_[A-Z_]+ +//;
+
# Yes, this truly is vile. We are looking for:
# 1. Return type (may be nothing if we're looking at a macro)
# 2. Function name
@@ -2057,7 +2060,7 @@
}
elsif (/$doc_decl/o) {
$identifier = $1;
- if (/\s*([\w\s]+?)(\(\))?\s*-/) {
+ if (/\s*([\w\s]+?)(\s*-|:)/) {
$identifier = $1;
}
@@ -2067,7 +2070,7 @@
$contents = "";
$section = $section_default;
$new_start_line = $. + 1;
- if (/-(.*)/) {
+ if (/[-:](.*)/) {
# strip leading/trailing/multiple spaces
$descr= $1;
$descr =~ s/^\s*//;
These changes correspond to:
06e2329636f license: Update deprecated SPDX tag GPL-2.0 to GPL-2.0-only
(a bulk change which we won't bother to re-apply to this third-party script)
b30df2751e5 scripts/kernel-doc: strip QEMU_ from function definitions
4cf41794411 docs: tweak kernel-doc for QEMU coding standards
We have already applied the equivalent of these changes to the
Python code in libs/kdoc/ in the preceding commits.
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Reviewed-by: Paolo Bonzini <pbonzini@redhat.com>
2025-08-14 18:13:22 +01:00
|
|
|
[scripts/{get_maintainer.pl,checkpatch.pl}]
|
2025-01-16 16:02:56 +00:00
|
|
|
indent_style = tab
|
|
|
|
|
indent_size = 8
|
|
|
|
|
emacs_mode = perl
|
|
|
|
|
|
