Hello,

The link to the specification in the SEE ALSO section of the umb(4)
manpage returns an error 404 Not Found.

Grepping for 'usb.org' I've found 26 references:
1/ 6 links work by redirecting to a new location.
2/ 18 links aren't working (404) but a new link exist.
3/ 2 links aren't working (404) same "new URL" format than others doesn't work
and I couldn't manually find them searching the document library
  
It's pretty much just a matter of replacing
/developers/docs/devclass_docs/ with /sites/default/files/ in the URL.
With a few exceptions.

I would like to check if there would be a preferred way to proceed.
(Before sending any patch).

- Should we update those links?
- Should we only refer to the document name/version and people can go an
  search on whatever document library will be available in the future?  
For the couple missing I can try to contact them. (Otherwise there's
mirror available if that's acceptable).

I couldn't find previous conversation on tech@ in regards to maintaining
URL and external link.

More details below:

1/ "working" rdr:
src/lib/libusbhid/usbhid.3:.Lk http://www.usb.org/developers/docs/
  OK - rdr to https://www.usb.org/documents
src/share/man/man4/cdce.4:.%U http://www.usb.org/developers/docs/devclass_docs/
  OK - rdr to
  https://www.usb.org/documents?search=&type%5B0%5D=55&items_per_page=50
src/share/man/man4/upd.4:.Lk http://www.usb.org/developers/hidpage/
  OK - rdr to https://www.usb.org/hid
src/share/man/man4/usb.4:.Lk http://www.usb.org/developers/docs/
  OK - rdr to https://www.usb.org/documents
src/sys/dev/hid/hidmt.c: * a standard here, see (from www.usb.org)
  OK 
src/sys/dev/usb/usb.c: * http://www.usb.org/developers/docs/ and
  OK - rdr to https://www.usb.org/documents


2/ broken but could find the new valid link 
src/share/man/man4/umb.4:.%U 
http://www.usb.org/developers/docs/devclass_docs/MBIM10Errata1_073013.zip
  404 - should be:
  https://www.usb.org/sites/default/files/MBIM10Errata1_073013.zip
src/sys/dev/hid/hidkbd.c: * HID spec: 
http://www.usb.org/developers/devclass_docs/HID1_11.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/documents/hid1_11.pdf
src/sys/dev/hid/hidms.c: * HID spec: 
http://www.usb.org/developers/devclass_docs/HID1_11.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/documents/hid1_11.pdf
src/sys/dev/usb/mbim.h: * 
http://www.usb.org/developers/docs/devclass_docs/MBIM-Compliance-1.0.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/MBIM-Compliance-1.0.pdf
src/sys/dev/usb/if_umb.c: * 
http://www.usb.org/developers/docs/devclass_docs/MBIM10Errata1_073013.zip
  404 - should be
  https://www.usb.org/sites/default/files/MBIM10Errata1_073013.zip
src/sys/dev/usb/if_umb.c: * 
http://www.usb.org/developers/docs/devclass_docs/MBIM-Compliance-1.0.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/MBIM-Compliance-1.0.pdf
src/sys/dev/usb/if_umb.h: * 
http://www.usb.org/developers/docs/devclass_docs/MBIM-Compliance-1.0.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/MBIM-Compliance-1.0.pdf
src/sys/dev/usb/uhid.c: * HID spec: 
http://www.usb.org/developers/devclass_docs/HID1_11.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/documents/hid1_11.pdf
src/sys/dev/usb/uhidev.c: * HID spec: 
http://www.usb.org/developers/devclass_docs/HID1_11.pdf
  404 - should be:
  https://usb.org/sites/default/files/documents/hid1_11.pdf
src/sys/dev/usb/ukbd.c: * HID spec: 
http://www.usb.org/developers/devclass_docs/HID1_11.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/documents/hid1_11.pdf
src/sys/dev/usb/ulpt.c: *   
http://www.usb.org/developers/devclass_docs/usbprint11.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/usbprint11a021811.pdf  
src/sys/dev/usb/umodem.c: *                   
http://www.usb.org/developers/devclass_docs/usbcdc11.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/CDC1.2_WMC1.1_052013.zip
src/sys/dev/usb/ums.c: * HID spec: 
http://www.usb.org/developers/devclass_docs/HID1_11.pdf
  404 - should be
  https://www.usb.org/sites/default/files/documents/hid1_11.pdf
src/sys/dev/usb/usb.c: * http://www.usb.org/developers/devclass_docs/
  404 - should be:
  https://www.usb.org/documents?search=&type%5B0%5D=55&items_per_page=50
src/sys/dev/usb/umass.c: * 
http://www.usb.org/developers/devclass_docs/usbmass-ufi10.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/usbmass-ufi10.pdf
src/sys/dev/usb/umass.c: * 
http://www.usb.org/developers/devclass_docs/usbmassbulk_10.pdf
  404 - should be: 
  https://www.usb.org/sites/default/files/usbmassbulk_10.pdf
src/sys/dev/usb/umass.c: * 
http://www.usb.org/developers/devclass_docs/usb_msc_cbi_1.1.pdf
  404 - should be:
  https://www.usb.org/sites/default/files/usb_msc_cbi_1.1.pdf
src/sys/dev/usb/umodem.c: * Comm Class spec:  
http://www.usb.org/developers/devclass_docs/usbccs10.pdf
  404 - should be: https://www.usb.org/sites/default/files/usbccs10.pdf


3/ can't find those on usb.org 
src/sys/dev/usb/if_cdce.c: * 
http://www.usb.org/developers/devclass_docs/usbcdc11.pdf
  404 - can't find that exact same one searching the document library
  (replacing with sites/default/files/ doesn't work either)
src/sys/dev/usb/umass.c: * 
http://www.usb.org/developers/devclass_docs/usb_msc_overview_1.2.pdf
  404 - 

Cheers,
-- 
clematis (0xA2C87EDB507B4C53)

Reply via email to