Bug 215738 - uri.7: CONFORMING TO: Refers to obsolete IETF RFC 2396
Summary: uri.7: CONFORMING TO: Refers to obsolete IETF RFC 2396
Status: NEW
Alias: None
Product: Documentation
Classification: Unclassified
Component: man-pages (show other bugs)
Hardware: All Linux
: P1 normal
Assignee: documentation_man-pages@kernel-bugs.osdl.org
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2022-03-24 12:04 UTC by Alejandro Colomar
Modified: 2022-05-14 15:02 UTC (History)
1 user (show)

See Also:
Kernel Version:
Subsystem:
Regression: No
Bisected commit-id:


Attachments
Suggested patch to update uri(7) man page. (482 bytes, patch)
2022-05-14 14:30 UTC, sowani
Details | Diff

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.

Note You need to log in before you can comment on or make changes to this bug.