Re: [netmod] Last Call: <draft-ietf-netmod-artwork-folding-07.txt> (Handling Long Lines in Inclusions in Internet-Drafts and RFCs) to Best Current Practice

[Paul Kyzivat <[e-mail]>]

Kent,

On 7/31/19 3:41 PM, Kent Watsen wrote:
> Hi Paul,
> 
> Thanks for your comments!
> 
> 
>> 1) Section 6.2 recommends only using double backslash folding if 
>> single backslash folding doesn't work. But all the examples in section 
>> 9 violate this.
> 
> True, but these example illustrate the algorithm itself, and so seem 
> okay, or is your suggestion to add text stating this?

My suggestion is to use an example that would force the use of double 
backslash folding. This would mean that the the examples wouldn't be for 
the same text, but I don't think that is a problem. This would allow you 
to show the various forms that force use of double backslash folding.

> FWIW, the `rfcfold` script in the appendix of the draft was used on all 
> the examples in Section 9.  By default, the `rfcfold` script follows the 
> recommendation (i.e., single before double), but also accepts a 
> command-line option to specify the folding strategy to use.  For the 
> examples in section 9, this command-line option  was used.
> 
> 
>> 2) Regarding forced folding in section 8.2.1: step 1 (Determine where 
>> the fold will occur) could benefit from some elaboration regarding 
>> lines that require forced folding. In particular, when an input line 
>> flagged for forced folding ends in backslash, then it must indeed be 
>> folded before the last character, while in all other cases it can be 
>> folded at any position prior to the max line length. (While this is 
>> obvious if you think about it, some might miss this.)
> 
> Your comment goes to step 1, are you suggesting a modification such as 
> the following?
> 
> OLD
>      1. Determine where the fold will occur. This location MUST be 
> before or at the desired maximum column.
> 
> NEW
>      1. Determine where the fold will occur. This location MUST be 
> before or at the desired maximum column.  In the case of a forced 
> folding, the location MUST be before or at the end of the line.

Not quite. I think:

      1. Determine where the fold will occur. This location MUST be 
before or at the desired maximum column.  This (of course) MUST be prior 
to the last character on the line. In the case of a forced folding, this 
may precede the desired maximum column.

(Or do you want to allow the degenerate case where the line is folded at 
the end, so the continuation contains nothing?)

>> Also, there should be examples of forced folding.
> 
> Agreed.

If forced folding example(s) are *added* then I think it is fine to 
retain the existing example done both ways.

	Thanks,
	Paul