Doc: Add tag for links to RFCs

doc/bird.sgml

@@ -73,8 +73,8 @@ running on background which does the dynamic part of Internet routing, that is
 it communicates with the other routers, calculates routing tables and sends them
 to the OS kernel which does the actual packet forwarding. There already exist
 other such routing daemons: routed (RIP only), GateD (non-free),
-Zebra <HTMLURL URL="http://www.zebra.org"> and
+<HTMLURL URL="http://www.zebra.org" name="Zebra"> and
-MRTD <HTMLURL URL="http://sourceforge.net/projects/mrt">,
+<HTMLURL URL="http://sourceforge.net/projects/mrt" name="MRTD">,
 but their capabilities are limited and they are relatively hard to configure
 and maintain.
 
@@ -485,9 +485,9 @@ protocol rip {
 	used to validate route origination of BGP routes. A ROA table contains
 	ROA entries, each consist of a network prefix, a max prefix length and
 	an AS number. A ROA entry specifies prefixes which could be originated
-	by that AS number. ROA tables could be filled with data from RPKI (RFC
+	by that AS number. ROA tables could be filled with data from RPKI (<rfc
-	6480) or from public databases like Whois. ROA tables are examined by
+	id="6480">) or from public databases like Whois. ROA tables are
-	<cf/roa_check()/ operator in filters.
+	examined by <cf/roa_check()/ operator in filters.
 
 	Currently, there is just one option, <cf>roa <m/prefix/ max <m/num/ as
 	<m/num/</cf>, which can be used to populate the ROA table with static
@@ -1270,9 +1270,9 @@ clist) or on clist and pair/quad set (returning true if there is an element of
 the clist that is also a member of the pair/quad set).
 
 <p>There is one operator related to ROA infrastructure - <cf/roa_check()/. It
-examines a ROA table and does RFC 6483 route origin validation for a given
+examines a ROA table and does <rfc id="6483"> route origin validation for a
-network prefix. The basic usage is <cf>roa_check(<m/table/)</cf>, which checks
+given network prefix. The basic usage is <cf>roa_check(<m/table/)</cf>, which
-current route (which should be from BGP to have AS_PATH argument) in the
+checks current route (which should be from BGP to have AS_PATH argument) in the
 specified ROA table and returns ROA_UNKNOWN if there is no relevant ROA,
 ROA_VALID if there is a matching ROA, or ROA_INVALID if there are some relevant
 ROAs but none of them match. There is also an extended variant
@@ -1434,11 +1434,12 @@ corresponding protocol sections.
 <sect1>Introduction
 <label id="babel-intro">
 
-<p>The Babel protocol (RFC6126) is a loop-avoiding distance-vector routing
+<p>The Babel protocol
-protocol that is robust and efficient both in ordinary wired networks and in
+(<rfc id="6126">) is a loop-avoiding distance-vector routing protocol that is
-wireless mesh networks. Babel is conceptually very simple in its operation and
+robust and efficient both in ordinary wired networks and in wireless mesh
-"just works" in its default configuration, though some configuration is possible
+networks. Babel is conceptually very simple in its operation and "just works"
-and in some cases desirable.
+in its default configuration, though some configuration is possible and in some
+cases desirable.
 
 <p>While the Babel protocol is dual stack (i.e., can carry both IPv4 and IPv6
 routes over the same IPv6 transport), BIRD presently implements only the IPv6
@@ -1580,14 +1581,10 @@ addresses and associated interfaces. When a session changes its state, these
 protocols are notified and act accordingly (e.g. break an OSPF adjacency when
 the BFD session went down).
 
-<p>BIRD implements basic BFD behavior as defined in
+<p>BIRD implements basic BFD behavior as defined in <rfc id="5880"> (some
-RFC 5880<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc5880.txt">
+advanced features like the echo mode or authentication are not implemented), IP
-(some advanced features like the echo mode or authentication are not implemented),
+transport for BFD as defined in <rfc id="5881"> and <rfc id="5883"> and
-IP transport for BFD as defined in
+interaction with client protocols as defined in <rfc id="5882">.
-RFC 5881<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc5881.txt"> and
-RFC 5883<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc5883.txt">
-and interaction with client protocols as defined in
-RFC 5882<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc5882.txt">.
 
 <p>Note that BFD implementation in BIRD is currently a new feature in
 development, expect some rough edges and possible UI and configuration changes
