[rfc-i] draft-iab-xml2rfc-02 - alignment of sourcecode

duerst at it.aoyama.ac.jp ( Martin J. Dürst ) Fri, 05 February 2016 04:47 UTC

From: duerst at it.aoyama.ac.jp (=?UTF-8?Q?Martin_J._D=c3=bcrst?=)
Date: Fri, 5 Feb 2016 13:47:54 +0900
Subject: [rfc-i] draft-iab-xml2rfc-02 - alignment of sourcecode
In-Reply-To: <56B4281D.4030008@alum.mit.edu>
References: <56ABB36D.6030500@alum.mit.edu> <6A914091-5ADA-4B52-B622-BF76BCC9E6FA@vpnc.org> <56B0F23B.20106@alum.mit.edu> <6A1935EE-73F3-4F93-896B-EC86934E9863@vpnc.org> <56B12AEB.7080902@gmx.de> <3FD398C6-A52F-4742-A819-1413B7D63809@cisco.com> <7F501E45-8DBC-4E7A-B4AC-1F483150D5AB@att.com> <E083E5C7-85B6-4CB5-A6DF-D30128CE05EE@vpnc.org> <5A5CD370-0B7A-46F5-B0B3-13E43C85D797@att.com> <E3670443-FCDB-412E-BD6D-618484BF4537@vpnc.org> <56B4009E.5000105@it.aoyama.ac.jp> <56B4281D.4030008@alum.mit.edu>
Message-ID: <56B4297A.3050701@it.aoyama.ac.jp>


On 2016/02/05 13:42, Paul Kyzivat wrote:
> On 2/4/16 8:53 PM, Martin J. D?rst wrote:
>> On 2016/02/05 06:04, Paul Hoffman wrote:
>>> Thanks for the example! (PaulK, I assume that your ideas might match
>>> Tony's.) However, I disagree with the utility. See below.
>>
>> (actual code removed)
>>
>>>> In my mind, that indentation of the second block looks rather weird.
>>>
>>> And our minds definitely differ. If someone is reading the RFC and see
>>> the proper indentation, they would assume that the second block is at
>>> the same level as the first block. For my eyes, your example is exactly
>>> why we *don't* want to let authors move their <sourcecode> horizontally
>>> in the output.
>>
>> For the record, I'd tend to be with Paul on this one.
>
> You need to be more specific about your Pauls, since this discussion is
> Paul vs. Paul. From context I guess you mean you are with Paul H.

Yes, sorry, correct.

Regards,   Martin.

>      Thanks,
>      Paul K.
>
>> It may be
>> different if it's in a different section, and presented independently.
>> On the other hand, it might be better to tighten up the expository style
>> (separate text and source more), or to extract code blocks into
>> functions so that each piece can stand on its own.
>>
>> BTW, do we have the possibility to add line numbers to source code
>> blocks? That can often be very handy.
>>
>> Regards,   Martin.
>> _______________________________________________
>> rfc-interest mailing list
>> rfc-interest at rfc-editor.org
>> https://www.rfc-editor.org/mailman/listinfo/rfc-interest
>>
>
> _______________________________________________
> rfc-interest mailing list
> rfc-interest at rfc-editor.org
> https://www.rfc-editor.org/mailman/listinfo/rfc-interest
> .
>