xref: /OK3568_Linux_fs/kernel/Documentation/userspace-api/media/conf_nitpick.py (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun# -*- coding: utf-8; mode: python -*-
2*4882a593Smuzhiyun
3*4882a593Smuzhiyun# SPDX-License-Identifier: GPL-2.0
4*4882a593Smuzhiyun
5*4882a593Smuzhiyunproject = 'Linux Media Subsystem Documentation'
6*4882a593Smuzhiyun
7*4882a593Smuzhiyun# It is possible to run Sphinx in nickpick mode with:
8*4882a593Smuzhiyunnitpicky = True
9*4882a593Smuzhiyun
10*4882a593Smuzhiyun# within nit-picking build, do not refer to any intersphinx object
11*4882a593Smuzhiyunintersphinx_mapping = {}
12*4882a593Smuzhiyun
13*4882a593Smuzhiyun# In nickpick mode, it will complain about lots of missing references that
14*4882a593Smuzhiyun#
15*4882a593Smuzhiyun# 1) are just typedefs like: bool, __u32, etc;
16*4882a593Smuzhiyun# 2) It will complain for things like: enum, NULL;
17*4882a593Smuzhiyun# 3) It will complain for symbols that should be on different
18*4882a593Smuzhiyun#    books (but currently aren't ported to ReST)
19*4882a593Smuzhiyun#
20*4882a593Smuzhiyun# The list below has a list of such symbols to be ignored in nitpick mode
21*4882a593Smuzhiyun#
22*4882a593Smuzhiyunnitpick_ignore = [
23*4882a593Smuzhiyun    ("c:func", "clock_gettime"),
24*4882a593Smuzhiyun    ("c:func", "close"),
25*4882a593Smuzhiyun    ("c:func", "container_of"),
26*4882a593Smuzhiyun    ("c:func", "copy_from_user"),
27*4882a593Smuzhiyun    ("c:func", "copy_to_user"),
28*4882a593Smuzhiyun    ("c:func", "determine_valid_ioctls"),
29*4882a593Smuzhiyun    ("c:func", "ERR_PTR"),
30*4882a593Smuzhiyun    ("c:func", "i2c_new_client_device"),
31*4882a593Smuzhiyun    ("c:func", "ioctl"),
32*4882a593Smuzhiyun    ("c:func", "IS_ERR"),
33*4882a593Smuzhiyun    ("c:func", "KERNEL_VERSION"),
34*4882a593Smuzhiyun    ("c:func", "mmap"),
35*4882a593Smuzhiyun    ("c:func", "open"),
36*4882a593Smuzhiyun    ("c:func", "pci_name"),
37*4882a593Smuzhiyun    ("c:func", "poll"),
38*4882a593Smuzhiyun    ("c:func", "PTR_ERR"),
39*4882a593Smuzhiyun    ("c:func", "read"),
40*4882a593Smuzhiyun    ("c:func", "release"),
41*4882a593Smuzhiyun    ("c:func", "set"),
42*4882a593Smuzhiyun    ("c:func", "struct fd_set"),
43*4882a593Smuzhiyun    ("c:func", "struct pollfd"),
44*4882a593Smuzhiyun    ("c:func", "usb_make_path"),
45*4882a593Smuzhiyun    ("c:func", "wait_finish"),
46*4882a593Smuzhiyun    ("c:func", "wait_prepare"),
47*4882a593Smuzhiyun    ("c:func", "write"),
48*4882a593Smuzhiyun
49*4882a593Smuzhiyun    ("c:type", "atomic_t"),
50*4882a593Smuzhiyun    ("c:type", "bool"),
51*4882a593Smuzhiyun    ("c:type", "boolean"),
52*4882a593Smuzhiyun    ("c:type", "buf_queue"),
53*4882a593Smuzhiyun    ("c:type", "device"),
54*4882a593Smuzhiyun    ("c:type", "device_driver"),
55*4882a593Smuzhiyun    ("c:type", "device_node"),
56*4882a593Smuzhiyun    ("c:type", "enum"),
57*4882a593Smuzhiyun    ("c:type", "fd"),
58*4882a593Smuzhiyun    ("c:type", "fd_set"),
59*4882a593Smuzhiyun    ("c:type", "file"),
60*4882a593Smuzhiyun    ("c:type", "i2c_adapter"),
61*4882a593Smuzhiyun    ("c:type", "i2c_board_info"),
62*4882a593Smuzhiyun    ("c:type", "i2c_client"),
63*4882a593Smuzhiyun    ("c:type", "int16_t"),
64*4882a593Smuzhiyun    ("c:type", "ktime_t"),
65*4882a593Smuzhiyun    ("c:type", "led_classdev_flash"),
66*4882a593Smuzhiyun    ("c:type", "list_head"),
67*4882a593Smuzhiyun    ("c:type", "lock_class_key"),
68*4882a593Smuzhiyun    ("c:type", "module"),
69*4882a593Smuzhiyun    ("c:type", "mutex"),
70*4882a593Smuzhiyun    ("c:type", "NULL"),
71*4882a593Smuzhiyun    ("c:type", "off_t"),
72*4882a593Smuzhiyun    ("c:type", "pci_dev"),
73*4882a593Smuzhiyun    ("c:type", "pdvbdev"),
74*4882a593Smuzhiyun    ("c:type", "poll_table"),
75*4882a593Smuzhiyun    ("c:type", "platform_device"),
76*4882a593Smuzhiyun    ("c:type", "pollfd"),
77*4882a593Smuzhiyun    ("c:type", "poll_table_struct"),
78*4882a593Smuzhiyun    ("c:type", "s32"),
79*4882a593Smuzhiyun    ("c:type", "s64"),
80*4882a593Smuzhiyun    ("c:type", "sd"),
81*4882a593Smuzhiyun    ("c:type", "size_t"),
82*4882a593Smuzhiyun    ("c:type", "spi_board_info"),
83*4882a593Smuzhiyun    ("c:type", "spi_device"),
84*4882a593Smuzhiyun    ("c:type", "spi_master"),
85*4882a593Smuzhiyun    ("c:type", "ssize_t"),
86*4882a593Smuzhiyun    ("c:type", "fb_fix_screeninfo"),
87*4882a593Smuzhiyun    ("c:type", "pollfd"),
88*4882a593Smuzhiyun    ("c:type", "timeval"),
89*4882a593Smuzhiyun    ("c:type", "video_capability"),
90*4882a593Smuzhiyun    ("c:type", "timeval"),
91*4882a593Smuzhiyun    ("c:type", "__u16"),
92*4882a593Smuzhiyun    ("c:type", "u16"),
93*4882a593Smuzhiyun    ("c:type", "__u32"),
94*4882a593Smuzhiyun    ("c:type", "u32"),
95*4882a593Smuzhiyun    ("c:type", "__u64"),
96*4882a593Smuzhiyun    ("c:type", "u64"),
97*4882a593Smuzhiyun    ("c:type", "u8"),
98*4882a593Smuzhiyun    ("c:type", "uint16_t"),
99*4882a593Smuzhiyun    ("c:type", "uint32_t"),
100*4882a593Smuzhiyun    ("c:type", "union"),
101*4882a593Smuzhiyun    ("c:type", "__user"),
102*4882a593Smuzhiyun    ("c:type", "usb_device"),
103*4882a593Smuzhiyun    ("c:type", "usb_interface"),
104*4882a593Smuzhiyun    ("c:type", "v4l2_std_id"),
105*4882a593Smuzhiyun    ("c:type", "video_system_t"),
106*4882a593Smuzhiyun    ("c:type", "vm_area_struct"),
107*4882a593Smuzhiyun
108*4882a593Smuzhiyun    # Opaque structures
109*4882a593Smuzhiyun
110*4882a593Smuzhiyun    ("c:type", "v4l2_m2m_dev"),
111*4882a593Smuzhiyun]
112