Bug 215738

Summary: uri.7: CONFORMING TO: Refers to obsolete IETF RFC 2396
Product: Documentation Reporter: Alejandro Colomar (alx)
Component: man-pagesAssignee: documentation_man-pages (documentation_man-pages)
Status: NEW ---    
Severity: normal CC: sowani
Priority: P1    
Hardware: All   
OS: Linux   
Kernel Version: Subsystem:
Regression: No Bisected commit-id:
Attachments: Suggested patch to update uri(7) man page.

Description Alejandro Colomar 2022-03-24 12:04:59 UTC
[uri(7)::CONFORMING TO] reads as:

```
CONFORMING TO
       (IETF  RFC 2396)  <http://www.ietf.org/rfc/rfc2396.txt>,
       (HTML 4.0) <http://www.w3.org/TR/REC-html40>.
```

which refers to an obsolete RFC[1].  We better conform to a newer RFC :)


[1]: <https://www.rfc-editor.org/rfc/rfc2396>
Comment 1 Alejandro Colomar 2022-03-24 12:28:02 UTC
Should check the following RFCs that replace it:

2396:
  <https://www.rfc-editor.org/rfc/rfc3986>
    <https://www.rfc-editor.org/rfc/rfc6874> (updates 3986)
    <https://www.rfc-editor.org/rfc/rfc8820> (updates 3986)
Comment 2 sowani 2022-05-14 14:30:18 UTC
Created attachment 300956 [details]
Suggested patch to update uri(7) man page.

The "CONFORMING TO" section of uri(7) man page is updated with following changes:
1. reference to rfc2396 has been removed
2. references to rfc6874 and rfc8820 have been added.
Comment 3 Alejandro Colomar 2022-05-14 14:55:41 UTC
But does the manual page really conform to the newer RFCs?  The contents are quite large, and I don't know if some details of it are actually obsolete and should be fixed.
Comment 4 sowani 2022-05-14 15:02:28 UTC
(In reply to Alejandro Colomar (man-pages) from comment #3)
> But does the manual page really conform to the newer RFCs?  The contents are
> quite large, and I don't know if some details of it are actually obsolete
> and should be fixed.

Actually, it conforms more to rfc8820. So, IMHO, reference to rfc6874 can be removed. If this sounds okay, I will commit a new patch.