diff mbox series

[1/2] docs: usb: remove some broken references

Message ID 00008303fde6b4e06d027d3b76ae7032614a7030.1580193653.git.mchehab+huawei@kernel.org (mailing list archive)
State New, archived
Headers show
Series [1/2] docs: usb: remove some broken references | expand

Commit Message

Mauro Carvalho Chehab Jan. 28, 2020, 6:41 a.m. UTC
It seems that some files were removed from USB documentation.

Update the links accordingly.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
---
 Documentation/usb/index.rst      | 2 --
 Documentation/usb/text_files.rst | 6 ------
 2 files changed, 8 deletions(-)

Comments

Jonathan Corbet Jan. 28, 2020, 8:42 p.m. UTC | #1
On Tue, 28 Jan 2020 07:41:00 +0100
Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:

> It seems that some files were removed from USB documentation.
> 
> Update the links accordingly.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

Applied, thanks.

jon
Randy Dunlap Jan. 28, 2020, 11:47 p.m. UTC | #2
On 1/28/20 12:42 PM, Jonathan Corbet wrote:
> On Tue, 28 Jan 2020 07:41:00 +0100
> Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> 
>> It seems that some files were removed from USB documentation.
>>
>> Update the links accordingly.
>>
>> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
> 
> Applied, thanks.
> 
> jon

This warning has been around for quite awhile now:

lnx-55/Documentation/usb/text_files.rst:22: WARNING: Include file u'lnx/lnx-55/Documentation/usb/wusb-cbaf' not found or reading it failed

Looks like it has been moved to drivers/staging/wusbcore/Documentation/wusb-cbaf.
Mauro Carvalho Chehab Jan. 29, 2020, 6:41 a.m. UTC | #3
Em Tue, 28 Jan 2020 15:47:18 -0800
Randy Dunlap <rdunlap@infradead.org> escreveu:

> On 1/28/20 12:42 PM, Jonathan Corbet wrote:
> > On Tue, 28 Jan 2020 07:41:00 +0100
> > Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> >   
> >> It seems that some files were removed from USB documentation.
> >>
> >> Update the links accordingly.
> >>
> >> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>  
> > 
> > Applied, thanks.
> > 
> > jon  
> 
> This warning has been around for quite awhile now:
> 
> lnx-55/Documentation/usb/text_files.rst:22: WARNING: Include file u'lnx/lnx-55/Documentation/usb/wusb-cbaf' not found or reading it failed
> 
> Looks like it has been moved to drivers/staging/wusbcore/Documentation/wusb-cbaf.

From the log of the patch that moved it:

  commit 71ed79b0e4be0db254640c3beb9a1a0316eb5f61
  Author: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
  Date:   Tue Aug 6 12:15:09 2019 +0200

    USB: Move wusbcore and UWB to staging as it is obsolete
    
    The UWB and wusbcore code is long obsolete, so let us just move the code
    out of the real part of the kernel and into the drivers/staging/
    location with plans to remove it entirely in a few releases.
    
    Link: https://lore.kernel.org/r/20190806101509.GA11280@kroah.com
    Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

The plan seems to remove it in the future.

In any case, it makes sense to remove the broken link from the 
documentation.

Cheers,
Mauro
Greg KH Jan. 29, 2020, 6:45 a.m. UTC | #4
On Wed, Jan 29, 2020 at 07:41:46AM +0100, Mauro Carvalho Chehab wrote:
> Em Tue, 28 Jan 2020 15:47:18 -0800
> Randy Dunlap <rdunlap@infradead.org> escreveu:
> 
> > On 1/28/20 12:42 PM, Jonathan Corbet wrote:
> > > On Tue, 28 Jan 2020 07:41:00 +0100
> > > Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> > >   
> > >> It seems that some files were removed from USB documentation.
> > >>
> > >> Update the links accordingly.
> > >>
> > >> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>  
> > > 
> > > Applied, thanks.
> > > 
> > > jon  
> > 
> > This warning has been around for quite awhile now:
> > 
> > lnx-55/Documentation/usb/text_files.rst:22: WARNING: Include file u'lnx/lnx-55/Documentation/usb/wusb-cbaf' not found or reading it failed
> > 
> > Looks like it has been moved to drivers/staging/wusbcore/Documentation/wusb-cbaf.
> 
> From the log of the patch that moved it:
> 
>   commit 71ed79b0e4be0db254640c3beb9a1a0316eb5f61
>   Author: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
>   Date:   Tue Aug 6 12:15:09 2019 +0200
> 
>     USB: Move wusbcore and UWB to staging as it is obsolete
>     
>     The UWB and wusbcore code is long obsolete, so let us just move the code
>     out of the real part of the kernel and into the drivers/staging/
>     location with plans to remove it entirely in a few releases.
>     
>     Link: https://lore.kernel.org/r/20190806101509.GA11280@kroah.com
>     Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
> 
> The plan seems to remove it in the future.
> 
> In any case, it makes sense to remove the broken link from the 
> documentation.

