On 3/31/16, Kristaps Dzonsons <kristaps at bsd.lv> wrote: > > Is there any interest in integrating this tool to have manpages in the > doc distribution without downstream bits? >
I think that would be cool. Integrating your tool into the source tree would mean that as the comment formats evolve, your tool would evolve in lock-step. If your tool is kept separate, then we might change the documentation comment format without telling you, and break things. One issue is the license. SQLite is public domain, not BSD (or ISC). Is it even possible for citizens of Latvia to release something to the public domain? In any event, some paperwork would have to flow between us to make that happen. Though, maybe that is not a huge concern as we are not nearly as persnickety with licensing for the documentation as we are with the code, and this tool would go in the separate documentation repository (https://www.sqlite.org/docsrc/timeline), not in the main code repository. Would an even better solution be to enhance the capi3ref TCL script to spit out mdoc files in parallel to the HTML documentation it currently produces? -- D. Richard Hipp drh at sqlite.org
