xml2rfc icon indicating copy to clipboard operation
xml2rfc copied to clipboard

Ability to handle names that consist of a single letter

Open ajeanmahoney opened this issue 1 year ago • 4 comments

Description

An author has requested that her name not be displayed with a period after it in the RFC header. Her full name is "Q Misell". Currently xml2rfc places a period after her first name because it creates an initial from <author fullname="Q Misell" role="editor" surname="Misell">:

Current:

Automated Certificate Management Environment              Q. Misell, Ed.
Internet-Draft                                                  AS207960
Intended status: Standards Track                         14 January 2025
Expires: 18 July 2025

Requested:

Automated Certificate Management Environment               Q Misell, Ed.
Internet-Draft                                                  AS207960
Intended status: Standards Track                         14 January 2025
Expires: 18 July 2025

Something to consider, however, is what a code change to support this would do with author entries where a period is not provided in the initials attribute because xml2rfc adds them automatically.

Code of Conduct

ajeanmahoney avatar Jan 17 '25 23:01 ajeanmahoney

I didn't find any RFC specifying the author name format. The examples in RFC 7841 has the format: initial. surname. ^1

Another option with current xml2rfc, is to just display the surname. This can be done by adding initials="".

kesara avatar Jan 21 '25 01:01 kesara

I didn't find any RFC specifying the author name format.

That would be RFC 7322, Section 4.12. for "Author's Address" or "Authors' Addresses" Section, and Section 4.1.1 for the front page.

cabo avatar Jan 21 '25 09:01 cabo

Add this to the collection of evidence that we need to stop trying to disect names and treat them as blobs.

rjsparks avatar Jan 21 '25 14:01 rjsparks

Yup. Single letter first names aren't that unusual, e.g. former UN General Secretary U Thant

I know someone whose last name is O, no punctuation, just O

jrlevine avatar Jan 21 '25 15:01 jrlevine

Just a note that this issue affects RFC-to-be 9799, which just entered AUTH48 state.

mferguson-rpc avatar Jun 02 '25 20:06 mferguson-rpc

@mferguson-rpc, Is the workaround I mentioned in https://github.com/ietf-tools/xml2rfc/issues/1204#issuecomment-2603449999 acceptable for this RFC-to-be?

For example:

    <author fullname="Q Misell" initials="" role="editor" surname="Misell">

will generate:

Internet Engineering Task Force (IETF)                       Misell, Ed.

and

Author's Address

   Q Misell (editor)
   ...

kesara avatar Jun 02 '25 21:06 kesara

I have made a PR to fix this to my liking in #1246.

TheEnbyperor avatar Jun 04 '25 13:06 TheEnbyperor

Fixed with #1246

kesara avatar Jun 12 '25 00:06 kesara