On Sun, Dec 16, 2018 at 03:34:42PM +0100, Martin Ågren wrote: > Your list seems complete to me in terms of "how could we teach doc-diff > to diff asciidoctor vs asciidoc?". For the resulting diff to actually be > useful ;-) there are two more outstanding issues that I see: > > - Headers and footers. Asciidoc (driven by doc-diff) uses some > boilerplate values which avoid timestamps and the like. Asciidoctor > partly uses different values, partly interprets the ones given > differently. > > - Asciidoctor introduces a space after linkgit:foo , e.g., before > punctuation. > > Both of these are problems in their own right, so they probably > shouldn't be suppressed in the resulting diff. But as long as these > issues remain, they produce a lot of noise which might hide more > interesting (IMHO) differences. If there are a small number of distinct problems (that each have many instances), I'm not opposed to having a mode to suppress them in the resulting diff, so we can see the other problems more clearly. Of course, just fixing them is even better. ;) The first one sounds like it may be a candidate for suppressing (i.e., it's not necessarily an actual problem). -Peff