On Tue, Mar 03, 2020 at 10:15:31AM -0000, Stuart Henderson wrote: > On 2020-03-02, Peter N. M. Hansteen <pe...@bsdly.net> wrote: > > I was thinking of the probably quite unlikely event that somebody who wants > > this > > comes up with an actually reproducible way that could be turned into an > > otherwise > > unremarkable make target. > > >From experience with other generated files: it won't get used by > everyone who updates the faq, meaning that it's another thing that > somebody<tm> has to watch out for and fix it.
I'd state the problem more generally: Changing the way people work (their 'workflow') is hard. I've spent years maintaining documentation with one source format and several target formats, each one an 'unremarkable make target', usually html, pdf and text. I personally saw the benefit of working with a single source format and several target formats, but each time I tried teaching that particular toolset to others, the learning curve proved too steep for the perceived benefit. Also, the source files were not in a familiar format such as html or mdoc, so that specific tool would be pretty much dead in the water here. (that tool was DocBook SGML, and one of the several docs I maintained over the years was the early versions of the PF tutorial that eventually morphed into The Book of PF -- which for totally separate reasons was written and rewritten using OpenOffice and later LibreOffice). All the best, Peter -- Peter N. M. Hansteen, member of the first RFC 1149 implementation team http://bsdly.blogspot.com/ http://www.bsdly.net/ http://www.nuug.no/ "Remember to set the evil bit on all malicious network traffic" delilah spamd[29949]: 85.152.224.147: disconnected after 42673 seconds.