[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