[svnbook] r3674 committed - * en/book/ch02-basic-usage.xml:...

C. Michael Pilato cmpilato at red-bean.com
Wed Feb 10 07:31:27 CST 2010

Dongsheng Song wrote:
> On Sun, Feb 7, 2010 at 14:00, C. Michael Pilato <cmpilato at red-bean.com> wrote:
>> C. Michael Pilato wrote:
>>> Julian Foad wrote:
>>>>> @@ -1306,7 +1306,7 @@
>>>>>             automatically.</para>
>>>>>           <para>The <computeroutput>C</computeroutput> stands for
>>>>> -          <computeroutput>c</computeroutput>onflict.  This means that
>>>>> +          conflict.  This means that
>>>> Hi songdongsheng.
>>>> That <computeroutput> tag was intentional, and is used in the same way
>>>> in several other places in that chapter. It is intended to emphasize
>>>> that the first letter of the word matches the "C" that svn prints. (In
>>>> some cases it matches a letter that isn't the first, such as G matching
>>>> "mer[g]ed".)
>>> Actually, I agree with the change, and only wish that similar changes had
>>> been made elsewhere in the chapter.  We shouldn't be abusing a content
>>> markup language just to produce a particular stylistic rendering.
>>> I'll commit a follow-up that restores consistency.
>> Done in r3683.
> Thanks.
> If we really want to emphasize something, I think we should use
> <emphasis>, not <computeroutput> or any other tag.
> http://www.docbook.org/tdg/en/html/emphasis.html

Sure.  Each tag has its place.  <computeroutput> makes sense when referring
to, you know, computer output (such as when referring to the codes that 'svn
status' prints).  <emphasis> is for emphasizing (the voice, not the page decor).

C. Michael Pilato <cmpilato at red-bean.com> | http://cmpilato.blogspot.com/

More information about the svnbook-dev mailing list