>> 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?
Richard, As for public domain, I'm happy to put the sources under a similar license. I can't speak for the voodoo of the public domain and the EU (or is it country-by-country?), however. As for Tcl--I don't grok it myself or I'd have started modifying there. (I used capi3ref as a starting point.) Be it C or Tcl, there's a lot of string fiddling to get everything formatted for mdoc(7) (and to collect refs), so it won't be pretty (or brief) in any language. I'm happy maintaining the tool in or out of the tree--whatever's most convenient. I figured I'd just track changes to sqlite.h.in and update the scanner if it was required. (E.g. and in the most likely case: more HTML tags.) At the end of the day, I just want to use apropos and man instead of the browser! Best, Kristaps -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 842 bytes Desc: OpenPGP digital signature URL: <http://mailinglists.sqlite.org/cgi-bin/mailman/private/sqlite-users/attachments/20160331/79038d8e/attachment.pgp>
