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

USB: remove usb DocBook warnings

This just removes some warnings generated by the Docbook tools when
turning USB (host and peripheral side) kerneldoc into HTML; they're
all about missing ID attributes.

Signed-off-by: David Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>


authored by

David Brownell and committed by
Greg Kroah-Hartman
741ec4e6 4149b72e

+15 -15
+1 -1
Documentation/DocBook/gadget.tmpl
··· 52 52 53 53 <toc></toc> 54 54 55 - <chapter><title>Introduction</title> 55 + <chapter id="intro"><title>Introduction</title> 56 56 57 57 <para>This document presents a Linux-USB "Gadget" 58 58 kernel mode
+14 -14
Documentation/DocBook/usb.tmpl
··· 185 185 186 186 </chapter> 187 187 188 - <chapter><title>USB-Standard Types</title> 188 + <chapter id="types"><title>USB-Standard Types</title> 189 189 190 190 <para>In <filename>&lt;linux/usb/ch9.h&gt;</filename> you will find 191 191 the USB data types defined in chapter 9 of the USB specification. ··· 197 197 198 198 </chapter> 199 199 200 - <chapter><title>Host-Side Data Types and Macros</title> 200 + <chapter id="hostside"><title>Host-Side Data Types and Macros</title> 201 201 202 202 <para>The host side API exposes several layers to drivers, some of 203 203 which are more necessary than others. ··· 211 211 212 212 </chapter> 213 213 214 - <chapter><title>USB Core APIs</title> 214 + <chapter id="usbcore"><title>USB Core APIs</title> 215 215 216 216 <para>There are two basic I/O models in the USB API. 217 217 The most elemental one is asynchronous: drivers submit requests ··· 248 248 !Edrivers/usb/core/hub.c 249 249 </chapter> 250 250 251 - <chapter><title>Host Controller APIs</title> 251 + <chapter id="hcd"><title>Host Controller APIs</title> 252 252 253 253 <para>These APIs are only for use by host controller drivers, 254 254 most of which implement standard register interfaces such as ··· 285 285 !Idrivers/usb/core/buffer.c 286 286 </chapter> 287 287 288 - <chapter> 288 + <chapter id="usbfs"> 289 289 <title>The USB Filesystem (usbfs)</title> 290 290 291 291 <para>This chapter presents the Linux <emphasis>usbfs</emphasis>. ··· 317 317 not it has a kernel driver. 318 318 </para> 319 319 320 - <sect1> 320 + <sect1 id="usbfs-files"> 321 321 <title>What files are in "usbfs"?</title> 322 322 323 323 <para>Conventionally mounted at ··· 356 356 357 357 </sect1> 358 358 359 - <sect1> 359 + <sect1 id="usbfs-fstab"> 360 360 <title>Mounting and Access Control</title> 361 361 362 362 <para>There are a number of mount options for usbfs, which will ··· 439 439 440 440 </sect1> 441 441 442 - <sect1> 442 + <sect1 id="usbfs-devices"> 443 443 <title>/proc/bus/usb/devices</title> 444 444 445 445 <para>This file is handy for status viewing tools in user ··· 473 473 </para> 474 474 </sect1> 475 475 476 - <sect1> 476 + <sect1 id="usbfs-bbbddd"> 477 477 <title>/proc/bus/usb/BBB/DDD</title> 478 478 479 479 <para>Use these files in one of these basic ways: ··· 510 510 </sect1> 511 511 512 512 513 - <sect1> 513 + <sect1 id="usbfs-lifecycle"> 514 514 <title>Life Cycle of User Mode Drivers</title> 515 515 516 516 <para>Such a driver first needs to find a device file ··· 565 565 566 566 </sect1> 567 567 568 - <sect1><title>The ioctl() Requests</title> 568 + <sect1 id="usbfs-ioctl"><title>The ioctl() Requests</title> 569 569 570 570 <para>To use these ioctls, you need to include the following 571 571 headers in your userspace program: ··· 604 604 </para> 605 605 606 606 607 - <sect2> 607 + <sect2 id="usbfs-mgmt"> 608 608 <title>Management/Status Requests</title> 609 609 610 610 <para>A number of usbfs requests don't deal very directly ··· 736 736 737 737 </sect2> 738 738 739 - <sect2> 739 + <sect2 id="usbfs-sync"> 740 740 <title>Synchronous I/O Support</title> 741 741 742 742 <para>Synchronous requests involve the kernel blocking ··· 865 865 </variablelist> 866 866 </sect2> 867 867 868 - <sect2> 868 + <sect2 id="usbfs-async"> 869 869 <title>Asynchronous I/O Support</title> 870 870 871 871 <para>As mentioned above, there are situations where it may be