[rfc-i] draft-iab-xml2rfc-02 - alignment of sourcecode
pkyzivat at alum.mit.edu (Paul Kyzivat) Fri, 05 February 2016 04:42 UTC
From: pkyzivat at alum.mit.edu (Paul Kyzivat)
Date: Thu, 4 Feb 2016 23:42:05 -0500
Subject: [rfc-i] draft-iab-xml2rfc-02 - alignment of sourcecode
In-Reply-To: <56B4009E.5000105@it.aoyama.ac.jp>
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>
Message-ID: <56B4281D.4030008@alum.mit.edu>
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. 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-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Kyzivat
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Hoffman
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Kyzivat
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Julian Reschke
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… HANSEN, TONY L
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Julian Reschke
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Hoffman
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Julian Reschke
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Kyzivat
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Joe Hildebrand jhildebr
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… HANSEN, TONY L
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Kyzivat
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Julian Reschke
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Hoffman
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Hoffman
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Kyzivat
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Joe Hildebrand jhildebr
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… HANSEN, TONY L
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Carsten Bormann
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Hoffman
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Kyzivat
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Martin J. Dürst
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Kyzivat
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Martin J. Dürst
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Joe Hildebrand jhildebr
- [rfc-i] draft-iab-xml2rfc-02 - alignment of sourc… Paul Kyzivat