o Add entities to be used either instead of controversial words or

for easier maintainance. Moreover, the use of entities helps
  normalize (a uniform) the translation process. File begins with
  single word 'handbook'. Every jorney begins with a first step.

Reviewed by:		blackend, keramida,
			phantom (in principle)
Approved by:		phantom (mentor)
Obtained from:		The FreeBSD Brazilian Portuguese Documentation Project
Original revision:	not applicable (file exclusive for translation effort)

pt_BR.ISO8859-1/share/sgml/words.ent

@@ -0,0 +1,24 @@
+<!--
+     Words that were deemed too controversial.  Which, therefore,
+     would require several futher revisions.  Moreover, the use of
+     entities helps normalize (a uniform) the translation process.
+
+     Use these entities instead of direct translations whenever
+     possible.
+
+     IMPORTANT:  If you delete words from this file you *must* ensure that
+                 all references to them have been removed from the handbook's
+                 translations.  If they haven't then you *will* break the
+                 builds for the other languages, and we will poke fun of you
+                 in public.
+
+     The FreeBSD Documentation Project
+     The FreeBSD Brazilian Portuguese Documentation Project
+
+     Palavras em que houve muita controversia quanto a traducao ou
+     de manutencao mais facil via entidades.
+
+     $FreeBSD$
+-->
+
+<!ENTITY a.ptbr.p.handbook "Manual do FreeBSD">