[rfc-i] [xml2rfc] use of sourcecode type

John Levine johnl at taugh.com
Wed Jul 22 19:45:52 PDT 2020

In article <71455ac8-14b1-45a7-a27f-bdeb50ed1917 at www.fastmail.com> you write:
>In rust documentation, there is a flag for example code that says "this code is invalid".  That is
>separate from the (implied) type.
>I don't see it being necessary to fix the "this is invalid, but it is if you add it to this other
>thing".  But that might be fixed with an excerpt flag that says "this is an excerpt (from X?) and
>therefore not valid on its own".

If people can come up with a list of conventional code types, we can encourage people to use them.

>As for IANA maintaining a registry of types, sure.  I had no idea that this was a thing until the
>tls-syntax tag was added by the editor to one of my drafts.

Once again, no.  The RSE keeps a list of conventional artwork types, not IANA.  See RFC 7991, sec 2.5.7.


More information about the rfc-interest mailing list