Bug 268616 - mandoc.1 refers to legacy date format yyyy-dd-mm rather than yyyy-mm-dd
Summary: mandoc.1 refers to legacy date format yyyy-dd-mm rather than yyyy-mm-dd
Status: In Progress
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Alexander Ziaee
URL: https://www.freebsd.org/cgi/man.cgi?q...
Keywords:
Depends on:
Blocks:
 
Reported: 2022-12-28 17:50 UTC by Nick Briggs
Modified: 2025-03-23 06:31 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Nick Briggs 2022-12-28 17:50:44 UTC
In /usr/src/contrib/mandoc/mandoc.1 we find:

macro uses the legacy
.Xr man 7
date format
.Dq yyyy-dd-mm .
Consider using the conventional
.Xr mdoc 7
date format

when what it means to say is ... yyyy-mm-dd
(as parsed by a2time(&t, "%Y-%m-%d", in) mandoc.c)
Comment 2 Nick Briggs 2022-12-28 23:50:06 UTC
Yeah, there should be an upstream bug report, however you can't report things to their tech@... list unless you're a member.  I've subscribed, but will have to wait for an administrator to review it... then I'll send the report, then I'll unsubscribe.  What a terrible UX just to submit a simple report!
Comment 3 Alexander Ziaee freebsd_committer freebsd_triage 2025-02-28 18:02:56 UTC
Submitted upstream @ https://marc.info/?l=mandoc-tech&m=174076536405819&w=2
Comment 4 Alexander Ziaee freebsd_committer freebsd_triage 2025-03-03 14:37:37 UTC
The patch I sent upstream has been merged.
Comment 5 Ingo Schwarze 2025-03-03 14:59:59 UTC
Fixed in bsd.lv mandoc.1 1.270; i committed your patch unchanged.

Thank you for reporting!

I also added a paragraph to https://mandoc.bsd.lv/contact.html clarifyong that bug reports can be sent to the private contact address if the reporter does not want to subscribe to a list.

While the mandoc developers are easily able to deal with spam, we do not want to expose subscribers of our lists to spam, and we do not want to spend the considerable maintenance effort on our mailing list server that would be required to maintain a more sophisticated spam protection scheme.
Comment 6 Nick Briggs 2025-03-03 17:02:54 UTC
Thanks for following up on this.

Oddly, I never did get past the "Your request to join the list has been received. However, the gatekeepers are being asked to review it before permitting you to join." response from their list management (and I'm not a subscriber).

Glad to hear that they're willing to accept bug reports through other methods.
Comment 7 Nick Briggs 2025-03-03 17:03:05 UTC
Thanks for following up on this.

Oddly, I never did get past the "Your request to join the list has been received. However, the gatekeepers are being asked to review it before permitting you to join." response from their list management (and I'm not a subscriber).

Glad to hear that they're willing to accept bug reports through other methods.
Comment 8 Alexander Ziaee freebsd_committer freebsd_triage 2025-03-23 06:31:51 UTC
This fix has been merged to mandoc,