2016-12-14 18:27 GMT+01:00 David Lang <[email protected]>: > On Wed, 14 Dec 2016, mostolog--- via rsyslog wrote: > >>> To solve this hopefully once and forever, I googled again for "sphinx >>> dot" and the first result seems to be fully appropriate: >>> >>> http://www.sphinx-doc.org/en/1.4.8/ext/graphviz.html >>> >>> As I said two weeks or so ago, we need to check if we have >>> sufficiently current sphinx on the involved systems, but the first >>> step is to read and use what is describe, to see if it actually fits >>> the need. > > >> Yes, but my point is that doesn't properly render on github. I'll love to >> have documentation (with graphs) on github, but I'll have to stick to >> sphinx+rsyslog.com if that doesn't work. That's why I tried gravizzo (or >> whatever the name is) > > > I know I've seen discussions on these sorts of things in the past on other > lists. > > What we need here is makefile magic where a file can be in the repository, > but also optionally generated by a build. If the file is up-to-date compared > to it's source (later timestamp), the makefile doesn't try to build it, and > therefor doesn't require the dependency of the tools needed for the build, > but if the generated file is older than it's source, the make will look for > the tools it requires to build the file (complaining if they aren't there), > and then re-generate it. > > If someone can do the research on how to best do this, we could also use it > for the bison/yacc dependency. > > This is good for generated files that don't change much, which both the > diagrams and the grammer match
I think all of this is already done and in place for over a year. The problem is that mostolog insists that the doc happens on github, which is not our intent nor anything we have tried so far. Rainer _______________________________________________ rsyslog mailing list http://lists.adiscon.net/mailman/listinfo/rsyslog http://www.rsyslog.com/professional-services/ What's up with rsyslog? Follow https://twitter.com/rgerhards NOTE WELL: This is a PUBLIC mailing list, posts are ARCHIVED by a myriad of sites beyond our control. PLEASE UNSUBSCRIBE and DO NOT POST if you DON'T LIKE THAT.
