Mark "RCS" as an acronym and add a 'role' attribute wit its expansion

This may help a bit when people are not familiar with the specific
meaning of RCS we are alluding to in the dev handbook.

Triggered by:	A discussion with other doc-people
	  	and Walt Pawley, walt at wump.org.
This commit is contained in:
Giorgos Keramidas 2010-05-07 06:33:09 +00:00
parent 08c69888fd
commit 0402e26824
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=35715

View file

@ -131,7 +131,7 @@
key issue in the decisions.</para>
<note>
<para>Because of some unfortunate design limitations with the RCS file
<para>Because of some unfortunate design limitations with the <acronym role="Revision Control System">RCS</acronym> file
format and the use of vendor branches, minor, trivial and/or
cosmetic changes are <emphasis>strongly discouraged</emphasis> on
files that are still tracking the vendor branch. <quote>Spelling
@ -167,7 +167,7 @@
<para>The important thing here is that the
<filename>src/contrib/file</filename> directory is created according to
the rules: it is supposed to contain the sources as distributed (on a
proper vendor-branch and without RCS keyword expansion) with as few
proper vendor-branch and without <acronym>RCS</acronym> keyword expansion) with as few
FreeBSD-specific changes as possible. If there are any doubts on
how to go about it, it is imperative that you ask first and not blunder
ahead and hope it <quote>works out</quote>.</para>