@@ -1764,31 +1761,16 @@ the packet will travel through if it uses the particular route) in order to
 avoid routing loops.
 
 <p>BIRD supports all requirements of the BGP4 standard as defined in
-RFC 4271<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc4271.txt">
+<rfc id="4271"> It also supports the community attributes (<rfc id="1997">),
-It also supports the community attributes
+capability negotiation (<rfc id="5492">), MD5 password authentication (<rfc
-(RFC 1997<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc1997.txt">),
+id="2385">), extended communities (<rfc id="4360">), route reflectors (<rfc
-capability negotiation
+id="4456">), graceful restart (<rfc id="4724">), multiprotocol extensions
-(RFC 5492<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc5492.txt">),
+(<rfc id="4760">), 4B AS numbers (<rfc id="4893">), and 4B AS numbers in
-MD5 password authentication
+extended communities (<rfc id="5668">).
-(RFC 2385<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc2385.txt">),
-extended communities
-(RFC 4360<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc4360.txt">),
-route reflectors
-(RFC 4456<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc4456.txt">),
-graceful restart
-(RFC 4724<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc4724.txt">),
-multiprotocol extensions
-(RFC 4760<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc4760.txt">),
-4B AS numbers
-(RFC 4893<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc4893.txt">),
-and 4B AS numbers in extended communities
-(RFC 5668<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc5668.txt">).
 
 
 For IPv6, it uses the standard multiprotocol extensions defined in
-RFC 4760<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc4760.txt">
+<rfc id="4760"> and applied to IPv6 according to <rfc id="2545">.
-and applied to IPv6 according to
-RFC 2545<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc2545.txt">.
 
 <sect1>Route selection rules
 <label id="bgp-route-select-rules">
@@ -1938,20 +1920,20 @@ using the following configuration parameters:
 	<ref id="bfd" name="BFD"> section for details. Default: disabled.
 
 	<tag><label id="bgp-ttl-security">ttl security <m/switch/</tag>
-	Use GTSM (RFC 5082 - the generalized TTL security mechanism). GTSM
+	Use GTSM (<rfc id="5082"> - the generalized TTL security mechanism). GTSM
-	protects against spoofed packets by ignoring doc/bird.sgmlreceived packets with a
+	protects against spoofed packets by ignoring received packets with a
 	smaller than expected TTL. To work properly, GTSM have to be enabled on
-	both sides of a BGP session. If both <cf/ttl security/ and <cf/multihop/
+	both sides of a BGP session. If both <cf/ttl security/ and
-	options are enabled, <cf/multihop/ option should specify proper hop
+	<cf/multihop/ options are enabled, <cf/multihop/ option should specify
-	value to compute expected TTL. Kernel support required: Linux: 2.6.34+
+	proper hop value to compute expected TTL. Kernel support required:
-	(IPv4), 2.6.35+ (IPv6), BSD: since long ago, IPv4 only. Note that full
+	Linux: 2.6.34+ (IPv4), 2.6.35+ (IPv6), BSD: since long ago, IPv4 only.
-	(ICMP protection, for example) RFC 5082 support is provided by Linux
+	Note that full (ICMP protection, for example) <rfc id="5082"> support is
-	only. Default: disabled.
+	provided by Linux only. Default: disabled.
 
 	<tag><label id="bgp-pass">password <m/string/</tag>
-	Use this password for MD5 authentication of BGP sessions (RFC 2385).
+	Use this password for MD5 authentication of BGP sessions (<rfc id="2385">). When
-	When used on BSD systems, see also <cf/setkey/ option below. Default:
+	used on BSD systems, see also <cf/setkey/ option below. Default: no
-	no authentication.
+	authentication.
 
 	<tag><label id="bgp-setkey">setkey <m/switch/</tag>
 	On BSD systems, keys for TCP MD5 authentication are stored in the global
@@ -1966,7 +1948,7 @@ using the following configuration parameters:
 
 	<tag><label id="bgp-passive">passive <m/switch/</tag>
 	Standard BGP behavior is both initiating outgoing connections and
-	accepting incoming connections. In passive modoc/bird.sgmlde, outgoing connections
+	accepting incoming connections. In passive mode, outgoing connections
 	are not initiated. Default: off.
 
 	<tag><label id="bgp-rr-client">rr client</tag>
@@ -1985,11 +1967,11 @@ using the following configuration parameters:
 	Be a route server and treat the neighbor as a route server client.
 	A route server is used as a replacement for full mesh EBGP routing in
 	Internet exchange points in a similar way to route reflectors used in
-	IBGP routing. BIRD does not implement obsoleted RFC 1863, but uses
+	IBGP routing. BIRD does not implement obsoleted <rfc id="1863">, but
-	ad-hoc implementation, which behaves like plain EBGP but reduces
+	uses ad-hoc implementation, which behaves like plain EBGP but reduces
 	modifications to advertised route attributes to be transparent (for
-	example does not prepend its AS number to AS PATH attribute and keeps
+	example does not prepend its AS number to AS PATH attribute and
-	MED attribute). Default: disabled.
+	keeps MED attribute). Default: disabled.
 
 	<tag><label id="bgp-secondary">secondary <m/switch/</tag>
 	Usually, if an export filter rejects a selected route, no other route is
@@ -2023,27 +2005,28 @@ using the following configuration parameters:
 	to keep BGP speakers synchronized. Sometimes (e.g., if BGP speaker
 	changes its import filter, or if there is suspicion of inconsistency) it
 	is necessary to do a new complete route exchange. BGP protocol extension
-	Route Refresh (RFC 2918) allows BGP speaker to request re-advertisement
+	Route Refresh (<rfc id="2918">) allows BGP speaker to request
-	of all routes from its neighbor. BGP protocol extension Enhanced Route
+	re-advertisement of all routes from its neighbor. BGP protocol
-	Refresh (RFC 7313) specifies explicit begin and end for such exchanges,
+	extension Enhanced Route Refresh (<rfc id="7313">) specifies explicit
-	therefore the receiver can remove stale routes that were not advertised
+	begin and end for such exchanges, therefore the receiver can remove
-	during the exchange. This option specifies whether BIRD advertises these
+	stale routes that were not advertised during the exchange. This option
-	capabilities and supports related procedures. Note that even when
+	specifies whether BIRD advertises these capabilities and supports
-	disabled, BIRD can send route refresh requests. Default: on.
+	related procedures. Note that even when disabled, BIRD can send route
+	refresh requests.  Default: on.
 
 	<tag><label id="bgp-graceful-restart">graceful restart <m/switch/|aware</tag>
 	When a BGP speaker restarts or crashes, neighbors will discard all
 	received paths from the speaker, which disrupts packet forwarding even
-	when the forwarding plane of the speaker remains intact. RFC 4724
+	when the forwarding plane of the speaker remains intact. <rfc
-	specifies an optional graceful restart mechanism to alleviate this
+	id="4724"> specifies an optional graceful restart mechanism to
-	issue. This option controls the mechanism. It has three states:
+	alleviate this issue. This option controls the mechanism. It has three
-	Disabled, when no support is provided. Aware, when the graceful restart
+	states: Disabled, when no support is provided. Aware, when the graceful
-	support is announced and the support for restarting neighbors is
+	restart support is announced and the support for restarting neighbors
-	provided, but no local graceful restart is allowed (i.e. receiving-only
+	is provided, but no local graceful restart is allowed (i.e.
-	role). Enabled, when the full graceful restart support is provided
+	receiving-only role). Enabled, when the full graceful restart
-	(i.e. both restarting and receiving role). Note that proper support for
+	support is provided (i.e. both restarting and receiving role). Note
-	local graceful restart requires also configuration of other protocols.
+	that proper support for local graceful restart requires also
-	Default: aware.
+	configuration of other protocols.  Default: aware.
 
 	<tag><label id="bgp-graceful-restart-time">graceful restart time <m/number/</tag>
 	The restart time is announced in the BGP graceful restart capability
@@ -2052,15 +2035,15 @@ using the following configuration parameters:
 	120 seconds.
 
 	<tag><label id="bgp-interpret-communities">interpret communities <m/switch/</tag>
-	RFC 1997 demands that BGP speaker should process well-known communities
+	<rfc id="1997"> demands that BGP speaker should process well-known
-	like no-export (65535, 65281) or no-advertise (65535, 65282). For
+	communities like no-export (65535, 65281) or no-advertise (65535,
-	example, received route carrying a no-adverise community should not be
+	65282). For example, received route carrying a no-adverise community
-	advertised to any of its neighbors. If this option is enabled (which is
+	should not be advertised to any of its neighbors. If this option is
-	by default), BIRD has such behavior automatically (it is evaluated when
+	enabled (which is by default), BIRD has such behavior automatically (it
-	a route is exported to the BGP protocol just before the export filter).
+	is evaluated when a route is exported to the BGP protocol just before
-	Otherwise, this integrated processing of well-known communities is
+	the export filter).  Otherwise, this integrated processing of
-	disabled. In that case, similar behavior can be implemented in the
+	well-known communities is disabled. In that case, similar behavior can
-	export filter. Default: on.
+	be implemented in the export filter.  Default: on.
 
 	<tag><label id="bgp-enable-as4">enable as4 <m/switch/</tag>
 	BGP protocol was designed to use 2B AS numbers and was extended later to
@@ -2085,17 +2068,17 @@ using the following configuration parameters:
 
 	<tag><label id="bgp-advertise-ipv4">advertise ipv4 <m/switch/</tag>
 	Advertise IPv4 multiprotocol capability. This is not a correct behavior
-	according to the strict interpretation of RFC 4760, but it is widespread
+	according to the strict interpretation of <rfc id="4760">, but it is
-	and required by some BGP implementations (Cisco and Quagga). This option
+	widespread and required by some BGP implementations (Cisco and Quagga).
-	is relevant to IPv4 mode with enabled capability advertisement
+	This option is relevant to IPv4 mode with enabled capability
-	only. Default: on.
+	advertisement only. Default: on.
 
 	<tag><label id="bgp-route-limit">route limit <m/number/</tag>
 	The maximal number of routes that may be imported from the protocol. If
 	the route limit is exceeded, the connection is closed with an error.
 	Limit is currently implemented as <cf>import limit <m/number/ action
 	restart</cf>. This option is obsolete and it is replaced by
-	<ref id="proto-import-limit" name="import limit option">. Default: no	limit.
+	<ref id="proto-import-limit" name="import limit option">. Default: no limit.
 
 	<tag><label id="bgp-disable-after-error">disable after error <m/switch/</tag>
 	When an error is encountered (either locally or by the other side),
@@ -2152,16 +2135,16 @@ using the following configuration parameters:
 	BGP route selection algorithm is often viewed as a comparison between
 	individual routes (e.g. if a new route appears and is better than the
 	current best one, it is chosen as the new best one). But the proper
-	route selection, as specified by RFC 4271, cannot be fully implemented
+	route selection, as specified by <rfc id="4271">, cannot be fully
-	in that way. The problem is mainly in handling the MED attribute. BIRD,
+	implemented in that way. The problem is mainly in handling the MED
-	by default, uses an simplification based on individual route comparison,
+	attribute. BIRD, by default, uses an simplification based on individual
-	which in some cases may lead to temporally dependent behavior (i.e. the
+	route comparison, which in some cases may lead to temporally dependent
-	selection is dependent on the order in which routes appeared). This
+	behavior (i.e. the selection is dependent on the order in which routes
-	option enables a different (and slower) algorithm implementing proper
+	appeared). This option enables a different (and slower) algorithm
-	RFC 4271 route selection, which is deterministic. Alternative way how to
+	implementing proper <rfc id="4271"> route selection, which is
-	get deterministic behavior is to use <cf/med metric/ option. This option
+	deterministic. Alternative way how to get deterministic behavior is to
-	is incompatible with <ref id="dsc-table-sorted" name="sorted tables">.
+	use <cf/med metric/ option. This option is incompatible with <ref
-	Default: off.
+	id="dsc-table-sorted" name="sorted tables">.  Default: off.
 
 	<tag><label id="bgp-igp-metric">igp metric <m/switch/</tag>
 	Enable comparison of internal distances to boundary routers during best
@@ -2170,7 +2153,7 @@ using the following configuration parameters:
 	<tag><label id="bgp-prefer-older">prefer older <m/switch/</tag>
 	Standard route selection algorithm breaks ties by comparing router IDs.
 	This changes the behavior to prefer older routes (when both are external
-	and from different peer). For details, see RFC 5004. Default: off.
+	and from different peer). For details, see <rfc id="5004">. Default: off.
 
 	<tag><label id="bgp-default-med">default bgp_med <m/number/</tag>
 	Value of the Multiple Exit Discriminator to be used during route
@@ -2210,8 +2193,8 @@ some of them (marked with `<tt/O/') are optional.
 	when a route is exported to an external BGP instance to ensure that the
 	attribute received from a neighboring AS is not propagated to other
 	neighboring ASes. A new value might be set in the export filter of an
-	external BGP instance. See RFC 4451<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc4451.txt">
+	external BGP instance. See <rfc id="4451"> for further discussion of
-	for further discussion of BGP MED attribute.
+	BGP MED attribute.
 
 	<tag><label id="rta-bgp-origin">enum bgp_origin/</tag>
 	Origin of the route: either <cf/ORIGIN_IGP/ if the route has originated
@@ -2580,15 +2563,13 @@ protocol kernel {		# Secondary routing table
 <label id="ospf-intro">
 
 <p>Open Shortest Path First (OSPF) is a quite complex interior gateway
-protocol. The current IPv4 version (OSPFv2) is defined in RFC 2328
+protocol. The current IPv4 version (OSPFv2) is defined in <rfc id="2328"> and
-<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc2328.txt">
+the current IPv6 version (OSPFv3) is defined in <rfc id="5340"> It's a link
-and the current IPv6 version (OSPFv3) is defined in RFC 5340
+state (a.k.a. shortest path first) protocol -- each router maintains a database
-<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc5340.txt">
+describing the autonomous system's topology. Each participating router has an
-It's a link state (a.k.a. shortest path first) protocol -- each router maintains
+identical copy of the database and all routers run the same algorithm
-a database describing the autonomous system's topology. Each participating
+calculating a shortest path tree with themselves as a root. OSPF chooses the
-router has an identical copy of the database and all routers run the same
+least cost path as the best path.
-algorithm calculating a shortest path tree with themselves as a root. OSPF
-chooses the least cost path as the best path.
 
 <p>In OSPF, the autonomous system can be split to several areas in order to
 reduce the amount of resources consumed for exchanging the routing information
@@ -2708,8 +2689,7 @@ protocol ospf &lt;name&gt; {
 <descrip>
 	<tag><label id="ospf-rfc1583compat">rfc1583compat <M>switch</M></tag>
 	This option controls compatibility of routing table calculation with
-	RFC 1583 <htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc1583.txt">.
+	<rfc id="1583">. Default value is no.
-	Default	value is no.
 
 	<tag><label id="ospf-instance-id">instance id <m/num/</tag>
 	When multiple OSPF protocol instances are active on the same links, they
@@ -2726,9 +2706,8 @@ protocol ospf &lt;name&gt; {
 	that participates in the OSPF topology but does not allow transit
 	traffic. In OSPFv2, this is implemented by advertising maximum metric
 	for outgoing links. In OSPFv3, the stub router behavior is announced by
-	clearing the R-bit in the router LSA. See RFC 6987
+	clearing the R-bit in the router LSA. See <rfc id="6987"> for details.
-	<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc6987.txt"> for
+	Default value is no.
-	details. Default value is no.
 
 	<tag><label id="ospf-tick">tick <M>num</M></tag>
 	The routing table calculation and clean-up of areas' databases is not
@@ -2839,10 +2818,9 @@ protocol ospf &lt;name&gt; {
 
 	You can specify alternative instance ID for the interface definition,
 	therefore it is possible to have several instances of that interface
-	with different options or even in different areas. For OSPFv2,
+	with different options or even in different areas. For OSPFv2, instance
-	instance ID support is an extension (RFC 6549
+	ID support is an extension (<rfc id="6549">) and is supposed to be set
-	<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc6549.txt">) and is
+	per-protocol. For OSPFv3, it is an integral feature.
-	supposed to be set per-protocol. For OSPFv3, it is an integral feature.
 
 	<tag><label id="ospf-virtual-link">virtual link <M>id</M> [instance <m/num/]</tag>
 	Virtual link to router with the router id. Virtual link acts as a
@@ -3266,9 +3244,7 @@ time intervals or as an answer to a request) advertisement packets to connected
 networks. These packets contain basic information about a local network (e.g. a
 list of network prefixes), which allows network hosts to autoconfigure network
 addresses and choose a default route. BIRD implements router behavior as defined
-in RFC 4861<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc4861.txt">
+in <rfc id="4861"> and also the DNS extensions from <rfc id="6106">.
-and also the DNS extensions from
-RFC 6106<htmlurl url="ftp://ftp.rfc-editor.org/in-notes/rfc6106.txt">.
 
 <sect1>Configuration
 <label id="radv-config">
@@ -3523,12 +3499,9 @@ counting to infinity is necessary, because it is slow. Due to infinity being 16,
 you can't use RIP on networks where maximal distance is higher than 15
 hosts.
 
-<p>BIRD supports RIPv1
+<p>BIRD supports RIPv1 (<rfc id="1058">), RIPv2 (<rfc id="2453">), RIPng (<rfc
-(RFC 1058<htmlurl url="http://www.rfc-editor.org/rfc/rfc1058.txt">),
+id="2080">), and RIP cryptographic authentication (SHA-1 not implemented)
-RIPv2 (RFC 2453<htmlurl url="http://www.rfc-editor.org/rfc/rfc2453.txt">),
+(<rfc id="4822">).
-RIPng (RFC 2080<htmlurl url="http://www.rfc-editor.org/rfc/rfc2080.txt">),
-and RIP cryptographic authentication (SHA-1 not implemented)
-(RFC 4822<htmlurl url="http://www.rfc-editor.org/rfc/rfc4822.txt">).
 
 <p>RIP is a very simple protocol, and it has a lot of shortcomings. Slow
 convergence, big network load and inability to handle larger networks makes it
@@ -3707,8 +3680,9 @@ protocol rip [&lt;name&gt;] {
 	compatibility with neighbors regardless of whether they use ttl
 	security.
 
-	For RIPng, TTL security is a standard behavior (required by RFC 2080)
+	For RIPng, TTL security is a standard behavior (required by <rfc
-	and therefore default value is yes. For IPv4 RIP, default value is no.
+	id="2080">) and therefore default value is yes. For IPv4 RIP, default
+	value is no.
 
 	<tag><label id="rip-iface-tx-class">tx class|dscp|priority <m/number/</tag>
 	These options specify the ToS/DiffServ/Traffic class/Priority of the

doc/sbase/dist/birddoc/html/mapping

@@ -205,6 +205,10 @@
 <htmlurl>		"<A HREF=\"[URL]\">[NAME]</A>"
 </htmlurl>
 
+<rfc>			"<A HREF=\"http://www.rfc-editor.org/info/rfc[ID]\">RFC [ID]</A>"
+</rfc>
+
+
 % ref modified to have an optional name field
 <ref>		+	"<@@ref>[ID]\n"
 			"[NAME]</A>\n"

doc/sbase/dist/birddoc/latex2e/mapping

@@ -238,6 +238,9 @@
 <htmlurl>		"\\href{[URL]}{[NAME]}"
 </htmlurl>
 
+<rfc>			"\\href{http://www.rfc-editor.org/info/rfc[ID]}{RFC [ID]}"
+</rfc>
+
 <x>
 </x>
 

doc/sbase/dtd/birddoc.dtd

@@ -99,7 +99,7 @@ anywhere else. <pavel@ucw.cz>
 
 <!-- url added by HG; htmlurl added by esr -->
 <!entity % xref
-	" label|ref|pageref|cite|url|htmlurl|ncite " >
+	" label|ref|pageref|cite|url|htmlurl|rfc|ncite " >
 
 <!entity % inline
 	" (#pcdata | f| x| %emph; |sq| %xref | %index | file )* " >
@@ -501,6 +501,10 @@ anywhere else. <pavel@ucw.cz>
         url cdata #required
         name cdata "&urlnam" >
 
+<!element rfc - o empty>
+<!attlist rfc
+        id cdata #required>
+
 <!element pageref - o empty>
 <!attlist pageref
         id cdata #required>