Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

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.

+188 -188
+2 -2
Documentation/media/uapi/cec/cec-ioc-adap-g-caps.rst
··· 52 52 53 53 - char 54 54 55 - - ``driver\[32\]`` 55 + - ``driver[32]`` 56 56 57 57 - The name of the cec adapter driver. 58 58 ··· 60 60 61 61 - char 62 62 63 - - ``name\[32\]`` 63 + - ``name[32]`` 64 64 65 65 - The name of this CEC adapter. The combination ``driver`` and 66 66 ``name`` must be unique.
+3 -3
Documentation/media/uapi/cec/cec-ioc-adap-g-log-addrs.rst
··· 70 70 - The actual logical addresses that were claimed. This is set by the 71 71 driver. If no logical address could be claimed, then it is set to 72 72 ``CEC_LOG_ADDR_INVALID``. If this adapter is Unregistered, then 73 - ``log_addr\[0\]`` is set to 0xf and all others to 73 + ``log_addr[0]`` is set to 0xf and all others to 74 74 ``CEC_LOG_ADDR_INVALID``. 75 75 76 76 - .. row 2 ··· 138 138 139 139 - char 140 140 141 - - ``osd_name``\ \[15\] 141 + - ``osd_name``\ [15] 142 142 143 143 - The On-Screen Display name as is returned by the 144 144 ``CEC_MSG_SET_OSD_NAME`` message. ··· 178 178 179 179 - __u8 180 180 181 - - ``features`` [CEC_MAX_LOG_ADDRS]\[12\] 181 + - ``features`` [CEC_MAX_LOG_ADDRS][12] 182 182 183 183 - Features for each logical address. Used to implement the 184 184 ``CEC_MSG_REPORT_FEATURES`` message. The 12 bytes include both the
+1 -1
Documentation/media/uapi/cec/cec-ioc-receive.rst
··· 133 133 134 134 - __u8 135 135 136 - - ``msg``\ \[16\] 136 + - ``msg``\ [16] 137 137 138 138 - The message payload. For :ref:`CEC_TRANSMIT` this is filled in by the 139 139 application. The driver will fill this in for :ref:`CEC_RECEIVE` and
+2 -2
Documentation/media/uapi/dvb/ca_data_types.rst
··· 77 77 unsigned int index; 78 78 unsigned int type; 79 79 unsigned int length; 80 - unsigned char msg\[256\]; 80 + unsigned char msg[256]; 81 81 } ca_msg_t; 82 82 83 83 ··· 92 92 typedef struct ca_descr { 93 93 unsigned int index; 94 94 unsigned int parity; 95 - unsigned char cw\[8\]; 95 + unsigned char cw[8]; 96 96 } ca_descr_t; 97 97 98 98
+2 -2
Documentation/media/uapi/dvb/dmx-get-pes-pids.rst
··· 15 15 Synopsis 16 16 -------- 17 17 18 - .. cpp:function:: int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16\[5\]) 18 + .. cpp:function:: int ioctl(fd, int request = DMX_GET_PES_PIDS, __u16[5]) 19 19 20 20 21 21 Arguments ··· 40 40 41 41 - .. row 3 42 42 43 - - __u16\[5\] 43 + - __u16[5] 44 44 45 45 - Undocumented. 46 46
+3 -3
Documentation/media/uapi/dvb/dtv-property.rst
··· 13 13 14 14 struct dtv_property { 15 15 __u32 cmd; 16 - __u32 reserved\[3\]; 16 + __u32 reserved[3]; 17 17 union { 18 18 __u32 data; 19 19 struct dtv_fe_stats st; 20 20 struct { 21 - __u8 data\[32\]; 21 + __u8 data[32]; 22 22 __u32 len; 23 - __u32 reserved1\[3\]; 23 + __u32 reserved1[3]; 24 24 void *reserved2; 25 25 } buffer; 26 26 } u;
+9 -9
Documentation/media/uapi/dvb/examples.rst
··· 87 87 struct secCmdSequence scmds; 88 88 struct dmx_pes_filter_params pesFilterParams; 89 89 FrontendParameters frp; 90 - struct pollfd pfd\[1\]; 90 + struct pollfd pfd[1]; 91 91 FrontendEvent event; 92 92 int demux1, demux2, demux3, front; 93 93 ··· 143 143 scmd.u.diseqc.addr=0x10; 144 144 scmd.u.diseqc.cmd=0x38; 145 145 scmd.u.diseqc.numParams=1; 146 - scmd.u.diseqc.params\[0\] = 0xF0 | ((diseqc * 4) & 0x0F) | 146 + scmd.u.diseqc.params[0] = 0xF0 | ((diseqc * 4) & 0x0F) | 147 147 (scmds.continuousTone == SEC_TONE_ON ? 1 : 0) | 148 148 (scmds.voltage==SEC_VOLTAGE_18 ? 2 : 0); 149 149 ··· 168 168 return -1; 169 169 } 170 170 171 - pfd\[0\].fd = front; 172 - pfd\[0\].events = POLLIN; 171 + pfd[0].fd = front; 172 + pfd[0].events = POLLIN; 173 173 174 174 if (poll(pfd,1,3000)){ 175 - if (pfd\[0\].revents & POLLIN){ 175 + if (pfd[0].revents & POLLIN){ 176 176 printf("Getting QPSK event\\n"); 177 177 if ( ioctl(front, FE_GET_EVENT, &event) 178 178 ··· 324 324 int written; 325 325 uint8_t buf[BUFFY]; 326 326 uint64_t length; 327 - struct pollfd pfd\[1\]; 327 + struct pollfd pfd[1]; 328 328 int dvr, dvr_out; 329 329 330 330 /* open dvr device */ ··· 351 351 return -1; 352 352 } 353 353 354 - pfd\[0\].fd = dvr; 355 - pfd\[0\].events = POLLIN; 354 + pfd[0].fd = dvr; 355 + pfd[0].events = POLLIN; 356 356 357 357 /* poll for dvr data and write to file */ 358 358 while (length < MAX_LENGTH ) { 359 359 if (poll(pfd,1,1)){ 360 - if (pfd\[0\].revents & POLLIN){ 360 + if (pfd[0].revents & POLLIN){ 361 361 len = read(dvr, buf, BUFFY); 362 362 if (len < 0){ 363 363 perror("recording");
+2 -2
Documentation/media/uapi/dvb/fe-diseqc-recv-slave-reply.rst
··· 52 52 53 53 - uint8_t 54 54 55 - - msg\[4\] 55 + - msg[4] 56 56 57 - - DiSEqC message (framing, data\[3\]) 57 + - DiSEqC message (framing, data[3]) 58 58 59 59 - .. row 2 60 60
+2 -2
Documentation/media/uapi/dvb/fe-diseqc-send-master-cmd.rst
··· 52 52 53 53 - uint8_t 54 54 55 - - msg\[6\] 55 + - msg[6] 56 56 57 - - DiSEqC message (framing, address, command, data\[3\]) 57 + - DiSEqC message (framing, address, command, data[3]) 58 58 59 59 - .. row 2 60 60
+1 -1
Documentation/media/uapi/dvb/fe-get-info.rst
··· 57 57 58 58 - char 59 59 60 - - name\[128\] 60 + - name[128] 61 61 62 62 - Name of the frontend 63 63
+2 -2
Documentation/media/uapi/dvb/video_types.rst
··· 125 125 } play; 126 126 127 127 struct { 128 - __u32 data\[16\]; 128 + __u32 data[16]; 129 129 } raw; 130 130 }; 131 131 }; ··· 352 352 typedef 353 353 struct video_navi_pack { 354 354 int length; /* 0 ... 1024 */ 355 - uint8_t data\[1024\]; 355 + uint8_t data[1024]; 356 356 } video_navi_pack_t; 357 357 358 358
+5 -5
Documentation/media/uapi/mediactl/media-ioc-device-info.rst
··· 52 52 53 53 - char 54 54 55 - - ``driver``\ \[16\] 55 + - ``driver``\ [16] 56 56 57 57 - Name of the driver implementing the media API as a NUL-terminated 58 58 ASCII string. The driver version is stored in the ··· 66 66 67 67 - char 68 68 69 - - ``model``\ \[32\] 69 + - ``model``\ [32] 70 70 71 71 - Device model name as a NUL-terminated UTF-8 string. The device 72 72 version is stored in the ``device_version`` field and is not be ··· 76 76 77 77 - char 78 78 79 - - ``serial``\ \[40\] 79 + - ``serial``\ [40] 80 80 81 81 - Serial number as a NUL-terminated ASCII string. 82 82 ··· 84 84 85 85 - char 86 86 87 - - ``bus_info``\ \[32\] 87 + - ``bus_info``\ [32] 88 88 89 89 - Location of the device in the system as a NUL-terminated ASCII 90 90 string. This includes the bus type name (PCI, USB, ...) and a ··· 120 120 121 121 - __u32 122 122 123 - - ``reserved``\ \[31\] 123 + - ``reserved``\ [31] 124 124 125 125 - Reserved for future extensions. Drivers and applications must set 126 126 this array to zero.
+2 -2
Documentation/media/uapi/mediactl/media-ioc-enum-entities.rst
··· 75 75 76 76 - char 77 77 78 - - ``name``\ \[32\] 78 + - ``name``\ [32] 79 79 80 80 - 81 81 - ··· 181 181 - 182 182 - __u8 183 183 184 - - ``raw``\ \[184\] 184 + - ``raw``\ [184] 185 185 186 186 - 187 187 -
+5 -5
Documentation/media/uapi/mediactl/media-ioc-g-topology.rst
··· 163 163 164 164 - char 165 165 166 - - ``name``\ \[64\] 166 + - ``name``\ [64] 167 167 168 168 - Entity name as an UTF-8 NULL-terminated string. 169 169 ··· 179 179 180 180 - __u32 181 181 182 - - ``reserved``\ \[12\] 182 + - ``reserved``\ [12] 183 183 184 184 - Reserved for future extensions. Drivers and applications must set 185 185 this array to zero. ··· 221 221 222 222 - __u32 223 223 224 - - ``reserved``\ \[9\] 224 + - ``reserved``\ [9] 225 225 226 226 - Reserved for future extensions. Drivers and applications must set 227 227 this array to zero. ··· 299 299 300 300 - __u32 301 301 302 - - ``reserved``\ \[9\] 302 + - ``reserved``\ [9] 303 303 304 304 - Reserved for future extensions. Drivers and applications must set 305 305 this array to zero. ··· 354 354 355 355 - __u32 356 356 357 - - ``reserved``\ \[5\] 357 + - ``reserved``\ [5] 358 358 359 359 - Reserved for future extensions. Drivers and applications must set 360 360 this array to zero.
+21 -21
Documentation/media/uapi/rc/keytable.c.rst
··· 35 35 struct parse_key *p; 36 36 37 37 for (p=keynames;p->name!=NULL;p++) { 38 - if (p->value == (unsigned)codes\[1\]) { 39 - printf("scancode 0x%04x = %s (0x%02x)\\n", codes\[0\], p->name, codes\[1\]); 38 + if (p->value == (unsigned)codes[1]) { 39 + printf("scancode 0x%04x = %s (0x%02x)\\n", codes[0], p->name, codes[1]); 40 40 return; 41 41 } 42 42 } 43 43 44 - if (isprint (codes\[1\])) 45 - printf("scancode %d = '%c' (0x%02x)\\n", codes\[0\], codes\[1\], codes\[1\]); 44 + if (isprint (codes[1])) 45 + printf("scancode %d = '%c' (0x%02x)\\n", codes[0], codes[1], codes[1]); 46 46 else 47 - printf("scancode %d = 0x%02x\\n", codes\[0\], codes\[1\]); 47 + printf("scancode %d = 0x%02x\\n", codes[0], codes[1]); 48 48 } 49 49 50 50 int parse_code(char *string) ··· 63 63 { 64 64 int fd; 65 65 unsigned int i, j; 66 - int codes\[2\]; 66 + int codes[2]; 67 67 68 68 if (argc<2 || argc>4) { 69 69 printf ("usage: %s <device> to get table; or\\n" ··· 72 72 return -1; 73 73 } 74 74 75 - if ((fd = open(argv\[1\], O_RDONLY)) < 0) { 75 + if ((fd = open(argv[1], O_RDONLY)) < 0) { 76 76 perror("Couldn't open input device"); 77 77 return(-1); 78 78 } ··· 80 80 if (argc==4) { 81 81 int value; 82 82 83 - value=parse_code(argv\[3\]); 83 + value=parse_code(argv[3]); 84 84 85 85 if (value==-1) { 86 - value = strtol(argv\[3\], NULL, 0); 86 + value = strtol(argv[3], NULL, 0); 87 87 if (errno) 88 88 perror("value"); 89 89 } 90 90 91 - codes \[0\] = (unsigned) strtol(argv\[2\], NULL, 0); 92 - codes \[1\] = (unsigned) value; 91 + codes [0] = (unsigned) strtol(argv[2], NULL, 0); 92 + codes [1] = (unsigned) value; 93 93 94 94 if(ioctl(fd, EVIOCSKEYCODE, codes)) 95 95 perror ("EVIOCSKEYCODE"); ··· 102 102 if (argc==3) { 103 103 FILE *fin; 104 104 int value; 105 - char *scancode, *keycode, s\[2048\]; 105 + char *scancode, *keycode, s[2048]; 106 106 107 - fin=fopen(argv\[2\],"r"); 107 + fin=fopen(argv[2],"r"); 108 108 if (fin==NULL) { 109 109 perror ("opening keycode file"); 110 110 return -1; ··· 113 113 /* Clears old table */ 114 114 for (j = 0; j < 256; j++) { 115 115 for (i = 0; i < 256; i++) { 116 - codes\[0\] = (j << 8) | i; 117 - codes\[1\] = KEY_RESERVED; 116 + codes[0] = (j << 8) | i; 117 + codes[1] = KEY_RESERVED; 118 118 ioctl(fd, EVIOCSKEYCODE, codes); 119 119 } 120 120 } ··· 149 149 perror("value"); 150 150 } 151 151 152 - codes \[0\] = (unsigned) strtol(scancode, NULL, 0); 153 - codes \[1\] = (unsigned) value; 152 + codes [0] = (unsigned) strtol(scancode, NULL, 0); 153 + codes [1] = (unsigned) value; 154 154 155 - // printf("\\t%04x=%04x\\n",codes\[0\], codes\[1\]); 155 + // printf("\\t%04x=%04x\\n",codes[0], codes[1]); 156 156 if(ioctl(fd, EVIOCSKEYCODE, codes)) { 157 - fprintf(stderr, "Setting scancode 0x%04x with 0x%04x via ",codes\[0\], codes\[1\]); 157 + fprintf(stderr, "Setting scancode 0x%04x with 0x%04x via ",codes[0], codes[1]); 158 158 perror ("EVIOCSKEYCODE"); 159 159 } 160 160 ··· 167 167 /* Get scancode table */ 168 168 for (j = 0; j < 256; j++) { 169 169 for (i = 0; i < 256; i++) { 170 - codes\[0\] = (j << 8) | i; 171 - if (!ioctl(fd, EVIOCGKEYCODE, codes) && codes\[1\] != KEY_RESERVED) 170 + codes[0] = (j << 8) | i; 171 + if (!ioctl(fd, EVIOCGKEYCODE, codes) && codes[1] != KEY_RESERVED) 172 172 prtcode(codes); 173 173 } 174 174 }
+2 -2
Documentation/media/uapi/v4l/buffer.rst
··· 379 379 380 380 - __u32 381 381 382 - - ``reserved\[11\]`` 382 + - ``reserved[11]`` 383 383 384 384 - 385 385 - Reserved for future use. Should be zeroed by drivers and ··· 868 868 869 869 - __u8 870 870 871 - - ``userbits``\ \[4\] 871 + - ``userbits``\ [4] 872 872 873 873 - The "user group" bits from the timecode. 874 874
+7 -7
Documentation/media/uapi/v4l/capture.c.rst
··· 88 88 89 89 switch (io) { 90 90 case IO_METHOD_READ: 91 - if (-1 == read(fd, buffers\[0\].start, buffers\[0\].length)) { 91 + if (-1 == read(fd, buffers[0].start, buffers[0].length)) { 92 92 switch (errno) { 93 93 case EAGAIN: 94 94 return 0; ··· 103 103 } 104 104 } 105 105 106 - process_image(buffers\[0\].start, buffers\[0\].length); 106 + process_image(buffers[0].start, buffers[0].length); 107 107 break; 108 108 109 109 case IO_METHOD_MMAP: ··· 284 284 285 285 switch (io) { 286 286 case IO_METHOD_READ: 287 - free(buffers\[0\].start); 287 + free(buffers[0].start); 288 288 break; 289 289 290 290 case IO_METHOD_MMAP: ··· 311 311 exit(EXIT_FAILURE); 312 312 } 313 313 314 - buffers\[0\].length = buffer_size; 315 - buffers\[0\].start = malloc(buffer_size); 314 + buffers[0].length = buffer_size; 315 + buffers[0].start = malloc(buffer_size); 316 316 317 - if (!buffers\[0\].start) { 317 + if (!buffers[0].start) { 318 318 fprintf(stderr, "Out of memory\\n"); 319 319 exit(EXIT_FAILURE); 320 320 } ··· 575 575 "-f | --format Force format to 640x480 YUYVn" 576 576 "-c | --count Number of frames to grab [%i]n" 577 577 "", 578 - argv\[0\], dev_name, frame_count); 578 + argv[0], dev_name, frame_count); 579 579 } 580 580 581 581 static const char short_options[] = "d:hmruofc:";
+1 -1
Documentation/media/uapi/v4l/dev-osd.rst
··· 68 68 } 69 69 70 70 for (i = 0; i < 30; i++) { 71 - char dev_name\[16\]; 71 + char dev_name[16]; 72 72 struct fb_fix_screeninfo si; 73 73 74 74 snprintf(dev_name, sizeof(dev_name), "/dev/fb%u", i);
+2 -2
Documentation/media/uapi/v4l/dev-raw-vbi.rst
··· 188 188 service transmissions embedded in the picture. 189 189 190 190 An application can set the first or second ``count`` value to zero 191 - if no data is required from the respective field; ``count``\ \[1\] 191 + if no data is required from the respective field; ``count``\ [1] 192 192 if the scanning system is progressive, i. e. not interlaced. The 193 193 corresponding start value shall be ignored by the application and 194 194 driver. Anyway, drivers may not support single field capturing and ··· 318 318 319 319 .. code-block:: c 320 320 321 - (count\[0\] + count\[1\]) * samples_per_line * sample size in bytes 321 + (count[0] + count[1]) * samples_per_line * sample size in bytes 322 322 323 323 The sample size is most likely always one byte, applications must check 324 324 the ``sample_format`` field though, to function properly with other
Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf

This is a binary file and will not be displayed.

+1 -1
Documentation/media/uapi/v4l/dev-sdr.rst
··· 110 110 111 111 - __u8 112 112 113 - - ``reserved\[24\]`` 113 + - ``reserved[24]`` 114 114 115 115 - This array is reserved for future extensions. Drivers and 116 116 applications must set it to zero.
+29 -29
Documentation/media/uapi/v4l/dev-sliced-vbi.rst
··· 140 140 141 141 - __u16 142 142 143 - - ``service_lines``\ \[2\]\[24\] 143 + - ``service_lines``\ [2][24] 144 144 145 145 - :cspan:`2` 146 146 ··· 170 170 171 171 - 172 172 - 173 - - ``service_lines``\ \[0\]\[1\] 173 + - ``service_lines``\ [0][1] 174 174 175 175 - 1 176 176 ··· 180 180 181 181 - 182 182 - 183 - - ``service_lines``\ \[0\]\[23\] 183 + - ``service_lines``\ [0][23] 184 184 185 185 - 23 186 186 ··· 190 190 191 191 - 192 192 - 193 - - ``service_lines``\ \[1\]\[1\] 193 + - ``service_lines``\ [1][1] 194 194 195 195 - 264 196 196 ··· 200 200 201 201 - 202 202 - 203 - - ``service_lines``\ \[1\]\[23\] 203 + - ``service_lines``\ [1][23] 204 204 205 205 - 286 206 206 ··· 210 210 211 211 - 212 212 - 213 - - :cspan:`2` Drivers must set ``service_lines`` \[0\]\[0\] and 214 - ``service_lines``\ \[1\]\[0\] to zero. The 213 + - :cspan:`2` Drivers must set ``service_lines`` [0][0] and 214 + ``service_lines``\ [1][0] to zero. The 215 215 ``V4L2_VBI_ITU_525_F1_START``, ``V4L2_VBI_ITU_525_F2_START``, 216 216 ``V4L2_VBI_ITU_625_F1_START`` and ``V4L2_VBI_ITU_625_F2_START`` 217 217 defines give the start line numbers for each field for each 525 or ··· 238 238 239 239 - __u32 240 240 241 - - ``reserved``\ \[2\] 241 + - ``reserved``\ [2] 242 242 243 243 - :cspan:`2` This array is reserved for future extensions. 244 244 Applications and drivers must set it to zero. ··· 427 427 428 428 - __u8 429 429 430 - - ``data``\ \[48\] 430 + - ``data``\ [48] 431 431 432 432 - The packet payload. See :ref:`vbi-services` for the contents and 433 433 number of bytes passed for each data type. The contents of padding ··· 566 566 567 567 - __u8 568 568 569 - - ``magic``\ \[4\] 569 + - ``magic``\ [4] 570 570 571 571 - 572 572 - A "magic" constant from :ref:`v4l2-mpeg-vbi-fmt-ivtv-magic` that ··· 662 662 663 663 - __le32 664 664 665 - - ``linemask``\ \[2\] 665 + - ``linemask``\ [2] 666 666 667 667 - Bitmasks indicating the VBI service lines present. These 668 668 ``linemask`` values are stored in little endian byte order in the ··· 675 675 676 676 :: 677 677 678 - linemask\[0\] b0: line 6 first field 679 - linemask\[0\] b17: line 23 first field 680 - linemask\[0\] b18: line 6 second field 681 - linemask\[0\] b31: line 19 second field 682 - linemask\[1\] b0: line 20 second field 683 - linemask\[1\] b3: line 23 second field 684 - linemask\[1\] b4-b31: unused and set to 0 678 + linemask[0] b0: line 6 first field 679 + linemask[0] b17: line 23 first field 680 + linemask[0] b18: line 6 second field 681 + linemask[0] b31: line 19 second field 682 + linemask[1] b0: line 20 second field 683 + linemask[1] b3: line 23 second field 684 + linemask[1] b4-b31: unused and set to 0 685 685 686 686 - .. row 2 687 687 688 688 - struct 689 689 :ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>` 690 690 691 - - ``line``\ \[35\] 691 + - ``line``\ [35] 692 692 693 693 - This is a variable length array that holds from 1 to 35 lines of 694 694 sliced VBI data. The sliced VBI data lines present correspond to 695 695 the bits set in the ``linemask`` array, starting from b\ :sub:`0` 696 - of ``linemask``\ \[0\] up through b\ :sub:`31` of ``linemask``\ \[0\], 697 - and from b\ :sub:`0` of ``linemask``\ \[1\] up through b\ :sub:`3` of 698 - ``linemask``\ \[1\]. ``line``\ \[0\] corresponds to the first bit 699 - found set in the ``linemask`` array, ``line``\ \[1\] corresponds to 696 + of ``linemask``\ [0] up through b\ :sub:`31` of ``linemask``\ [0], 697 + and from b\ :sub:`0` of ``linemask``\ [1] up through b\ :sub:`3` of 698 + ``linemask``\ [1]. ``line``\ [0] corresponds to the first bit 699 + found set in the ``linemask`` array, ``line``\ [1] corresponds to 700 700 the second bit found set in the ``linemask`` array, etc. If no 701 - ``linemask`` array bits are set, then ``line``\ \[0\] may contain 701 + ``linemask`` array bits are set, then ``line``\ [0] may contain 702 702 one line of unspecified data that should be ignored by 703 703 applications. 704 704 ··· 720 720 - struct 721 721 :ref:`v4l2_mpeg_vbi_itv0_line <v4l2-mpeg-vbi-itv0-line>` 722 722 723 - - ``line``\ \[36\] 723 + - ``line``\ [36] 724 724 725 - - A fixed length array of 36 lines of sliced VBI data. ``line``\ \[0\] 726 - through ``line``\ \[17\] correspond to lines 6 through 23 of the 727 - first field. ``line``\ \[18\] through ``line``\ \[35\] corresponds to 725 + - A fixed length array of 36 lines of sliced VBI data. ``line``\ [0] 726 + through ``line``\ [17] correspond to lines 6 through 23 of the 727 + first field. ``line``\ [18] through ``line``\ [35] corresponds to 728 728 lines 6 through 23 of the second field. 729 729 730 730 ··· 754 754 755 755 - __u8 756 756 757 - - ``data``\ \[42\] 757 + - ``data``\ [42] 758 758 759 759 - The sliced VBI data for the line. 760 760
+5 -5
Documentation/media/uapi/v4l/hist-v4l2.rst
··· 266 266 A number of changes were made to the raw VBI interface. 267 267 268 268 1. Figures clarifying the line numbering scheme were added to the V4L2 269 - API specification. The ``start``\ \[0\] and ``start``\ \[1\] fields no 269 + API specification. The ``start``\ [0] and ``start``\ [1] fields no 270 270 longer count line numbers beginning at zero. Rationale: a) The 271 271 previous definition was unclear. b) The ``start``\ [] values are 272 272 ordinal numbers. c) There is no point in inventing a new line ··· 274 274 Compatibility: Add one to the start values. Applications depending on 275 275 the previous semantics may not function correctly. 276 276 277 - 2. The restriction "count\[0\] > 0 and count\[1\] > 0" has been relaxed to 278 - "(count\[0\] + count\[1\]) > 0". Rationale: Drivers may allocate 277 + 2. The restriction "count[0] > 0 and count[1] > 0" has been relaxed to 278 + "(count[0] + count[1]) > 0". Rationale: Drivers may allocate 279 279 resources at scan line granularity and some data services are 280 280 transmitted only on the first field. The comment that both ``count`` 281 281 values will usually be equal is misleading and pointless and has been ··· 649 649 memory. It was barely useful and so was removed. 650 650 651 651 14. In struct :ref:`v4l2_framebuffer <v4l2-framebuffer>` the 652 - ``base\[3\]`` array anticipating double- and triple-buffering in 652 + ``base[3]`` array anticipating double- and triple-buffering in 653 653 off-screen video memory, however without defining a synchronization 654 654 mechanism, was replaced by a single pointer. The 655 655 ``V4L2_FBUF_CAP_SCALEUP`` and ``V4L2_FBUF_CAP_SCALEDOWN`` flags were ··· 833 833 V4L2 in Linux 2.6.8 834 834 =================== 835 835 836 - 1. A new field ``input`` (former ``reserved\[0\]``) was added to the 836 + 1. A new field ``input`` (former ``reserved[0]``) was added to the 837 837 struct :ref:`v4l2_buffer <v4l2-buffer>` structure. Purpose of this 838 838 field is to alternate between video inputs (e. g. cameras) in step 839 839 with the video capturing process. This function must be enabled with
+2 -2
Documentation/media/uapi/v4l/pixfmt-003.rst
··· 41 41 42 42 - __u16 43 43 44 - - ``reserved\[6\]`` 44 + - ``reserved[6]`` 45 45 46 46 - Reserved for future extensions. Should be zeroed by drivers and 47 47 applications. ··· 160 160 161 161 - __u8 162 162 163 - - ``reserved\[7\]`` 163 + - ``reserved[7]`` 164 164 165 165 - Reserved for future extensions. Should be zeroed by drivers and 166 166 applications.
+1 -1
Documentation/media/uapi/v4l/subdev-formats.rst
··· 92 92 93 93 - __u16 94 94 95 - - ``reserved``\ \[11\] 95 + - ``reserved``\ [11] 96 96 97 97 - Reserved for future extensions. Applications and drivers must set 98 98 the array to zero.
+1 -1
Documentation/media/uapi/v4l/v4l2grab.c.rst
··· 62 62 int r, fd = -1; 63 63 unsigned int i, n_buffers; 64 64 char *dev_name = "/dev/video0"; 65 - char out_name\[256\]; 65 + char out_name[256]; 66 66 FILE *fout; 67 67 struct buffer *buffers; 68 68
+1 -1
Documentation/media/uapi/v4l/vidioc-create-bufs.rst
··· 125 125 126 126 - __u32 127 127 128 - - ``reserved``\ \[8\] 128 + - ``reserved``\ [8] 129 129 130 130 - A place holder for future extensions. Drivers and applications 131 131 must set the array to zero.
+3 -3
Documentation/media/uapi/v4l/vidioc-dbg-g-chip-info.rst
··· 115 115 - 116 116 - char 117 117 118 - - ``name\[32\]`` 118 + - ``name[32]`` 119 119 120 120 - Match a chip by this name, interpreted according to the ``type`` 121 121 field. Currently unused. ··· 142 142 143 143 - char 144 144 145 - - ``name\[32\]`` 145 + - ``name[32]`` 146 146 147 147 - The name of the chip. 148 148 ··· 161 161 162 162 - __u32 163 163 164 - - ``reserved\[8\]`` 164 + - ``reserved[8]`` 165 165 166 166 - Reserved fields, both application and driver must set these to 0. 167 167
+1 -1
Documentation/media/uapi/v4l/vidioc-dbg-g-register.rst
··· 123 123 - 124 124 - char 125 125 126 - - ``name\[32\]`` 126 + - ``name[32]`` 127 127 128 128 - Match a chip by this name, interpreted according to the ``type`` 129 129 field. Currently unused.
+1 -1
Documentation/media/uapi/v4l/vidioc-decoder-cmd.rst
··· 178 178 - 179 179 - __u32 180 180 181 - - ``data``\ \[16\] 181 + - ``data``\ [16] 182 182 183 183 - Reserved for future extensions. Drivers and applications must set 184 184 the array to zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-dqevent.rst
··· 116 116 - 117 117 - __u8 118 118 119 - - ``data``\ \[64\] 119 + - ``data``\ [64] 120 120 121 121 - Event data. Defined by the event type. The union should be used to 122 122 define easily accessible type for events. ··· 167 167 168 168 - __u32 169 169 170 - - ``reserved``\ \[8\] 170 + - ``reserved``\ [8] 171 171 172 172 - 173 173 - Reserved for future extensions. Drivers must set the array to
+3 -3
Documentation/media/uapi/v4l/vidioc-dv-timings-cap.rst
··· 130 130 131 131 - __u32 132 132 133 - - ``reserved``\ \[16\] 133 + - ``reserved``\ [16] 134 134 135 135 - Reserved for future extensions. Drivers must set the array to 136 136 zero. ··· 167 167 168 168 - __u32 169 169 170 - - ``reserved``\ \[2\] 170 + - ``reserved``\ [2] 171 171 172 172 - Reserved for future extensions. Drivers and applications must set 173 173 the array to zero. ··· 193 193 - 194 194 - __u32 195 195 196 - - ``raw_data``\ \[32\] 196 + - ``raw_data``\ [32] 197 197 198 198 - 199 199
+1 -1
Documentation/media/uapi/v4l/vidioc-encoder-cmd.rst
··· 94 94 95 95 - __u32 96 96 97 - - ``data``\ \[8\] 97 + - ``data``\ [8] 98 98 99 99 - Reserved for future extensions. Drivers and applications must set 100 100 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-enum-dv-timings.rst
··· 92 92 93 93 - __u32 94 94 95 - - ``reserved``\ \[2\] 95 + - ``reserved``\ [2] 96 96 97 97 - Reserved for future extensions. Drivers and applications must set 98 98 the array to zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-enum-fmt.rst
··· 86 86 87 87 - __u8 88 88 89 - - ``description``\ \[32\] 89 + - ``description``\ [32] 90 90 91 91 - Description of the format, a NUL-terminated ASCII string. This 92 92 information is intended for the user, for example: "YUV 4:2:2". ··· 120 120 121 121 - __u32 122 122 123 - - ``reserved``\ \[4\] 123 + - ``reserved``\ [4] 124 124 125 125 - Reserved for future extensions. Drivers must set the array to 126 126 zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-enum-frameintervals.rst
··· 217 217 218 218 - __u32 219 219 220 - - ``reserved\[2\]`` 220 + - ``reserved[2]`` 221 221 222 222 - 223 223 - Reserved space for future use. Must be zeroed by drivers and
+1 -1
Documentation/media/uapi/v4l/vidioc-enum-framesizes.rst
··· 238 238 239 239 - __u32 240 240 241 - - ``reserved\[2\]`` 241 + - ``reserved[2]`` 242 242 243 243 - 244 244 - Reserved space for future use. Must be zeroed by drivers and
+1 -1
Documentation/media/uapi/v4l/vidioc-enum-freq-bands.rst
··· 140 140 141 141 - __u32 142 142 143 - - ``reserved``\ \[9\] 143 + - ``reserved``\ [9] 144 144 145 145 - Reserved for future extensions. Applications and drivers must set 146 146 the array to zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-enuminput.rst
··· 61 61 62 62 - __u8 63 63 64 - - ``name``\ \[32\] 64 + - ``name``\ [32] 65 65 66 66 - Name of the video input, a NUL-terminated ASCII string, for 67 67 example: "Vin (Composite 2)". This information is intended for the ··· 141 141 142 142 - __u32 143 143 144 - - ``reserved``\ \[3\] 144 + - ``reserved``\ [3] 145 145 146 146 - Reserved for future extensions. Drivers must set the array to 147 147 zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-enumoutput.rst
··· 62 62 63 63 - __u8 64 64 65 - - ``name``\ \[32\] 65 + - ``name``\ [32] 66 66 67 67 - Name of the video output, a NUL-terminated ASCII string, for 68 68 example: "Vout". This information is intended for the user, ··· 131 131 132 132 - __u32 133 133 134 - - ``reserved``\ \[3\] 134 + - ``reserved``\ [3] 135 135 136 136 - Reserved for future extensions. Drivers must set the array to 137 137 zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-enumstd.rst
··· 78 78 79 79 - __u8 80 80 81 - - ``name``\ \[24\] 81 + - ``name``\ [24] 82 82 83 83 - Name of the standard, a NUL-terminated ASCII string, for example: 84 84 "PAL-B/G", "NTSC Japan". This information is intended for the ··· 105 105 106 106 - __u32 107 107 108 - - ``reserved``\ \[4\] 108 + - ``reserved``\ [4] 109 109 110 110 - Reserved for future extensions. Drivers must set the array to 111 111 zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-expbuf.rst
··· 179 179 180 180 - __u32 181 181 182 - - ``reserved\[11\]`` 182 + - ``reserved[11]`` 183 183 184 184 - Reserved field for future use. Drivers and applications must set 185 185 the array to zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-g-audio.rst
··· 70 70 71 71 - __u8 72 72 73 - - ``name``\ \[32\] 73 + - ``name``\ [32] 74 74 75 75 - Name of the audio input, a NUL-terminated ASCII string, for 76 76 example: "Line In". This information is intended for the user, ··· 97 97 98 98 - __u32 99 99 100 - - ``reserved``\ \[2\] 100 + - ``reserved``\ [2] 101 101 102 102 - Reserved for future extensions. Drivers and applications must set 103 103 the array to zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-g-audioout.rst
··· 75 75 76 76 - __u8 77 77 78 - - ``name``\ \[32\] 78 + - ``name``\ [32] 79 79 80 80 - Name of the audio output, a NUL-terminated ASCII string, for 81 81 example: "Line Out". This information is intended for the user, ··· 103 103 104 104 - __u32 105 105 106 - - ``reserved``\ \[2\] 106 + - ``reserved``\ [2] 107 107 108 108 - Reserved for future extensions. Drivers and applications must set 109 109 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-g-dv-timings.rst
··· 259 259 - 260 260 - __u32 261 261 262 - - ``reserved``\ \[32\] 262 + - ``reserved``\ [32] 263 263 264 264 - 265 265
+1 -1
Documentation/media/uapi/v4l/vidioc-g-edid.rst
··· 131 131 132 132 - __u32 133 133 134 - - ``reserved``\ \[5\] 134 + - ``reserved``\ [5] 135 135 136 136 - Reserved for future extensions. Applications and drivers must set 137 137 the array to zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-g-enc-index.rst
··· 86 86 87 87 - __u32 88 88 89 - - ``reserved``\ \[4\] 89 + - ``reserved``\ [4] 90 90 91 91 - :cspan:`2` Reserved for future extensions. Drivers must set the 92 92 array to zero. ··· 153 153 154 154 - __u32 155 155 156 - - ``reserved``\ \[2\] 156 + - ``reserved``\ [2] 157 157 158 158 - Reserved for future extensions. Drivers must set the array to 159 159 zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-g-ext-ctrls.rst
··· 136 136 137 137 - __u32 138 138 139 - - ``reserved2``\ \[1\] 139 + - ``reserved2``\ [1] 140 140 141 141 - 142 142 - Reserved for future extensions. Drivers and applications must set ··· 338 338 339 339 - __u32 340 340 341 - - ``reserved``\ \[2\] 341 + - ``reserved``\ [2] 342 342 343 343 - Reserved for future extensions. Drivers and applications must set 344 344 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-g-fmt.rst
··· 171 171 - 172 172 - __u8 173 173 174 - - ``raw_data``\ \[200\] 174 + - ``raw_data``\ [200] 175 175 176 176 - Place holder for future extensions. 177 177
+1 -1
Documentation/media/uapi/v4l/vidioc-g-frequency.rst
··· 102 102 103 103 - __u32 104 104 105 - - ``reserved``\ \[8\] 105 + - ``reserved``\ [8] 106 106 107 107 - Reserved for future extensions. Drivers and applications must set 108 108 the array to zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst
··· 94 94 95 95 - char 96 96 97 - - ``APP_data``\ \[60\] 97 + - ``APP_data``\ [60] 98 98 99 99 - 100 100 ··· 110 110 111 111 - char 112 112 113 - - ``COM_data``\ \[60\] 113 + - ``COM_data``\ [60] 114 114 115 115 - 116 116
+2 -2
Documentation/media/uapi/v4l/vidioc-g-modulator.rst
··· 81 81 82 82 - __u8 83 83 84 - - ``name``\ \[32\] 84 + - ``name``\ [32] 85 85 86 86 - Name of the modulator, a NUL-terminated ASCII string. This 87 87 information is intended for the user. ··· 149 149 150 150 - __u32 151 151 152 - - ``reserved``\ \[3\] 152 + - ``reserved``\ [3] 153 153 154 154 - Reserved for future extensions. Drivers and applications must set 155 155 the array to zero.
+3 -3
Documentation/media/uapi/v4l/vidioc-g-parm.rst
··· 103 103 - 104 104 - __u8 105 105 106 - - ``raw_data``\ \[200\] 106 + - ``raw_data``\ [200] 107 107 108 108 - A place holder for future extensions. 109 109 ··· 183 183 184 184 - __u32 185 185 186 - - ``reserved``\ \[4\] 186 + - ``reserved``\ [4] 187 187 188 188 - Reserved for future extensions. Drivers and applications must set 189 189 the array to zero. ··· 271 271 272 272 - __u32 273 273 274 - - ``reserved``\ \[4\] 274 + - ``reserved``\ [4] 275 275 276 276 - Reserved for future extensions. Drivers and applications must set 277 277 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-g-selection.rst
··· 182 182 183 183 - __u32 184 184 185 - - ``reserved\[9\]`` 185 + - ``reserved[9]`` 186 186 187 187 - Reserved fields for future use. Drivers and applications must zero 188 188 this array.
+8 -8
Documentation/media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst
··· 65 65 66 66 - __u16 67 67 68 - - ``service_lines``\ \[2\]\[24\] 68 + - ``service_lines``\ [2][24] 69 69 70 70 - :cspan:`2` Each element of this array contains a set of data 71 71 services the hardware can look for or insert into a particular ··· 87 87 88 88 - 89 89 - 90 - - ``service_lines``\ \[0\]\[1\] 90 + - ``service_lines``\ [0][1] 91 91 92 92 - 1 93 93 ··· 97 97 98 98 - 99 99 - 100 - - ``service_lines``\ \[0\]\[23\] 100 + - ``service_lines``\ [0][23] 101 101 102 102 - 23 103 103 ··· 107 107 108 108 - 109 109 - 110 - - ``service_lines``\ \[1\]\[1\] 110 + - ``service_lines``\ [1][1] 111 111 112 112 - 264 113 113 ··· 117 117 118 118 - 119 119 - 120 - - ``service_lines``\ \[1\]\[23\] 120 + - ``service_lines``\ [1][23] 121 121 122 122 - 286 123 123 ··· 147 147 148 148 - 149 149 - 150 - - :cspan:`2` Drivers must set ``service_lines`` \[0\]\[0\] and 151 - ``service_lines``\ \[1\]\[0\] to zero. 150 + - :cspan:`2` Drivers must set ``service_lines`` [0][0] and 151 + ``service_lines``\ [1][0] to zero. 152 152 153 153 - .. row 12 154 154 ··· 164 164 165 165 - __u32 166 166 167 - - ``reserved``\ \[3\] 167 + - ``reserved``\ [3] 168 168 169 169 - :cspan:`2` This array is reserved for future extensions. 170 170 Applications and drivers must set it to zero.
+2 -2
Documentation/media/uapi/v4l/vidioc-g-tuner.rst
··· 79 79 80 80 - __u8 81 81 82 - - ``name``\ \[32\] 82 + - ``name``\ [32] 83 83 84 84 - :cspan:`1` 85 85 ··· 246 246 247 247 - __u32 248 248 249 - - ``reserved``\ \[4\] 249 + - ``reserved``\ [4] 250 250 251 251 - :cspan:`1` Reserved for future extensions. Drivers and 252 252 applications must set the array to zero.
+4 -4
Documentation/media/uapi/v4l/vidioc-querycap.rst
··· 53 53 54 54 - __u8 55 55 56 - - ``driver``\ \[16\] 56 + - ``driver``\ [16] 57 57 58 58 - Name of the driver, a unique NUL-terminated ASCII string. For 59 59 example: "bttv". Driver specific applications can use this ··· 69 69 70 70 - __u8 71 71 72 - - ``card``\ \[32\] 72 + - ``card``\ [32] 73 73 74 74 - Name of the device, a NUL-terminated UTF-8 string. For example: 75 75 "Yoyodyne TV/FM". One driver may support different brands or ··· 84 84 85 85 - __u8 86 86 87 - - ``bus_info``\ \[32\] 87 + - ``bus_info``\ [32] 88 88 89 89 - Location of the device in the system, a NUL-terminated ASCII 90 90 string. For example: "PCI:0000:05:06.0". This information is ··· 166 166 167 167 - __u32 168 168 169 - - ``reserved``\ \[3\] 169 + - ``reserved``\ [3] 170 170 171 171 - Reserved for future extensions. Drivers must set this array to 172 172 zero.
+6 -6
Documentation/media/uapi/v4l/vidioc-queryctrl.rst
··· 124 124 125 125 - __u8 126 126 127 - - ``name``\ \[32\] 127 + - ``name``\ [32] 128 128 129 129 - Name of the control, a NUL-terminated ASCII string. This 130 130 information is intended for the user. ··· 203 203 204 204 - __u32 205 205 206 - - ``reserved``\ \[2\] 206 + - ``reserved``\ [2] 207 207 208 208 - Reserved for future extensions. Drivers must set the array to 209 209 zero. ··· 245 245 246 246 - char 247 247 248 - - ``name``\ \[32\] 248 + - ``name``\ [32] 249 249 250 250 - Name of the control, a NUL-terminated ASCII string. This 251 251 information is intended for the user. ··· 326 326 - The size in bytes of a single element of the array. Given a char 327 327 pointer ``p`` to a 3-dimensional array you can find the position 328 328 of cell ``(z, y, x)`` as follows: 329 - ``p + ((z * dims\[1\] + y) * dims\[0\] + x) * elem_size``. 329 + ``p + ((z * dims[1] + y) * dims[0] + x) * elem_size``. 330 330 ``elem_size`` is always valid, also when the control isn't an 331 331 array. For string controls ``elem_size`` is equal to 332 332 ``maximum + 1``. ··· 363 363 364 364 - __u32 365 365 366 - - ``reserved``\ \[32\] 366 + - ``reserved``\ [32] 367 367 368 368 - Reserved for future extensions. Applications and drivers must set 369 369 the array to zero. ··· 410 410 - 411 411 - __u8 412 412 413 - - ``name``\ \[32\] 413 + - ``name``\ [32] 414 414 415 415 - Name of the menu item, a NUL-terminated ASCII string. This 416 416 information is intended for the user. This field is valid for
+1 -1
Documentation/media/uapi/v4l/vidioc-reqbufs.rst
··· 107 107 108 108 - __u32 109 109 110 - - ``reserved``\ \[2\] 110 + - ``reserved``\ [2] 111 111 112 112 - A place holder for future extensions. Drivers and applications 113 113 must set the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-s-hw-freq-seek.rst
··· 150 150 151 151 - __u32 152 152 153 - - ``reserved``\ \[5\] 153 + - ``reserved``\ [5] 154 154 155 155 - Reserved for future extensions. Applications must set the array to 156 156 zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-interval.rst
··· 132 132 133 133 - __u32 134 134 135 - - ``reserved``\ \[8\] 135 + - ``reserved``\ [8] 136 136 137 137 - Reserved for future extensions. Applications and drivers must set 138 138 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-size.rst
··· 142 142 143 143 - __u32 144 144 145 - - ``reserved``\ \[8\] 145 + - ``reserved``\ [8] 146 146 147 147 - Reserved for future extensions. Applications and drivers must set 148 148 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-subdev-enum-mbus-code.rst
··· 95 95 96 96 - __u32 97 97 98 - - ``reserved``\ \[8\] 98 + - ``reserved``\ [8] 99 99 100 100 - Reserved for future extensions. Applications and drivers must set 101 101 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-subdev-g-crop.rst
··· 109 109 110 110 - __u32 111 111 112 - - ``reserved``\ \[8\] 112 + - ``reserved``\ [8] 113 113 114 114 - Reserved for future extensions. Applications and drivers must set 115 115 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-subdev-g-fmt.rst
··· 113 113 114 114 - __u32 115 115 116 - - ``reserved``\ \[8\] 116 + - ``reserved``\ [8] 117 117 118 118 - Reserved for future extensions. Applications and drivers must set 119 119 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-subdev-g-frame-interval.rst
··· 95 95 96 96 - __u32 97 97 98 - - ``reserved``\ \[9\] 98 + - ``reserved``\ [9] 99 99 100 100 - Reserved for future extensions. Applications and drivers must set 101 101 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-subdev-g-selection.rst
··· 117 117 118 118 - __u32 119 119 120 - - ``reserved``\ \[8\] 120 + - ``reserved``\ [8] 121 121 122 122 - Reserved for future extensions. Applications and drivers must set 123 123 the array to zero.
+1 -1
Documentation/media/uapi/v4l/vidioc-subscribe-event.rst
··· 79 79 80 80 - __u32 81 81 82 - - ``reserved``\ \[5\] 82 + - ``reserved``\ [5] 83 83 84 84 - Reserved for future extensions. Drivers and applications must set 85 85 the array to zero.