[Tools-discuss] rfcdiff with inputs that have long lines

[Russ Housley]

On the tao-discuss mail list, we have been talking about a proposed update to the Tao of the IETF. Since the Tao is now published as a webpage (https://www.ietf.org/tao/), the proposed new text was provided in a file with long lines.

By wrapping the lines at 72 character, the rfcdiff tool then provides a useful output. How hard would it be to have https://www.ietf.org/tools/rfcdiff/ do that automatically? Perhaps it could count the number of lines greater that 80, and if there are many, wrap the lines and then run the diff.

Russ

___________________________________________________________
Tools-discuss mailing list
Tools-***@ietf.org
https://www.ietf.org/mailman/listinfo/tools-discuss

Please report datatracker.ietf.org and mailarchive.ietf.org
bugs at http://tools.ietf.org/tools/ietfdb
or send email to datatracker-***@ietf.org

Please report tools.ietf.org bugs at
http://tools.ietf.org/tools/issues
or send email to ***@tools.ietf.org

[Henrik Levkowetz]

Hi Russ,

Post by Russ Housley
On the tao-discuss mail list, we have been talking about a proposed
update to the Tao of the IETF. Since the Tao is now published as a
webpage (https://www.ietf.org/tao/), the proposed new text was
provided in a file with long lines.
By wrapping the lines at 72 character, the rfcdiff tool then provides
a useful output. How hard would it be to have
https://www.ietf.org/tools/rfcdiff/ do that automatically? Perhaps it
could count the number of lines greater that 80, and if there are
many, wrap the lines and then run the diff.

Not that hard. I should be able to have a new release available later today.


Best regards,

Henrik

Post by Russ Housley
Russ
___________________________________________________________
Tools-discuss mailing list
https://www.ietf.org/mailman/listinfo/tools-discuss
Please report datatracker.ietf.org and mailarchive.ietf.org
bugs at http://tools.ietf.org/tools/ietfdb
Please report tools.ietf.org bugs at
http://tools.ietf.org/tools/issues

___________________________________________________________
Tools-discuss mailing list
Tools-***@ietf.org
https://www.ietf.org/mailman/listinfo/tools-discuss

Please report datatracker.ietf.org and mailarchive.ietf.org
bugs at http://tools.ietf.org/tools/ietfdb
or send email to datatracker-***@ietf.org

Please report tools.ietf.org bugs at
http://tools.ietf.org/tools/issues
or send email to ***@tools.ietf.org

[Henrik Levkowetz]

Post by Henrik Levkowetz
Hi Russ,

Post by Russ Housley
On the tao-discuss mail list, we have been talking about a proposed
update to the Tao of the IETF. Since the Tao is now published as a
webpage (https://www.ietf.org/tao/), the proposed new text was
provided in a file with long lines.
By wrapping the lines at 72 character, the rfcdiff tool then provides
a useful output. How hard would it be to have
https://www.ietf.org/tools/rfcdiff/ do that automatically? Perhaps it
could count the number of lines greater that 80, and if there are
many, wrap the lines and then run the diff.

Not that hard. I should be able to have a new release available later today.

A new version is available here:

https://tools.ietf.org/rfcdiff

If you add the desired fold column in the fold lines form field, you'll
get line folding before diffing.

You can also use a query parameter, if constructing the url by hand, by
adding this: "&--fold=80"

The new version will be available on the https://www.ietf.org/tools/rfcdiff/
page when installed by the secretariat.

Henrik

___________________________________________________________
Tools-discuss mailing list
Tools-***@ietf.org
https://www.ietf.org/mailman/listinfo/tools-discuss

Please report datatracker.ietf.org and mailarchive.ietf.org
bugs at http://tools.ietf.org/tools/ietfdb
or send email to datatracker-***@ietf.org

Please report tools.ietf.org bugs at
http://tools.ietf.org/tools/issues
or send email to ***@tools.ietf.org

[Julian Reschke]

Post by Russ Housley
On the tao-discuss mail list, we have been talking about a proposed update to the Tao of the IETF. Since the Tao is now published as a webpage (https://www.ietf.org/tao/), the proposed new text was provided in a file with long lines.
...

It escapes me why we don't produce documents like these with the same
tool set we publish technical documents with...

Best regards, Julian

___________________________________________________________
Tools-discuss mailing list
Tools-***@ietf.org
https://www.ietf.org/mailman/listinfo/tools-discuss

Please report datatracker.ietf.org and mailarchive.ietf.org
bugs at http://tools.ietf.org/tools/ietfdb
or send email to datatracker-***@ietf.org

Please report tools.ietf.org bugs at
http://tools.ietf.org/tools/issues
or send email to ***@tools.ietf.org

[Julian Reschke]

Post by Julian Reschke

Post by Russ Housley
On the tao-discuss mail list, we have been talking about a proposed
update to the Tao of the IETF.  Since the Tao is now published as a
webpage (https://www.ietf.org/tao/), the proposed new text was
provided in a file with long lines.
...

It escapes me why we don't produce documents like these with the same
tool set we publish technical documents with...
...

As a matter of fact, earlier versions of the document *have* been
produced with xml2rfc. So IMHO the best way to proceed would be to diff
and maintain that source file... (or, as a matter of fact, to rfcdiff
the plain text output).

Best regards, Julian

___________________________________________________________
Tools-discuss mailing list
Tools-***@ietf.org
https://www.ietf.org/mailman/listinfo/tools-discuss

Please report datatracker.ietf.org and mailarchive.ietf.org
bugs at http://tools.ietf.org/tools/ietfdb
or send email to datatracker-***@ietf.org

Please report tools.ietf.org bugs at
http://tools.ietf.org/tools/issues
or send email to web

[Russ Housley]

Post by Russ Housley
On the tao-discuss mail list, we have been talking about a proposed update to the Tao of the IETF. Since the Tao is now published as a webpage (https://www.ietf.org/tao/), the proposed new text was provided in a file with long lines.
...

It escapes me why we don't produce documents like these with the same tool set we publish technical documents with...
...

As a matter of fact, earlier versions of the document *have* been produced with xml2rfc. So IMHO the best way to proceed would be to diff and maintain that source file... (or, as a matter of fact, to rfcdiff the plain text output).

An author or editor could do so. In fact, there are several pages that the IESG maintains that do exactly that. That said, this is not a requirement that we impose on them.

Russ

___________________________________________________________
Tools-discuss mailing list
Tools-***@ietf.org
https://www.ietf.org/mailman/listinfo/tools-discuss

Please report datatracker.ietf.org and mailarchive.ietf.org
bugs at http://tools.ietf.org/tools/ietfdb
or send email to datatracker-***@ietf.org

Please report tools.ietf.org bugs at
http://tools.ietf.org/tools/issues
or send email to ***@tools.ietf.org

[Brian E Carpenter]

Post by Julian Reschke

Post by Russ Housley
On the tao-discuss mail list, we have been talking about a proposed update to the Tao of the IETF. Since the Tao is now published as a webpage (https://www.ietf.org/tao/), the proposed new text was provided in a file with long lines.
...

It escapes me why we don't produce documents like these with the same
tool set we publish technical documents with...

It's a lot harder with the new website's content management system
and the new look and feel.

For example, http://www6.ietf.org/about/process-docs.html was
done with xml2rfc and a little manual tweaking, but that simply
wouldn't carry over to https://www.ietf.org/about/participate/get-started/

Brian

___________________________________________________________
Tools-discuss mailing list
Tools-***@ietf.org
https://www.ietf.org/mailman/listinfo/tools-discuss

Please report datatracker.ietf.org and mailarchive.ietf.org
bugs at http://tools.ietf.org/tools/ietfdb
or send email to datatracker-***@ietf.org

Please report tools.ietf.org bugs at
http://tools.ietf.org/tools/issues
or send email to ***@tools.ietf.org