Yes, please just remove it, that code is about to go away in the
5.6-rc1.

thanks,

greg k-h
Greg KH Jan. 29, 2020, 9:18 a.m. UTC | #5
On Wed, Jan 29, 2020 at 07:45:35AM +0100, Greg Kroah-Hartman wrote:
> On Wed, Jan 29, 2020 at 07:41:46AM +0100, Mauro Carvalho Chehab wrote:
> > Em Tue, 28 Jan 2020 15:47:18 -0800
> > Randy Dunlap <rdunlap@infradead.org> escreveu:
> > 
> > > On 1/28/20 12:42 PM, Jonathan Corbet wrote:
> > > > On Tue, 28 Jan 2020 07:41:00 +0100
> > > > Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> > > >   
> > > >> It seems that some files were removed from USB documentation.
> > > >>
> > > >> Update the links accordingly.
> > > >>
> > > >> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>  
> > > > 
> > > > Applied, thanks.
> > > > 
> > > > jon  
> > > 
> > > This warning has been around for quite awhile now:
> > > 
> > > lnx-55/Documentation/usb/text_files.rst:22: WARNING: Include file u'lnx/lnx-55/Documentation/usb/wusb-cbaf' not found or reading it failed
> > > 
> > > Looks like it has been moved to drivers/staging/wusbcore/Documentation/wusb-cbaf.
> > 
> > From the log of the patch that moved it:
> > 
> >   commit 71ed79b0e4be0db254640c3beb9a1a0316eb5f61
> >   Author: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
> >   Date:   Tue Aug 6 12:15:09 2019 +0200
> > 
> >     USB: Move wusbcore and UWB to staging as it is obsolete
> >     
> >     The UWB and wusbcore code is long obsolete, so let us just move the code
> >     out of the real part of the kernel and into the drivers/staging/
> >     location with plans to remove it entirely in a few releases.
> >     
> >     Link: https://lore.kernel.org/r/20190806101509.GA11280@kroah.com
> >     Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
> > 
> > The plan seems to remove it in the future.
> > 
> > In any case, it makes sense to remove the broken link from the 
> > documentation.
> 
> Yes, please just remove it, that code is about to go away in the
> 5.6-rc1.

Oops, not yet, in 5.7-rc1.
diff mbox series

Patch

diff --git a/Documentation/usb/index.rst b/Documentation/usb/index.rst
index e55386a4abfb..36b6ebd9a9d9 100644
--- a/Documentation/usb/index.rst
+++ b/Documentation/usb/index.rst
@@ -22,11 +22,9 @@  USB support
     misc_usbsevseg
     mtouchusb
     ohci
-    rio
     usbip_protocol
     usbmon
     usb-serial
-    wusb-design-overview
 
     usb-help
     text_files
diff --git a/Documentation/usb/text_files.rst b/Documentation/usb/text_files.rst
index 6a8d3fcf64b6..1c18c05c3920 100644
--- a/Documentation/usb/text_files.rst
+++ b/Documentation/usb/text_files.rst
@@ -16,12 +16,6 @@  USB devfs drop permissions source
 .. literalinclude:: usbdevfs-drop-permissions.c
     :language: c
 
-WUSB command line script to manipulate auth credentials
--------------------------------------------------------
-
-.. literalinclude:: wusb-cbaf
-   :language: shell
-
 Credits
 -------