The documentation update.

1 files changed, 55 insertions, 3 deletions

diff --git a/doc/bird.sgml b/doc/bird.sgml
index 8a8c2275..a00dbb74 100644
--- a/doc/bird.sgml
+++ b/doc/bird.sgml
@@ -1602,11 +1602,22 @@ protocol ospf <name> {
 	tick <num>;
 	ecmp <switch> [limit <num>];
 	area <id> {
+		stub <switch>;
+		nssa <switch>;
+		summary <switch>;
 		stub cost <num>;
+		translator <switch>;
+		translator stability <num>;
+
                 networks {
 			<prefix>;
 			<prefix> hidden;
 		}
+                external {
+			<prefix>;
+			<prefix> hidden;
+			<prefix> tag <num>;
+		}
 		stubnet <prefix>;
 		stubnet <prefix> {
 			hidden <switch>;
@@ -1683,15 +1694,56 @@ protocol ospf <name> {
 	 address, similarly to a router ID). The most important area is
 	 the backbone (ID 0) to which every other area must be connected.
 
+	<tag>stub <M>switch</M></tag>
+	 This option configures the area to be a stub area. External
+	 routes are not flooded into stub areas. Also summary LSAs can be
+	 limited in stub areas (see option <cf/summary/). Default
+	 value is no. (Area is not stub.)
+
+	<tag>nssa <M>switch</M></tag>
+	 This option configures the area to be a NSSA (Not-So-Stubby
+	 Area). NSSA is a variant of a stub area which allows a
+	 limited way of external route propagation. Global external
+	 routes are not propagated into a NSSA, but an external route
+	 can be imported into NSSA as a (area-wide) NSSA-LSA (and
+	 possibly translated and/or aggregated on area boundary).
+	 Default value is no. (Area is not NSSA.)
+
+	<tag>summary <M>switch</M></tag>
+	 This option controls propagation of summary LSAs into stub or
+	 NSSA areas. If enabled, summary LSAs are propagated as usual,
+	 otherwise just the default summary route (0.0.0.0/0) is
+	 propagated (this is sometimes called totally stubby area). If
+	 a stub area has more area boundary routers, propagating
+	 summary LSAs could lead to more efficient routing at the cost
+	 of larger link state database. Default value is no.
+
 	<tag>stub cost <M>num</M></tag>
-	 No external (except default) routes are flooded into stub areas.
-         Setting this value marks area stub with defined cost of default route.
-	 Default value is no. (Area is not stub.)
+	 This option controls the cost of a default route propagated to
+	 stub and NSSA areas. Default value is 1000.
+
+	<tag>translator <M>switch</M></tag>
+	 This option controls translation of NSSA-LSAs into external
+	 LSAs. By default, one translator per NSSA is automatically
+	 elected from area boundary routers. If enabled, this area
+	 boundary router would unconditionally translate all NSSA-LSAs
+	 regardless of translator election. Default value is no.
+
+	<tag>translator stability <M>num</M></tag>
+	 This option controls the translator stability interval (in
+	 seconds). When the new translator is elected, the old one
+	 keeps translating until the interval is over. Default value
+	 is 40.
 
 	<tag>networks { <m/set/ }</tag>
          Definition of area IP ranges. This is used in summary LSA origination.
 	 Hidden networks are not propagated into other areas.
 
+	<tag>external { <m/set/ }</tag>
+         Definition of external area IP ranges for NSSAs. This is used
+	 for NSSA-LSA translation. Hidden networks are not translated
+	 into external LSAs. Networks can have configured route tag.
+
 	<tag>stubnet <m/prefix/ { <m/options/ }</tag>
 	 Stub networks are networks that are not transit networks
 	 between OSPF routers. They are also propagated through an