Em Tue, 23 Apr 2019 19:20:06 +0200 Borislav Petkov <bp@xxxxxxxxx> escreveu: > On Tue, Apr 23, 2019 at 07:11:58PM +0200, Peter Zijlstra wrote: > > I know I'm an odd duck; but no. They're _less_ accessible for me, as > > both a reader and author. They look 'funny' when read as a text file > > (the only way it makes sense to read them; I spend 99% of my time on a > > computer looking at monospace text interfaces; mutt, vim and console, in > > that approximate order). > > +1 > > It is probably fine to stare at them here > https://www.kernel.org/doc/html/latest/ and the end result is good > for showing them in browsers but after this conversion, it is > getting more and more painful to work with those files. For example, > Documentation/x86/x86_64/mm.txt we use a lot. I'd hate it if I had to go > sort out rest muck first just so that I can read it. That's my view about how that specific file would be after converted to ReST: https://git.linuxtv.org/mchehab/experimental.git/tree/Documentation/x86/x86_64/mm.rst?h=convert_rst_renames I don't have any troubles reading/understanding it as a plain text file, and its html output is also nice (although Sphinx 1.7.8 seems to have some issues when parsing some cells - probably due to some bug): https://www.infradead.org/~mchehab/rst_conversion/x86/x86_64/mm.html > > I think we can simply leave some text files be text files and be done > with it. Changbin's approach was somewhat close to what you want. He simply prepended the tables with ::, in order to show them as plain old ascii: https://lore.kernel.org/lkml/20190423162932.21428-60-changbin.du@xxxxxxxxx/ Both equally works, from ReST conversion PoV. I'm fine ether way. I prefer my approach, as, IMHO, it is visually nicer on both text and html versions, but his approach is likely easier to maintain, as doing ascii artwork by hand is sometimes painful. Thanks, Mauro -- dm-devel mailing list dm-devel@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/dm-devel
