Andres Freund <and...@anarazel.de> writes: > I think this misunderstanding is again due to the confusion between the 'all' > target in doc/src/sgml and the default target, just like earlier in the thread > / why I ended up with the prior set of targets under 'docs'.
> # Make "html" the default target, since that is what most people tend > # to want to use. > html: > ... > all: html man > Given the repeated confusion from that, among fairly senior hackers, perhaps > we ought to at least put those lines next to each other? It's certainly not > obvious as-is. I think there are ordering constraints between these and the Makefile.global inclusion. But we could add a comment beside the "all:" line pointing out that that's not the default target. > Perhaps we should have doc-html, doc-man, doc-all or such? No objection here. If we intend to someday build tarballs with meson, there'd need to be a target that builds html+man, but that could perhaps be named "distprep". regards, tom lane