diff options
author | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-13 08:43:30 -0300 |
---|---|---|
committer | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-13 08:43:30 -0300 |
commit | 8968da9b8622f2da9b7f0a695acbe341ea28f55e (patch) | |
tree | 8ea0037207dd445a512abc4d72d90a8b29255da5 /Documentation | |
parent | d2cd627be0f889ef7718eac98f68a822ad235f0a (diff) | |
download | linux-8968da9b8622f2da9b7f0a695acbe341ea28f55e.tar.gz linux-8968da9b8622f2da9b7f0a695acbe341ea28f55e.tar.bz2 linux-8968da9b8622f2da9b7f0a695acbe341ea28f55e.zip |
Revert "[media] docs-rst: escape [] characters"
This patch touches on places where it shouldn't: image
files and code examples. Also, it doesn't fix all array
occurrences.
So, let's revert it.
This reverts commit ffbab694ede33c294e5864a5e0bf4d1474446a71.
Diffstat (limited to 'Documentation')
68 files changed, 188 insertions, 188 deletions
diff --git a/Documentation/media/uapi/cec/cec-ioc-adap-g-caps.rst b/Documentation/media/uapi/cec/cec-ioc-adap-g-caps.rst index 8d9d55757d45..2ca9199c3305 100644 --- a/Documentation/media/uapi/cec/cec-ioc-adap-g-caps.rst +++ b/Documentation/media/uapi/cec/cec-ioc-adap-g-caps.rst @@ -52,7 +52,7 @@ returns the information to the application. The ioctl never fails. - char - - ``driver\[32\]`` + - ``driver[32]`` - The name of the cec adapter driver. @@ -60,7 +60,7 @@ returns the information to the application. The ioctl never fails. - char - - ``name\[32\]`` + - ``name[32]`` - The name of this CEC adapter. The combination ``driver`` and ``name`` must be unique. diff --git a/Documentation/media/uapi/cec/cec-ioc-adap-g-log-addrs.rst b/Documentation/media/uapi/cec/cec-ioc-adap-g-log-addrs.rst index c52b8888d381..7d7a3b43aedc 100644 --- a/Documentation/media/uapi/cec/cec-ioc-adap-g-log-addrs.rst +++ b/Documentation/media/uapi/cec/cec-ioc-adap-g-log-addrs.rst @@ -70,7 +70,7 @@ by a file handle in initiator mode (see - The actual logical addresses that were claimed. This is set by the driver. If no logical address could be claimed, then it is set to ``CEC_LOG_ADDR_INVALID``. If this adapter is Unregistered, then - ``log_addr\[0\]`` is set to 0xf and all others to + ``log_addr[0]`` is set to 0xf and all others to ``CEC_LOG_ADDR_INVALID``. - .. row 2 @@ -138,7 +138,7 @@ by a file handle in initiator mode (see - char - - ``osd_name``\ \[15\] + - ``osd_name``\ [15] - The On-Screen Display name as is returned by the ``CEC_MSG_SET_OSD_NAME`` message. @@ -178,7 +178,7 @@ by a file handle in initiator mode (see - __u8 - - ``features`` [CEC_MAX_LOG_ADDRS]\[12\] + - ``features`` [CEC_MAX_LOG_ADDRS][12] - Features for each logical address. Used to implement the ``CEC_MSG_REPORT_FEATURES`` message. The 12 bytes include both the diff --git a/Documentation/media/uapi/cec/cec-ioc-receive.rst b/Documentation/media/uapi/cec/cec-ioc-receive.rst index c315efc8ae2d..a327d499ac0e 100644 --- a/Documentation/media/uapi/cec/cec-ioc-receive.rst +++ b/Documentation/media/uapi/cec/cec-ioc-receive.rst @@ -133,7 +133,7 @@ queue, then it will return -1 and set errno to the EBUSY error code. - __u8 - - ``msg``\ \[16\] + - ``msg``\ [16] - The message payload. For :ref:`CEC_TRANSMIT` this is filled in by the application. The driver will fill this in for :ref:`CEC_RECEIVE` and diff --git a/Documentation/media/uapi/dvb/ca_data_types.rst b/Documentation/media/uapi/dvb/ca_data_types.rst index 8a776c855aab..025f910ae945 100644 --- a/Documentation/media/uapi/dvb/ca_data_types.rst +++ b/Documentation/media/uapi/dvb/ca_data_types.rst @@ -77,7 +77,7 @@ ca_msg_t unsigned int index; unsigned int type; unsigned int length; - unsigned char msg\[256\]; + unsigned char msg[256]; } ca_msg_t; @@ -92,7 +92,7 @@ ca_descr_t typedef struct ca_descr { unsigned int index; unsigned int parity; - unsigned char cw\[8\]; + unsigned char cw[8]; } ca_descr_t; diff --git a/Documentation/media/uapi/dvb/dmx-get-pes-pids.rst b/Documentation/media/uapi/dvb/dmx-get-pes-pids.rst index dcca37c7cec1..ba5d30c913c8 100644 --- a/Documentation/media/uapi/dvb/dmx-get-pes-pids.rst +++ b/Documentation/media/uapi/dvb/dmx-get-pes-pids.rst @@ -15,7 +15,7 @@ DMX_GET_PES_PIDS Synopsis -------- -.. cpp:function:: int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16\[5\]) +.. cpp:function:: int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16[5]) Arguments @@ -40,7 +40,7 @@ Arguments - .. row 3 - - __u16\[5\] + - __u16[5] - Undocumented. diff --git a/Documentation/media/uapi/dvb/dtv-property.rst b/Documentation/media/uapi/dvb/dtv-property.rst index 219111ebc7f5..5073a49def2a 100644 --- a/Documentation/media/uapi/dvb/dtv-property.rst +++ b/Documentation/media/uapi/dvb/dtv-property.rst @@ -13,14 +13,14 @@ struct dtv_property struct dtv_property { __u32 cmd; - __u32 reserved\[3\]; + __u32 reserved[3]; union { __u32 data; struct dtv_fe_stats st; struct { - __u8 data\[32\]; + __u8 data[32]; __u32 len; - __u32 reserved1\[3\]; + __u32 reserved1[3]; void *reserved2; } buffer; } u; diff --git a/Documentation/media/uapi/dvb/examples.rst b/Documentation/media/uapi/dvb/examples.rst index e23ad9fb2008..bf0a8617de92 100644 --- a/Documentation/media/uapi/dvb/examples.rst +++ b/Documentation/media/uapi/dvb/examples.rst @@ -87,7 +87,7 @@ tuners, but can easily be adjusted for QAM. struct secCmdSequence scmds; struct dmx_pes_filter_params pesFilterParams; FrontendParameters frp; - struct pollfd pfd\[1\]; + struct pollfd pfd[1]; FrontendEvent event; int demux1, demux2, demux3, front; @@ -143,7 +143,7 @@ tuners, but can easily be adjusted for QAM. scmd.u.diseqc.addr=0x10; scmd.u.diseqc.cmd=0x38; scmd.u.diseqc.numParams=1; - scmd.u.diseqc.params\[0\] = 0xF0 | ((diseqc * 4) & 0x0F) | + scmd.u.diseqc.params[0] = 0xF0 | ((diseqc * 4) & 0x0F) | (scmds.continuousTone == SEC_TONE_ON ? 1 : 0) | (scmds.voltage==SEC_VOLTAGE_18 ? 2 : 0); @@ -168,11 +168,11 @@ tuners, but can easily be adjusted for QAM. return -1; } - pfd\[0\].fd = front; - pfd\[0\].events = POLLIN; + pfd[0].fd = front; + pfd[0].events = POLLIN; if (poll(pfd,1,3000)){ - if (pfd\[0\].revents & POLLIN){ + if (pfd[0].revents & POLLIN){ printf("Getting QPSK event\\n"); if ( ioctl(front, FE_GET_EVENT, &event) @@ -324,7 +324,7 @@ recording. int written; uint8_t buf[BUFFY]; uint64_t length; - struct pollfd pfd\[1\]; + struct pollfd pfd[1]; int dvr, dvr_out; /* open dvr device */ @@ -351,13 +351,13 @@ recording. return -1; } - pfd\[0\].fd = dvr; - pfd\[0\].events = POLLIN; + pfd[0].fd = dvr; + pfd[0].events = POLLIN; /* poll for dvr data and write to file */ while (length < MAX_LENGTH ) { if (poll(pfd,1,1)){ - if (pfd\[0\].revents & POLLIN){ + if (pfd[0].revents & POLLIN){ len = read(dvr, buf, BUFFY); if (len < 0){ perror("recording"); diff --git a/Documentation/media/uapi/dvb/fe-diseqc-recv-slave-reply.rst b/Documentation/media/uapi/dvb/fe-diseqc-recv-slave-reply.rst index 0c356fcb6f08..7bd02ac7bff4 100644 --- a/Documentation/media/uapi/dvb/fe-diseqc-recv-slave-reply.rst +++ b/Documentation/media/uapi/dvb/fe-diseqc-recv-slave-reply.rst @@ -52,9 +52,9 @@ struct dvb_diseqc_slave_reply - uint8_t - - msg\[4\] + - msg[4] - - DiSEqC message (framing, data\[3\]) + - DiSEqC message (framing, data[3]) - .. row 2 diff --git a/Documentation/media/uapi/dvb/fe-diseqc-send-master-cmd.rst b/Documentation/media/uapi/dvb/fe-diseqc-send-master-cmd.rst index a60b8dd157fe..58a5e6ac10bd 100644 --- a/Documentation/media/uapi/dvb/fe-diseqc-send-master-cmd.rst +++ b/Documentation/media/uapi/dvb/fe-diseqc-send-master-cmd.rst @@ -52,9 +52,9 @@ struct dvb_diseqc_master_cmd - uint8_t - - msg\[6\] + - msg[6] - - DiSEqC message (framing, address, command, data\[3\]) + - DiSEqC message (framing, address, command, data[3]) - .. row 2 diff --git a/Documentation/media/uapi/dvb/fe-get-info.rst b/Documentation/media/uapi/dvb/fe-get-info.rst index 4176977f07b3..bb6c32e47ce8 100644 --- a/Documentation/media/uapi/dvb/fe-get-info.rst +++ b/Documentation/media/uapi/dvb/fe-get-info.rst @@ -57,7 +57,7 @@ struct dvb_frontend_info - char - - name\[128\] + - name[128] - Name of the frontend diff --git a/Documentation/media/uapi/dvb/video_types.rst b/Documentation/media/uapi/dvb/video_types.rst index d4debb36580d..671f365ceeb4 100644 --- a/Documentation/media/uapi/dvb/video_types.rst +++ b/Documentation/media/uapi/dvb/video_types.rst @@ -125,7 +125,7 @@ it can be extended safely in the future. } play; struct { - __u32 data\[16\]; + __u32 data[16]; } raw; }; }; @@ -352,7 +352,7 @@ passed to the ioctl VIDEO_GET_NAVI: typedef struct video_navi_pack { int length; /* 0 ... 1024 */ - uint8_t data\[1024\]; + uint8_t data[1024]; } video_navi_pack_t; diff --git a/Documentation/media/uapi/mediactl/media-ioc-device-info.rst b/Documentation/media/uapi/mediactl/media-ioc-device-info.rst index e7d9570a020f..467d82cbb81e 100644 --- a/Documentation/media/uapi/mediactl/media-ioc-device-info.rst +++ b/Documentation/media/uapi/mediactl/media-ioc-device-info.rst @@ -52,7 +52,7 @@ ioctl never fails. - char - - ``driver``\ \[16\] + - ``driver``\ [16] - Name of the driver implementing the media API as a NUL-terminated ASCII string. The driver version is stored in the @@ -66,7 +66,7 @@ ioctl never fails. - char - - ``model``\ \[32\] + - ``model``\ [32] - Device model name as a NUL-terminated UTF-8 string. The device version is stored in the ``device_version`` field and is not be @@ -76,7 +76,7 @@ ioctl never fails. - char - - ``serial``\ \[40\] + - ``serial``\ [40] - Serial number as a NUL-terminated ASCII string. @@ -84,7 +84,7 @@ ioctl never fails. - char - - ``bus_info``\ \[32\] + - ``bus_info``\ [32] - Location of the device in the system as a NUL-terminated ASCII string. This includes the bus type name (PCI, USB, ...) and a @@ -120,7 +120,7 @@ ioctl never fails. - __u32 - - ``reserved``\ \[31\] + - ``reserved``\ [31] - Reserved for future extensions. Drivers and applications must set this array to zero. diff --git a/Documentation/media/uapi/mediactl/media-ioc-enum-entities.rst b/Documentation/media/uapi/mediactl/media-ioc-enum-entities.rst index 181eef6a34e6..12d4b25d5b94 100644 --- a/Documentation/media/uapi/mediactl/media-ioc-enum-entities.rst +++ b/Documentation/media/uapi/mediactl/media-ioc-enum-entities.rst @@ -75,7 +75,7 @@ id's until they get an error. - char - - ``name``\ \[32\] + - ``name``\ [32] - - @@ -181,7 +181,7 @@ id's until they get an error. - - __u8 - - ``raw``\ \[184\] + - ``raw``\ [184] - - diff --git a/Documentation/media/uapi/mediactl/media-ioc-g-topology.rst b/Documentation/media/uapi/mediactl/media-ioc-g-topology.rst index 6fc564dde397..2e382cc7762c 100644 --- a/Documentation/media/uapi/mediactl/media-ioc-g-topology.rst +++ b/Documentation/media/uapi/mediactl/media-ioc-g-topology.rst @@ -163,7 +163,7 @@ desired arrays with the media graph elements. - char - - ``name``\ \[64\] + - ``name``\ [64] - Entity name as an UTF-8 NULL-terminated string. @@ -179,7 +179,7 @@ desired arrays with the media graph elements. - __u32 - - ``reserved``\ \[12\] + - ``reserved``\ [12] - Reserved for future extensions. Drivers and applications must set this array to zero. @@ -221,7 +221,7 @@ desired arrays with the media graph elements. - __u32 - - ``reserved``\ \[9\] + - ``reserved``\ [9] - Reserved for future extensions. Drivers and applications must set this array to zero. @@ -299,7 +299,7 @@ desired arrays with the media graph elements. - __u32 - - ``reserved``\ \[9\] + - ``reserved``\ [9] - Reserved for future extensions. Drivers and applications must set this array to zero. @@ -354,7 +354,7 @@ desired arrays with the media graph elements. - __u32 - - ``reserved``\ \[5\] + - ``reserved``\ [5] - Reserved for future extensions. Drivers and applications must set this array to zero. diff --git a/Documentation/media/uapi/rc/keytable.c.rst b/Documentation/media/uapi/rc/keytable.c.rst index 5ee6e8c6639d..e6ce1e3f5a78 100644 --- a/Documentation/media/uapi/rc/keytable.c.rst +++ b/Documentation/media/uapi/rc/keytable.c.rst @@ -35,16 +35,16 @@ file: uapi/v4l/keytable.c struct parse_key *p; for (p=keynames;p->name!=NULL;p++) { - if (p->value == (unsigned)codes\[1\]) { - printf("scancode 0x%04x = %s (0x%02x)\\n", codes\[0\], p->name, codes\[1\]); + if (p->value == (unsigned)codes[1]) { + printf("scancode 0x%04x = %s (0x%02x)\\n", codes[0], p->name, codes[1]); return; } } - if (isprint (codes\[1\])) - printf("scancode %d = '%c' (0x%02x)\\n", codes\[0\], codes\[1\], codes\[1\]); + if (isprint (codes[1])) + printf("scancode %d = '%c' (0x%02x)\\n", codes[0], codes[1], codes[1]); else - printf("scancode %d = 0x%02x\\n", codes\[0\], codes\[1\]); + printf("scancode %d = 0x%02x\\n", codes[0], codes[1]); } int parse_code(char *string) @@ -63,7 +63,7 @@ file: uapi/v4l/keytable.c { int fd; unsigned int i, j; - int codes\[2\]; + int codes[2]; if (argc<2 || argc>4) { printf ("usage: %s <device> to get table; or\\n" @@ -72,7 +72,7 @@ file: uapi/v4l/keytable.c return -1; } - if ((fd = open(argv\[1\], O_RDONLY)) < 0) { + if ((fd = open(argv[1], O_RDONLY)) < 0) { perror("Couldn't open input device"); return(-1); } @@ -80,16 +80,16 @@ file: uapi/v4l/keytable.c if (argc==4) { int value; - value=parse_code(argv\[3\]); + value=parse_code(argv[3]); if (value==-1) { - value = strtol(argv\[3\], NULL, 0); + value = strtol(argv[3], NULL, 0); if (errno) perror("value"); } - codes \[0\] = (unsigned) strtol(argv\[2\], NULL, 0); - codes \[1\] = (unsigned) value; + codes [0] = (unsigned) strtol(argv[2], NULL, 0); + codes [1] = (unsigned) value; if(ioctl(fd, EVIOCSKEYCODE, codes)) perror ("EVIOCSKEYCODE"); @@ -102,9 +102,9 @@ file: uapi/v4l/keytable.c if (argc==3) { FILE *fin; int value; - char *scancode, *keycode, s\[2048\]; + char *scancode, *keycode, s[2048]; - fin=fopen(argv\[2\],"r"); + fin=fopen(argv[2],"r"); if (fin==NULL) { perror ("opening keycode file"); return -1; @@ -113,8 +113,8 @@ file: uapi/v4l/keytable.c /* Clears old table */ for (j = 0; j < 256; j++) { for (i = 0; i < 256; i++) { - codes\[0\] = (j << 8) | i; - codes\[1\] = KEY_RESERVED; + codes[0] = (j << 8) | i; + codes[1] = KEY_RESERVED; ioctl(fd, EVIOCSKEYCODE, codes); } } @@ -149,12 +149,12 @@ file: uapi/v4l/keytable.c perror("value"); } - codes \[0\] = (unsigned) strtol(scancode, NULL, 0); - codes \[1\] = (unsigned) value; + codes [0] = (unsigned) strtol(scancode, NULL, 0); + codes [1] = (unsigned) value; - // printf("\\t%04x=%04x\\n",codes\[0\], codes\[1\]); + // printf("\\t%04x=%04x\\n",codes[0], codes[1]); if(ioctl(fd, EVIOCSKEYCODE, codes)) { - fprintf(stderr, "Setting scancode 0x%04x with 0x%04x via ",codes\[0\], codes\[1\]); + fprintf(stderr, "Setting scancode 0x%04x with 0x%04x via ",codes[0], codes[1]); perror ("EVIOCSKEYCODE"); } @@ -167,8 +167,8 @@ file: uapi/v4l/keytable.c /* Get scancode table */ for (j = 0; j < 256; j++) { for (i = 0; i < 256; i++) { - codes\[0\] = (j << 8) | i; - if (!ioctl(fd, EVIOCGKEYCODE, codes) && codes\[1\] != KEY_RESERVED) + codes[0] = (j << 8) | i; + if (!ioctl(fd, EVIOCGKEYCODE, codes) && codes[1] != KEY_RESERVED) prtcode(codes); } } diff --git a/Documentation/media/uapi/v4l/buffer.rst b/Documentation/media/uapi/v4l/buffer.rst index ba22464c0fcc..5deb4a46f992 100644 --- a/Documentation/media/uapi/v4l/buffer.rst +++ b/Documentation/media/uapi/v4l/buffer.rst @@ -379,7 +379,7 @@ struct v4l2_plane - __u32 - - ``reserved\[11\]`` + - ``reserved[11]`` - - Reserved for future use. Should be zeroed by drivers and @@ -868,7 +868,7 @@ struct v4l2_timecode - __u8 - - ``userbits``\ \[4\] + - ``userbits``\ [4] - The "user group" bits from the timecode. diff --git a/Documentation/media/uapi/v4l/capture.c.rst b/Documentation/media/uapi/v4l/capture.c.rst index 4f0dead97ad2..56525a0fb2fa 100644 --- a/Documentation/media/uapi/v4l/capture.c.rst +++ b/Documentation/media/uapi/v4l/capture.c.rst @@ -88,7 +88,7 @@ file: media/v4l/capture.c switch (io) { case IO_METHOD_READ: - if (-1 == read(fd, buffers\[0\].start, buffers\[0\].length)) { + if (-1 == read(fd, buffers[0].start, buffers[0].length)) { switch (errno) { case EAGAIN: return 0; @@ -103,7 +103,7 @@ file: media/v4l/capture.c } } - process_image(buffers\[0\].start, buffers\[0\].length); + process_image(buffers[0].start, buffers[0].length); break; case IO_METHOD_MMAP: @@ -284,7 +284,7 @@ file: media/v4l/capture.c switch (io) { case IO_METHOD_READ: - free(buffers\[0\].start); + free(buffers[0].start); break; case IO_METHOD_MMAP: @@ -311,10 +311,10 @@ file: media/v4l/capture.c exit(EXIT_FAILURE); } - buffers\[0\].length = buffer_size; - buffers\[0\].start = malloc(buffer_size); + buffers[0].length = buffer_size; + buffers[0].start = malloc(buffer_size); - if (!buffers\[0\].start) { + if (!buffers[0].start) { fprintf(stderr, "Out of memory\\n"); exit(EXIT_FAILURE); } @@ -575,7 +575,7 @@ file: media/v4l/capture.c "-f | --format Force format to 640x480 YUYVn" "-c | --count Number of frames to grab [%i]n" "", - argv\[0\], dev_name, frame_count); + argv[0], dev_name, frame_count); } static const char short_options[] = "d:hmruofc:"; diff --git a/Documentation/media/uapi/v4l/dev-osd.rst b/Documentation/media/uapi/v4l/dev-osd.rst index 36129cf4e92a..fadda131f020 100644 --- a/Documentation/media/uapi/v4l/dev-osd.rst +++ b/Documentation/media/uapi/v4l/dev-osd.rst @@ -68,7 +68,7 @@ Example: Finding a framebuffer device for OSD } for (i = 0; i < 30; i++) { - char dev_name\[16\]; + char dev_name[16]; struct fb_fix_screeninfo si; snprintf(dev_name, sizeof(dev_name), "/dev/fb%u", i); diff --git a/Documentation/media/uapi/v4l/dev-raw-vbi.rst b/Documentation/media/uapi/v4l/dev-raw-vbi.rst index eea4c05a0cd4..d5a4b3530b69 100644 --- a/Documentation/media/uapi/v4l/dev-raw-vbi.rst +++ b/Documentation/media/uapi/v4l/dev-raw-vbi.rst @@ -188,7 +188,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does service transmissions embedded in the picture. An application can set the first or second ``count`` value to zero - if no data is required from the respective field; ``count``\ \[1\] + if no data is required from the respective field; ``count``\ [1] if the scanning system is progressive, i. e. not interlaced. The corresponding start value shall be ignored by the application and driver. Anyway, drivers may not support single field capturing and @@ -318,7 +318,7 @@ The total size of a frame computes as follows: .. code-block:: c - (count\[0\] + count\[1\]) * samples_per_line * sample size in bytes + (count[0] + count[1]) * samples_per_line * sample size in bytes The sample size is most likely always one byte, applications must check the ``sample_format`` field though, to function properly with other diff --git a/Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf b/Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf Binary files differindex f672b52ef683..765235e33a4d 100644 --- a/Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf +++ b/Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf diff --git a/Documentation/media/uapi/v4l/dev-sdr.rst b/Documentation/media/uapi/v4l/dev-sdr.rst index 2bb560580b75..fc4053f957fb 100644 --- a/Documentation/media/uapi/v4l/dev-sdr.rst +++ b/Documentation/media/uapi/v4l/dev-sdr.rst @@ -110,7 +110,7 @@ data transfer, set by the driver in order to inform application. - __u8 - - ``reserved\[24\]`` + - ``reserved[24]`` - This array is reserved for future extensions. Drivers and applications must set it to zero. diff --git a/Documentation/media/uapi/v4l/dev-sliced-vbi.rst b/Documentation/media/uapi/v4l/dev-sliced-vbi.rst index 7df760367021..ec52a825f4d6 100644 --- a/Documentation/media/uapi/v4l/dev-sliced-vbi.rst +++ b/Documentation/media/uapi/v4l/dev-sliced-vbi.rst @@ -140,7 +140,7 @@ struct v4l2_sliced_vbi_format - __u16 - - ``service_lines``\ \[2\]\[24\] + - ``service_lines``\ [2][24] - :cspan:`2` @@ -170,7 +170,7 @@ struct v4l2_sliced_vbi_format - - - - ``service_lines``\ \[0\]\[1\] + - ``service_lines``\ [0][1] - 1 @@ -180,7 +180,7 @@ struct v4l2_sliced_vbi_format - - - - ``service_lines``\ \[0\]\[23\] + - ``service_lines``\ [0][23] - 23 @@ -190,7 +190,7 @@ struct v4l2_sliced_vbi_format - - - - ``service_lines``\ \[1\]\[1\] + - ``service_lines``\ [1][1] - 264 @@ -200,7 +200,7 @@ struct v4l2_sliced_vbi_format - - - - ``service_lines``\ \[1\]\[23\] + - ``service_lines``\ [1][23] - 286 @@ -210,8 +210,8 @@ struct v4l2_sliced_vbi_format - - - - :cspan:`2` Drivers must set ``service_lines`` \[0\]\[0\] and - ``service_lines``\ \[1\]\[0\] to zero. The + - :cspan:`2` Drivers must set ``service_lines`` [0][0] and + ``service_lines``\ [1][0] to zero. The ``V4L2_VBI_ITU_525_F1_START``, ``V4L2_VBI_ITU_525_F2_START``, ``V4L2_VBI_ITU_625_F1_START`` and ``V4L2_VBI_ITU_625_F2_START`` defines give the start line numbers for each field for each 525 or @@ -238,7 +238,7 @@ struct v4l2_sliced_vbi_format - __u32 - - ``reserved``\ \[2\] + - ``reserved``\ [2] - :cspan:`2` This array is reserved for future extensions. Applications and drivers must set it to zero. @@ -427,7 +427,7 @@ struct v4l2_sliced_vbi_data - __u8 - - ``data``\ \[48\] + - ``data``\ [48] - The packet payload. See :ref:`vbi-services` for the contents and number of bytes passed for each data type. The contents of padding @@ -566,7 +566,7 @@ struct v4l2_mpeg_vbi_fmt_ivtv - __u8 - - ``magic``\ \[4\] + - ``magic``\ [4] - - A "magic" constant from :ref:`v4l2-mpeg-vbi-fmt-ivtv-magic` that @@ -662,7 +662,7 @@ struct v4l2_mpeg_vbi_itv0 - __le32 - - ``linemask``\ \[2\] + - ``linemask``\ [2] - Bitmasks indicating the VBI service lines present. These ``linemask`` values are stored in little endian byte order in the @@ -675,30 +675,30 @@ struct v4l2_mpeg_vbi_itv0 :: - linemask\[0\] b0: line 6 first field - linemask\[0\] b17: line 23 first field - linemask\[0\] b18: line 6 second field - linemask\[0\] b31: line 19 second field - linemask\[1\] b0: line 20 second field - linemask\[1\] b3: line 23 second field - linemask\[1\] b4-b31: unused and set to 0 + linemask[0] b0: line 6 first field + linemask[0] b17: line 23 first field + linemask[0] b18: line 6 second field + linemask[0] b31: line 19 second field + linemask[1] b0: line 20 second field + linemask[1] b3: line 23 second field + linemask[1] b4-b31: unused and set to 0 - .. row 2 - struct :ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>` - - ``line``\ \[35\] + - ``line``\ [35] - This is a variable length array that holds from 1 to 35 lines of sliced VBI data. The sliced VBI data lines present correspond to the bits set in the ``linemask`` array, starting from b\ :sub:`0` - of ``linemask``\ \[0\] up through b\ :sub:`31` of ``linemask``\ \[0\], - and from b\ :sub:`0` of ``linemask``\ \[1\] up through b\ :sub:`3` of - ``linemask``\ \[1\]. ``line``\ \[0\] corresponds to the first bit - found set in the ``linemask`` array, ``line``\ \[1\] corresponds to + of ``linemask``\ [0] up through b\ :sub:`31` of ``linemask``\ [0], + and from b\ :sub:`0` of ``linemask``\ [1] up through b\ :sub:`3` of + ``linemask``\ [1]. ``line``\ [0] corresponds to the first bit + found set in the ``linemask`` array, ``line``\ [1] corresponds to the second bit found set in the ``linemask`` array, etc. If no - ``linemask`` array bits are set, then ``line``\ \[0\] may contain + ``linemask`` array bits are set, then ``line``\ [0] may contain one line of unspecified data that should be ignored by applications. @@ -720,11 +720,11 @@ struct v4l2_mpeg_vbi_ITV0 - struct :ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>` - - ``line``\ \[36\] + - ``line``\ [36] - - A fixed length array of 36 lines of sliced VBI data. ``line``\ \[0\] - through ``line``\ \[17\] correspond to lines 6 through 23 of the - first field. ``line``\ \[18\] through ``line``\ \[35\] corresponds to + - A fixed length array of 36 lines of sliced VBI data. ``line``\ [0] + through ``line``\ [17] correspond to lines 6 through 23 of the + first field. ``line``\ [18] through ``line``\ [35] corresponds to lines 6 through 23 of the second field. @@ -754,7 +754,7 @@ struct v4l2_mpeg_vbi_itv0_line - __u8 - - ``data``\ \[42\] + - ``data``\ [42] - The sliced VBI data for the line. diff --git a/Documentation/media/uapi/v4l/hist-v4l2.rst b/Documentation/media/uapi/v4l/hist-v4l2.rst index 3882fc7782d0..3ba1c0c2df1a 100644 --- a/Documentation/media/uapi/v4l/hist-v4l2.rst +++ b/Documentation/media/uapi/v4l/hist-v4l2.rst @@ -266,7 +266,7 @@ V4L2 Version 0.20 2000-11-23 A number of changes were made to the raw VBI interface. 1. Figures clarifying the line numbering scheme were added to the V4L2 - API specification. The ``start``\ \[0\] and ``start``\ \[1\] fields no + API specification. The ``start``\ [0] and ``start``\ [1] fields no longer count line numbers beginning at zero. Rationale: a) The previous definition was unclear. b) The ``start``\ [] values are ordinal numbers. c) There is no point in inventing a new line @@ -274,8 +274,8 @@ A number of changes were made to the raw VBI interface. Compatibility: Add one to the start values. Applications depending on the previous semantics may not function correctly. -2. The restriction "count\[0\] > 0 and count\[1\] > 0" has been relaxed to - "(count\[0\] + count\[1\]) > 0". Rationale: Drivers may allocate +2. The restriction "count[0] > 0 and count[1] > 0" has been relaxed to + "(count[0] + count[1]) > 0". Rationale: Drivers may allocate resources at scan line granularity and some data services are transmitted only on the first field. The comment that both ``count`` values will usually be equal is misleading and pointless and has been @@ -649,7 +649,7 @@ This unnamed version was finally merged into Linux 2.5.46. memory. It was barely useful and so was removed. 14. In struct :ref:`v4l2_framebuffer <v4l2-framebuffer>` the - ``base\[3\]`` array anticipating double- and triple-buffering in + ``base[3]`` array anticipating double- and triple-buffering in off-screen video memory, however without defining a synchronization mechanism, was replaced by a single pointer. The ``V4L2_FBUF_CAP_SCALEUP`` and ``V4L2_FBUF_CAP_SCALEDOWN`` flags were @@ -833,7 +833,7 @@ V4L2 in Linux 2.6.6, 2004-05-09 V4L2 in Linux 2.6.8 =================== -1. A new field ``input`` (former ``reserved\[0\]``) was added to the +1. A new field ``input`` (former ``reserved[0]``) was added to the struct :ref:`v4l2_buffer <v4l2-buffer>` structure. Purpose of this field is to alternate between video inputs (e. g. cameras) in step with the video capturing process. This function must be enabled with diff --git a/Documentation/media/uapi/v4l/pixfmt-003.rst b/Documentation/media/uapi/v4l/pixfmt-003.rst index d6a80d16afbc..25c54872fbe1 100644 --- a/Documentation/media/uapi/v4l/pixfmt-003.rst +++ b/Documentation/media/uapi/v4l/pixfmt-003.rst @@ -41,7 +41,7 @@ describing all planes of that format. - __u16 - - ``reserved\[6\]`` + - ``reserved[6]`` - Reserved for future extensions. Should be zeroed by drivers and applications. @@ -160,7 +160,7 @@ describing all planes of that format. - __u8 - - ``reserved\[7\]`` + - ``reserved[7]`` - Reserved for future extensions. Should be zeroed by drivers and applications. diff --git a/Documentation/media/uapi/v4l/subdev-formats.rst b/Documentation/media/uapi/v4l/subdev-formats.rst index c365cf116308..6dbb27b09c34 100644 --- a/Documentation/media/uapi/v4l/subdev-formats.rst +++ b/Documentation/media/uapi/v4l/subdev-formats.rst @@ -92,7 +92,7 @@ Media Bus Formats - __u16 - - ``reserved``\ \[11\] + - ``reserved``\ [11] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/v4l2grab.c.rst b/Documentation/media/uapi/v4l/v4l2grab.c.rst index 5d0263aab18c..5aabd0b7b089 100644 --- a/Documentation/media/uapi/v4l/v4l2grab.c.rst +++ b/Documentation/media/uapi/v4l/v4l2grab.c.rst @@ -62,7 +62,7 @@ file: media/v4l/v4l2grab.c int r, fd = -1; unsigned int i, n_buffers; char *dev_name = "/dev/video0"; - char out_name\[256\]; + char out_name[256]; FILE *fout; struct buffer *buffers; diff --git a/Documentation/media/uapi/v4l/vidioc-create-bufs.rst b/Documentation/media/uapi/v4l/vidioc-create-bufs.rst index 45c28af5c523..abdc0b4d83d5 100644 --- a/Documentation/media/uapi/v4l/vidioc-create-bufs.rst +++ b/Documentation/media/uapi/v4l/vidioc-create-bufs.rst @@ -125,7 +125,7 @@ than the number requested. - __u32 - - ``reserved``\ \[8\] + - ``reserved``\ [8] - A place holder for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-dbg-g-chip-info.rst b/Documentation/media/uapi/v4l/vidioc-dbg-g-chip-info.rst index 4c683a3457c2..f7e1b80af29e 100644 --- a/Documentation/media/uapi/v4l/vidioc-dbg-g-chip-info.rst +++ b/Documentation/media/uapi/v4l/vidioc-dbg-g-chip-info.rst @@ -115,7 +115,7 @@ instructions. - - char - - ``name\[32\]`` + - ``name[32]`` - Match a chip by this name, interpreted according to the ``type`` field. Currently unused. @@ -142,7 +142,7 @@ instructions. - char - - ``name\[32\]`` + - ``name[32]`` - The name of the chip. @@ -161,7 +161,7 @@ instructions. - __u32 - - ``reserved\[8\]`` + - ``reserved[8]`` - Reserved fields, both application and driver must set these to 0. diff --git a/Documentation/media/uapi/v4l/vidioc-dbg-g-register.rst b/Documentation/media/uapi/v4l/vidioc-dbg-g-register.rst index d8ab629b087d..09d2880e6170 100644 --- a/Documentation/media/uapi/v4l/vidioc-dbg-g-register.rst +++ b/Documentation/media/uapi/v4l/vidioc-dbg-g-register.rst @@ -123,7 +123,7 @@ instructions. - - char - - ``name\[32\]`` + - ``name[32]`` - Match a chip by this name, interpreted according to the ``type`` field. Currently unused. diff --git a/Documentation/media/uapi/v4l/vidioc-decoder-cmd.rst b/Documentation/media/uapi/v4l/vidioc-decoder-cmd.rst index 24419de4230e..2a36e91b57b9 100644 --- a/Documentation/media/uapi/v4l/vidioc-decoder-cmd.rst +++ b/Documentation/media/uapi/v4l/vidioc-decoder-cmd.rst @@ -178,7 +178,7 @@ introduced in Linux 3.3. - - __u32 - - ``data``\ \[16\] + - ``data``\ [16] - Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-dqevent.rst b/Documentation/media/uapi/v4l/vidioc-dqevent.rst index f426b195ceb8..73c0d5be62ee 100644 --- a/Documentation/media/uapi/v4l/vidioc-dqevent.rst +++ b/Documentation/media/uapi/v4l/vidioc-dqevent.rst @@ -116,7 +116,7 @@ call. - - __u8 - - ``data``\ \[64\] + - ``data``\ [64] - Event data. Defined by the event type. The union should be used to define easily accessible type for events. @@ -167,7 +167,7 @@ call. - __u32 - - ``reserved``\ \[8\] + - ``reserved``\ [8] - - Reserved for future extensions. Drivers must set the array to diff --git a/Documentation/media/uapi/v4l/vidioc-dv-timings-cap.rst b/Documentation/media/uapi/v4l/vidioc-dv-timings-cap.rst index 1a78407896fe..6e05957013bb 100644 --- a/Documentation/media/uapi/v4l/vidioc-dv-timings-cap.rst +++ b/Documentation/media/uapi/v4l/vidioc-dv-timings-cap.rst @@ -130,7 +130,7 @@ that doesn't support them will return an ``EINVAL`` error code. - __u32 - - ``reserved``\ \[16\] + - ``reserved``\ [16] - Reserved for future extensions. Drivers must set the array to zero. @@ -167,7 +167,7 @@ that doesn't support them will return an ``EINVAL`` error code. - __u32 - - ``reserved``\ \[2\] + - ``reserved``\ [2] - Reserved for future extensions. Drivers and applications must set the array to zero. @@ -193,7 +193,7 @@ that doesn't support them will return an ``EINVAL`` error code. - - __u32 - - ``raw_data``\ \[32\] + - ``raw_data``\ [32] - diff --git a/Documentation/media/uapi/v4l/vidioc-encoder-cmd.rst b/Documentation/media/uapi/v4l/vidioc-encoder-cmd.rst index 19b86603f4d7..69bd9b4e0e56 100644 --- a/Documentation/media/uapi/v4l/vidioc-encoder-cmd.rst +++ b/Documentation/media/uapi/v4l/vidioc-encoder-cmd.rst @@ -94,7 +94,7 @@ introduced in Linux 2.6.21. - __u32 - - ``data``\ \[8\] + - ``data``\ [8] - Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-enum-dv-timings.rst b/Documentation/media/uapi/v4l/vidioc-enum-dv-timings.rst index 71e0ae65abd1..3ba75d3fb93c 100644 --- a/Documentation/media/uapi/v4l/vidioc-enum-dv-timings.rst +++ b/Documentation/media/uapi/v4l/vidioc-enum-dv-timings.rst @@ -92,7 +92,7 @@ return an ``EINVAL`` error code. - __u32 - - ``reserved``\ \[2\] + - ``reserved``\ [2] - Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-enum-fmt.rst b/Documentation/media/uapi/v4l/vidioc-enum-fmt.rst index 3846009a39a7..90996f69d6ae 100644 --- a/Documentation/media/uapi/v4l/vidioc-enum-fmt.rst +++ b/Documentation/media/uapi/v4l/vidioc-enum-fmt.rst @@ -86,7 +86,7 @@ one until ``EINVAL`` is returned. - __u8 - - ``description``\ \[32\] + - ``description``\ [32] - Description of the format, a NUL-terminated ASCII string. This information is intended for the user, for example: "YUV 4:2:2". @@ -120,7 +120,7 @@ one until ``EINVAL`` is returned. - __u32 - - ``reserved``\ \[4\] + - ``reserved``\ [4] - Reserved for future extensions. Drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-enum-frameintervals.rst b/Documentation/media/uapi/v4l/vidioc-enum-frameintervals.rst index 6a2060b4a35c..ceae6003039e 100644 --- a/Documentation/media/uapi/v4l/vidioc-enum-frameintervals.rst +++ b/Documentation/media/uapi/v4l/vidioc-enum-frameintervals.rst @@ -217,7 +217,7 @@ application should zero out all members except for the *IN* fields. - __u32 - - ``reserved\[2\]`` + - ``reserved[2]`` - - Reserved space for future use. Must be zeroed by drivers and diff --git a/Documentation/media/uapi/v4l/vidioc-enum-framesizes.rst b/Documentation/media/uapi/v4l/vidioc-enum-framesizes.rst index 7a6a43b519df..8b268354d442 100644 --- a/Documentation/media/uapi/v4l/vidioc-enum-framesizes.rst +++ b/Documentation/media/uapi/v4l/vidioc-enum-framesizes.rst @@ -238,7 +238,7 @@ application should zero out all members except for the *IN* fields. - __u32 - - ``reserved\[2\]`` + - ``reserved[2]`` - - Reserved space for future use. Must be zeroed by drivers and diff --git a/Documentation/media/uapi/v4l/vidioc-enum-freq-bands.rst b/Documentation/media/uapi/v4l/vidioc-enum-freq-bands.rst index 19e86cfdbf39..00ab5e19cc1d 100644 --- a/Documentation/media/uapi/v4l/vidioc-enum-freq-bands.rst +++ b/Documentation/media/uapi/v4l/vidioc-enum-freq-bands.rst @@ -140,7 +140,7 @@ of the corresponding tuner/modulator is set. - __u32 - - ``reserved``\ \[9\] + - ``reserved``\ [9] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-enuminput.rst b/Documentation/media/uapi/v4l/vidioc-enuminput.rst index 1ea77135683a..5060f54e3d18 100644 --- a/Documentation/media/uapi/v4l/vidioc-enuminput.rst +++ b/Documentation/media/uapi/v4l/vidioc-enuminput.rst @@ -61,7 +61,7 @@ at index zero, incrementing by one until the driver returns ``EINVAL``. - __u8 - - ``name``\ \[32\] + - ``name``\ [32] - Name of the video input, a NUL-terminated ASCII string, for example: "Vin (Composite 2)". This information is intended for the @@ -141,7 +141,7 @@ at index zero, incrementing by one until the driver returns ``EINVAL``. - __u32 - - ``reserved``\ \[3\] + - ``reserved``\ [3] - Reserved for future extensions. Drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-enumoutput.rst b/Documentation/media/uapi/v4l/vidioc-enumoutput.rst index 83397f29903c..82fc9d3b237f 100644 --- a/Documentation/media/uapi/v4l/vidioc-enumoutput.rst +++ b/Documentation/media/uapi/v4l/vidioc-enumoutput.rst @@ -62,7 +62,7 @@ EINVAL. - __u8 - - ``name``\ \[32\] + - ``name``\ [32] - Name of the video output, a NUL-terminated ASCII string, for example: "Vout". This information is intended for the user, @@ -131,7 +131,7 @@ EINVAL. - __u32 - - ``reserved``\ \[3\] + - ``reserved``\ [3] - Reserved for future extensions. Drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-enumstd.rst b/Documentation/media/uapi/v4l/vidioc-enumstd.rst index e68a62803ac2..6699b26cdeb4 100644 --- a/Documentation/media/uapi/v4l/vidioc-enumstd.rst +++ b/Documentation/media/uapi/v4l/vidioc-enumstd.rst @@ -78,7 +78,7 @@ or output. [#f1]_ - __u8 - - ``name``\ \[24\] + - ``name``\ [24] - Name of the standard, a NUL-terminated ASCII string, for example: "PAL-B/G", "NTSC Japan". This information is intended for the @@ -105,7 +105,7 @@ or output. [#f1]_ - __u32 - - ``reserved``\ \[4\] + - ``reserved``\ [4] - Reserved for future extensions. Drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-expbuf.rst b/Documentation/media/uapi/v4l/vidioc-expbuf.rst index bf7e644f9ff0..ded708e647fa 100644 --- a/Documentation/media/uapi/v4l/vidioc-expbuf.rst +++ b/Documentation/media/uapi/v4l/vidioc-expbuf.rst @@ -179,7 +179,7 @@ Examples - __u32 - - ``reserved\[11\]`` + - ``reserved[11]`` - Reserved field for future use. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-audio.rst b/Documentation/media/uapi/v4l/vidioc-g-audio.rst index 0a023c2b67ea..cccbcdb8c463 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-audio.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-audio.rst @@ -70,7 +70,7 @@ return the actual new audio mode. - __u8 - - ``name``\ \[32\] + - ``name``\ [32] - Name of the audio input, a NUL-terminated ASCII string, for example: "Line In". This information is intended for the user, @@ -97,7 +97,7 @@ return the actual new audio mode. - __u32 - - ``reserved``\ \[2\] + - ``reserved``\ [2] - Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-audioout.rst b/Documentation/media/uapi/v4l/vidioc-g-audioout.rst index 6442cb74ec94..b1c1bfeb251e 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-audioout.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-audioout.rst @@ -75,7 +75,7 @@ as ``VIDIOC_G_AUDOUT`` does. - __u8 - - ``name``\ \[32\] + - ``name``\ [32] - Name of the audio output, a NUL-terminated ASCII string, for example: "Line Out". This information is intended for the user, @@ -103,7 +103,7 @@ as ``VIDIOC_G_AUDOUT`` does. - __u32 - - ``reserved``\ \[2\] + - ``reserved``\ [2] - Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-dv-timings.rst b/Documentation/media/uapi/v4l/vidioc-g-dv-timings.rst index 5c6aa7ae341e..f7bf21f49092 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-dv-timings.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-dv-timings.rst @@ -259,7 +259,7 @@ EBUSY - - __u32 - - ``reserved``\ \[32\] + - ``reserved``\ [32] - diff --git a/Documentation/media/uapi/v4l/vidioc-g-edid.rst b/Documentation/media/uapi/v4l/vidioc-g-edid.rst index cf0d100863ca..1a982b68a72f 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-edid.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-edid.rst @@ -131,7 +131,7 @@ EDID is no longer available. - __u32 - - ``reserved``\ \[5\] + - ``reserved``\ [5] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-enc-index.rst b/Documentation/media/uapi/v4l/vidioc-g-enc-index.rst index 27b8c84dad6a..f0f41ac56b80 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-enc-index.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-enc-index.rst @@ -86,7 +86,7 @@ video elementary streams. - __u32 - - ``reserved``\ \[4\] + - ``reserved``\ [4] - :cspan:`2` Reserved for future extensions. Drivers must set the array to zero. @@ -153,7 +153,7 @@ video elementary streams. - __u32 - - ``reserved``\ \[2\] + - ``reserved``\ [2] - Reserved for future extensions. Drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-ext-ctrls.rst b/Documentation/media/uapi/v4l/vidioc-g-ext-ctrls.rst index 74998e028864..39e24ad4b825 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-ext-ctrls.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-ext-ctrls.rst @@ -136,7 +136,7 @@ still cause this situation. - __u32 - - ``reserved2``\ \[1\] + - ``reserved2``\ [1] - - Reserved for future extensions. Drivers and applications must set @@ -338,7 +338,7 @@ still cause this situation. - __u32 - - ``reserved``\ \[2\] + - ``reserved``\ [2] - Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-fmt.rst b/Documentation/media/uapi/v4l/vidioc-g-fmt.rst index 9dc9e1e203a4..ee6f11978fd6 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-fmt.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-fmt.rst @@ -171,7 +171,7 @@ The format as returned by :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>` must be identical - - __u8 - - ``raw_data``\ \[200\] + - ``raw_data``\ [200] - Place holder for future extensions. diff --git a/Documentation/media/uapi/v4l/vidioc-g-frequency.rst b/Documentation/media/uapi/v4l/vidioc-g-frequency.rst index 8944f3bb5adb..a1fd2a870de4 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-frequency.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-frequency.rst @@ -102,7 +102,7 @@ write-only ioctl, it does not return the actual new frequency. - __u32 - - ``reserved``\ \[8\] + - ``reserved``\ [8] - Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst b/Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst index 6e084d3c30bb..f5bf8b7915ed 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst @@ -94,7 +94,7 @@ encoding. You usually do want to add them. - char - - ``APP_data``\ \[60\] + - ``APP_data``\ [60] - @@ -110,7 +110,7 @@ encoding. You usually do want to add them. - char - - ``COM_data``\ \[60\] + - ``COM_data``\ [60] - diff --git a/Documentation/media/uapi/v4l/vidioc-g-modulator.rst b/Documentation/media/uapi/v4l/vidioc-g-modulator.rst index ee4cfc07f756..a2e8c73f0678 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-modulator.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-modulator.rst @@ -81,7 +81,7 @@ To change the radio frequency the - __u8 - - ``name``\ \[32\] + - ``name``\ [32] - Name of the modulator, a NUL-terminated ASCII string. This information is intended for the user. @@ -149,7 +149,7 @@ To change the radio frequency the - __u32 - - ``reserved``\ \[3\] + - ``reserved``\ [3] - Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-parm.rst b/Documentation/media/uapi/v4l/vidioc-g-parm.rst index 80378272cdef..7116e0decddc 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-parm.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-parm.rst @@ -103,7 +103,7 @@ union holding separate parameters for input and output devices. - - __u8 - - ``raw_data``\ \[200\] + - ``raw_data``\ [200] - A place holder for future extensions. @@ -183,7 +183,7 @@ union holding separate parameters for input and output devices. - __u32 - - ``reserved``\ \[4\] + - ``reserved``\ [4] - Reserved for future extensions. Drivers and applications must set the array to zero. @@ -271,7 +271,7 @@ union holding separate parameters for input and output devices. - __u32 - - ``reserved``\ \[4\] + - ``reserved``\ [4] - Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-selection.rst b/Documentation/media/uapi/v4l/vidioc-g-selection.rst index e17ff45bd208..953931fabd00 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-selection.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-selection.rst @@ -182,7 +182,7 @@ Selection targets and flags are documented in - __u32 - - ``reserved\[9\]`` + - ``reserved[9]`` - Reserved fields for future use. Drivers and applications must zero this array. diff --git a/Documentation/media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst b/Documentation/media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst index b9c44b22cda1..f1f661d0200c 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst @@ -65,7 +65,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. - __u16 - - ``service_lines``\ \[2\]\[24\] + - ``service_lines``\ [2][24] - :cspan:`2` Each element of this array contains a set of data services the hardware can look for or insert into a particular @@ -87,7 +87,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. - - - - ``service_lines``\ \[0\]\[1\] + - ``service_lines``\ [0][1] - 1 @@ -97,7 +97,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. - - - - ``service_lines``\ \[0\]\[23\] + - ``service_lines``\ [0][23] - 23 @@ -107,7 +107,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. - - - - ``service_lines``\ \[1\]\[1\] + - ``service_lines``\ [1][1] - 264 @@ -117,7 +117,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. - - - - ``service_lines``\ \[1\]\[23\] + - ``service_lines``\ [1][23] - 286 @@ -147,8 +147,8 @@ the sliced VBI API is unsupported or ``type`` is invalid. - - - - :cspan:`2` Drivers must set ``service_lines`` \[0\]\[0\] and - ``service_lines``\ \[1\]\[0\] to zero. + - :cspan:`2` Drivers must set ``service_lines`` [0][0] and + ``service_lines``\ [1][0] to zero. - .. row 12 @@ -164,7 +164,7 @@ the sliced VBI API is unsupported or ``type`` is invalid. - __u32 - - ``reserved``\ \[3\] + - ``reserved``\ [3] - :cspan:`2` This array is reserved for future extensions. Applications and drivers must set it to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-g-tuner.rst b/Documentation/media/uapi/v4l/vidioc-g-tuner.rst index f9b0bfeef859..614db06b8b4b 100644 --- a/Documentation/media/uapi/v4l/vidioc-g-tuner.rst +++ b/Documentation/media/uapi/v4l/vidioc-g-tuner.rst @@ -79,7 +79,7 @@ To change the radio frequency the - __u8 - - ``name``\ \[32\] + - ``name``\ [32] - :cspan:`1` @@ -246,7 +246,7 @@ To change the radio frequency the - __u32 - - ``reserved``\ \[4\] + - ``reserved``\ [4] - :cspan:`1` Reserved for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-querycap.rst b/Documentation/media/uapi/v4l/vidioc-querycap.rst index 769a554dd8b9..b10fed313f99 100644 --- a/Documentation/media/uapi/v4l/vidioc-querycap.rst +++ b/Documentation/media/uapi/v4l/vidioc-querycap.rst @@ -53,7 +53,7 @@ specification the ioctl returns an ``EINVAL`` error code. - __u8 - - ``driver``\ \[16\] + - ``driver``\ [16] - Name of the driver, a unique NUL-terminated ASCII string. For example: "bttv". Driver specific applications can use this @@ -69,7 +69,7 @@ specification the ioctl returns an ``EINVAL`` error code. - __u8 - - ``card``\ \[32\] + - ``card``\ [32] - Name of the device, a NUL-terminated UTF-8 string. For example: "Yoyodyne TV/FM". One driver may support different brands or @@ -84,7 +84,7 @@ specification the ioctl returns an ``EINVAL`` error code. - __u8 - - ``bus_info``\ \[32\] + - ``bus_info``\ [32] - Location of the device in the system, a NUL-terminated ASCII string. For example: "PCI:0000:05:06.0". This information is @@ -166,7 +166,7 @@ specification the ioctl returns an ``EINVAL`` error code. - __u32 - - ``reserved``\ \[3\] + - ``reserved``\ [3] - Reserved for future extensions. Drivers must set this array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-queryctrl.rst b/Documentation/media/uapi/v4l/vidioc-queryctrl.rst index 72bc7b1b067c..8d6e61a7284d 100644 --- a/Documentation/media/uapi/v4l/vidioc-queryctrl.rst +++ b/Documentation/media/uapi/v4l/vidioc-queryctrl.rst @@ -124,7 +124,7 @@ See also the examples in :ref:`control`. - __u8 - - ``name``\ \[32\] + - ``name``\ [32] - Name of the control, a NUL-terminated ASCII string. This information is intended for the user. @@ -203,7 +203,7 @@ See also the examples in :ref:`control`. - __u32 - - ``reserved``\ \[2\] + - ``reserved``\ [2] - Reserved for future extensions. Drivers must set the array to zero. @@ -245,7 +245,7 @@ See also the examples in :ref:`control`. - char - - ``name``\ \[32\] + - ``name``\ [32] - Name of the control, a NUL-terminated ASCII string. This information is intended for the user. @@ -326,7 +326,7 @@ See also the examples in :ref:`control`. - The size in bytes of a single element of the array. Given a char pointer ``p`` to a 3-dimensional array you can find the position of cell ``(z, y, x)`` as follows: - ``p + ((z * dims\[1\] + y) * dims\[0\] + x) * elem_size``. + ``p + ((z * dims[1] + y) * dims[0] + x) * elem_size``. ``elem_size`` is always valid, also when the control isn't an array. For string controls ``elem_size`` is equal to ``maximum + 1``. @@ -363,7 +363,7 @@ See also the examples in :ref:`control`. - __u32 - - ``reserved``\ \[32\] + - ``reserved``\ [32] - Reserved for future extensions. Applications and drivers must set the array to zero. @@ -410,7 +410,7 @@ See also the examples in :ref:`control`. - - __u8 - - ``name``\ \[32\] + - ``name``\ [32] - Name of the menu item, a NUL-terminated ASCII string. This information is intended for the user. This field is valid for diff --git a/Documentation/media/uapi/v4l/vidioc-reqbufs.rst b/Documentation/media/uapi/v4l/vidioc-reqbufs.rst index 75dc34548ab7..5d0bc6d31c07 100644 --- a/Documentation/media/uapi/v4l/vidioc-reqbufs.rst +++ b/Documentation/media/uapi/v4l/vidioc-reqbufs.rst @@ -107,7 +107,7 @@ any DMA in progress, an implicit - __u32 - - ``reserved``\ \[2\] + - ``reserved``\ [2] - A place holder for future extensions. Drivers and applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-s-hw-freq-seek.rst b/Documentation/media/uapi/v4l/vidioc-s-hw-freq-seek.rst index c96d2edbf72a..5fd332a5bfee 100644 --- a/Documentation/media/uapi/v4l/vidioc-s-hw-freq-seek.rst +++ b/Documentation/media/uapi/v4l/vidioc-s-hw-freq-seek.rst @@ -150,7 +150,7 @@ error code is returned and no seek takes place. - __u32 - - ``reserved``\ \[5\] + - ``reserved``\ [5] - Reserved for future extensions. Applications must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-interval.rst b/Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-interval.rst index f472ea27f9c0..0aa6482a91a6 100644 --- a/Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-interval.rst +++ b/Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-interval.rst @@ -132,7 +132,7 @@ multiple pads of the same sub-device is not defined. - __u32 - - ``reserved``\ \[8\] + - ``reserved``\ [8] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-size.rst b/Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-size.rst index 8fcbdc1e73fe..7a5811b71b68 100644 --- a/Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-size.rst +++ b/Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-size.rst @@ -142,7 +142,7 @@ information about try formats. - __u32 - - ``reserved``\ \[8\] + - ``reserved``\ [8] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-subdev-enum-mbus-code.rst b/Documentation/media/uapi/v4l/vidioc-subdev-enum-mbus-code.rst index 3cb62dff3300..bc0531eb56fa 100644 --- a/Documentation/media/uapi/v4l/vidioc-subdev-enum-mbus-code.rst +++ b/Documentation/media/uapi/v4l/vidioc-subdev-enum-mbus-code.rst @@ -95,7 +95,7 @@ information about the try formats. - __u32 - - ``reserved``\ \[8\] + - ``reserved``\ [8] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-subdev-g-crop.rst b/Documentation/media/uapi/v4l/vidioc-subdev-g-crop.rst index 7f39d38303e7..ae802f1594e7 100644 --- a/Documentation/media/uapi/v4l/vidioc-subdev-g-crop.rst +++ b/Documentation/media/uapi/v4l/vidioc-subdev-g-crop.rst @@ -109,7 +109,7 @@ modified format should be as close as possible to the original request. - __u32 - - ``reserved``\ \[8\] + - ``reserved``\ [8] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-subdev-g-fmt.rst b/Documentation/media/uapi/v4l/vidioc-subdev-g-fmt.rst index b7f2aca64422..90e2a6635ebc 100644 --- a/Documentation/media/uapi/v4l/vidioc-subdev-g-fmt.rst +++ b/Documentation/media/uapi/v4l/vidioc-subdev-g-fmt.rst @@ -113,7 +113,7 @@ should be as close as possible to the original request. - __u32 - - ``reserved``\ \[8\] + - ``reserved``\ [8] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-subdev-g-frame-interval.rst b/Documentation/media/uapi/v4l/vidioc-subdev-g-frame-interval.rst index bcb1aae43e82..d8a1cabbd272 100644 --- a/Documentation/media/uapi/v4l/vidioc-subdev-g-frame-interval.rst +++ b/Documentation/media/uapi/v4l/vidioc-subdev-g-frame-interval.rst @@ -95,7 +95,7 @@ the same sub-device is not defined. - __u32 - - ``reserved``\ \[9\] + - ``reserved``\ [9] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-subdev-g-selection.rst b/Documentation/media/uapi/v4l/vidioc-subdev-g-selection.rst index 7d6611f0f9d5..50838a4a429e 100644 --- a/Documentation/media/uapi/v4l/vidioc-subdev-g-selection.rst +++ b/Documentation/media/uapi/v4l/vidioc-subdev-g-selection.rst @@ -117,7 +117,7 @@ Selection targets and flags are documented in - __u32 - - ``reserved``\ \[8\] + - ``reserved``\ [8] - Reserved for future extensions. Applications and drivers must set the array to zero. diff --git a/Documentation/media/uapi/v4l/vidioc-subscribe-event.rst b/Documentation/media/uapi/v4l/vidioc-subscribe-event.rst index 7c00c93c2d95..3ed91c627702 100644 --- a/Documentation/media/uapi/v4l/vidioc-subscribe-event.rst +++ b/Documentation/media/uapi/v4l/vidioc-subscribe-event.rst @@ -79,7 +79,7 @@ using the :ref:`VIDIOC_DQEVENT` ioctl. - __u32 - - ``reserved``\ \[5\] + - ``reserved``\ [5] - Reserved for future extensions. Drivers and applications must set the array to zero. |