On Tue, 31 Jan 2017 10:35:44 -0700 Logan Gunthorpe <logang@xxxxxxxxxxxx> wrote: > > And don't dump a .txt file into Documentation/ anymore, people are > > working to move to the newer format. > > Fair. I wasn't sure where a good place to put it was. Any suggestions? We're working toward a rational document hierarchy using the sphinx system: https://lwn.net/Articles/692704/ https://lwn.net/Articles/692704/ https://static.lwn.net/kerneldoc/doc-guide/index.html The good news is that your switchtec.txt file is already 99% in the RST format, so there is little or nothing to do there. The bad news is that we don't quite have a place for it yet. This is really user-space developer documentation, and we don't have a sub-book for that. I expect that to change pretty soon, and I might even toss together a bare beginning for 4.11, but that hasn't happened yet. If you would like to learn the ropes and make one, that would be more than great :) Alternatively, I'd suggest just leaving the document as-is, and I'll put it toward the top of the list of things to move into place once I get that book started. Thanks, jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
