linux-toradex.git/Documentation/driver-api/usb, branch master

docs: fix 're-use' -> 'reuse' in documentation

2026-02-02T16:54:15+00:00

Signed-off-by: Rhys Tumelty 
Acked-by: Randy Dunlap 
Signed-off-by: Jonathan Corbet 
Message-ID: <20260128220233.179439-1-rhys@tumelty.co.uk>

Documentation: use a source-read extension for the index link boilerplate

2026-01-23T18:59:34+00:00

The root document usually has a special :ref:`genindex` link to the
generated index. This is also the case for Documentation/index.rst. The
other index.rst files deeper in the directory hierarchy usually don't.

For SPHINXDIRS builds, the root document isn't Documentation/index.rst,
but some other index.rst in the hierarchy. Currently they have a
".. only::" block to add the index link when doing SPHINXDIRS html
builds.

This is obviously very tedious and repetitive. The link is also added to
all index.rst files in the hierarchy for SPHINXDIRS builds, not just the
root document.

Put the boilerplate in a sphinx-includes/subproject-index.rst file, and
include it at the end of the root document for subproject builds in an
ad-hoc source-read extension defined in conf.py.

For now, keep having the boilerplate in translations, because this
approach currently doesn't cover translated index link headers.

Cc: Jonathan Corbet 
Cc: Mauro Carvalho Chehab 
Cc: Randy Dunlap 
Signed-off-by: Jani Nikula 
Tested-by: Mauro Carvalho Chehab 
Reviewed-by: Mauro Carvalho Chehab 
[jc: did s/doctree/kern_doc_dir/ ]
Signed-off-by: Jonathan Corbet 
Message-ID: <20260123143149.2024303-1-jani.nikula@intel.com>

Documentation: treewide: Replace marc.info links with lore

2025-11-03T23:21:31+00:00

In the past, people would link to third-party mailing list archives
(like marc.info) for any kernel-related discussions. Now that there
is lore archive under kernel.org infrastructure, replace these marc
links

Note that the only remaining marc link is "Re: Memory mapping on Cirrus
EP9315" [1] since that thread is not available at lore [2].

[1]: https://marc.info/?l=linux-arm-kernel&m=110061245502000&w=2
[2]: https://lore.kernel.org/linux-arm-kernel/?q=b%3A%22Re%3A+Memory+mapping+on+Cirrus+EP9315%22

Signed-off-by: Bagas Sanjaya 
Acked-by: Randy Dunlap 
Reviewed-by: Lance Yang 
Acked-by: SeongJae Park 
Signed-off-by: Jonathan Corbet 
Message-ID: <20251031043358.23709-1-bagasdotme@gmail.com>

docs: driver-api: fix spelling of "buses".

2025-09-18T16:40:46+00:00

Replace incorrect plural form "busses" with "buses" in
multiple documentation files under "Documentation/driver-api".

Signed-off-by: Marneni PoornaChandu 
Signed-off-by: Jonathan Corbet 
Message-ID: <20250917220430.5815-1-Poornachandumarneni@gmail.com>

Documentation: driver-api: usb: Limit toctree depth

2025-08-21T17:49:44+00:00

toctree index in USB driver api docs currently spoils the entire docs
headings due to lack of :maxdepth: option. Add the option to limit
toctree depth to 1, mirroring usb subsystem docs in
Documentation/usb/index.rst.

Signed-off-by: Bagas Sanjaya 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/20250820050416.25219-1-bagasdotme@gmail.com

usb: core: Remove unused usb_unlink_anchored_urbs

2025-06-19T10:27:02+00:00

usb_unlink_anchored_urbs() has been unused since it's last use was
removed in 2009 by
commit 9b9c5aaeedfd ("ar9170: xmit code revamp")

Remove it.

Signed-off-by: "Dr. David Alan Gilbert" 
Acked-by: Randy Dunlap 
Link: https://lore.kernel.org/r/20250608235617.200731-1-linux@treblig.org
Signed-off-by: Greg Kroah-Hartman

Added usb_string function to a namespace

2025-04-14T16:35:44+00:00

with reference to WARNING:
Duplicate C declaration, also defined at driver-api/usb/gadget:804
There is a function usb_string in the file message.c,
there is also a struct usb_string in the kernel api headers.
The docs is unable to index the function as the index is occupied by struct
This fix adds messgae.c to the usb_core namespace (in docs) hence providing
usb_sting a unique index usb_core.usb_string()

Signed-off-by: Kevin Paul Reddy Janagari 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/20250405165116.147958-1-kevinpaul468@gmail.com

usb: musb: Constify struct musb_fifo_cfg

2025-02-03T15:29:53+00:00

'struct musb_fifo_cfg' are not modified in these drivers.

Constifying these structures moves some data to a read-only section, so
increase overall security.

On a x86_64, with allmodconfig, as an example:
Before:
======
   text	   data	    bss	    dec	    hex	filename
  64381	   5537	    202	  70120	  111e8	drivers/usb/musb/musb_core.o

After:
=====
   text	   data	    bss	    dec	    hex	filename
  64957	   4929	    202	  70088	  111c8	drivers/usb/musb/musb_core.o

Signed-off-by: Christophe JAILLET 
Link: https://lore.kernel.org/r/26e6f3e25dc8e785d0034dd7e59918e455563e60.1737234596.git.christophe.jaillet@wanadoo.fr
Signed-off-by: Greg Kroah-Hartman

writing_musb_glue_layer.rst: Fix broken URL

2024-07-09T15:12:25+00:00

The http://processors.wiki.ti.com EOL in january 2021

The old documentation is still available through the wayback machine.

Signed-off-by: Richard Genoud 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/20240618151938.1827064-1-richard.genoud@bootlin.com

Docs: typos/spelling

2024-05-02T16:02:29+00:00

Fix spelling and grammar in Docs descriptions

Signed-off-by: Remington Brasga 
Reviewed-by: Randy Dunlap 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/20240429225527.2329-1-rbrasga@uci.edu