[PATCH v2 0/2] DEFAULT_DOC_TARGET
This allows things like: $ DEFAULT_DOC_TARGET=html make doc $ DEFAULT_DOC_INSTALL_TARGET=html make install-doc on a platform that does not have manpage viewer. Which is not very useful, given that you can already say $ make install-html on such a platform, and these install-$format targets will not go away. The real motivation behind this was to let me say: $ git checkout $some_old_fork_point $ DEFAULT_DOC_TARGET=git-push.1 make doc while updating the sources to the documentation for the maintainance track, without having to format everything else that is different between the old fork point and the primary branch I usually work on. The first one was discussed some time ago on the list and all the fixes mentioned on the thread already squashed in. The second one is merely for completeness. For previous round, see: http://thread.gmane.org/gmane.comp.version-control.git/207193/focus=207201 Junio C Hamano (2): Allow generating a non-default set of documentation Allow installing a non-default set of documentation Documentation/Makefile | 10 -- Makefile | 13 - 2 files changed, 20 insertions(+), 3 deletions(-) -- 1.8.1.293.g4a210a9 -- To unsubscribe from this list: send the line unsubscribe git in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
Re: [PATCH v2 0/2] DEFAULT_DOC_TARGET
On Thu, Jan 03, 2013 at 03:32:22PM -0500, Jeff King wrote: On Thu, Jan 03, 2013 at 11:05:18AM -0800, Junio C Hamano wrote: This allows things like: $ DEFAULT_DOC_TARGET=html make doc $ DEFAULT_DOC_INSTALL_TARGET=html make install-doc on a platform that does not have manpage viewer. Which is not very useful, given that you can already say $ make install-html on such a platform, and these install-$format targets will not go away. I think the usefulness is that it can be set by default for a particular uname, so people on Windows can just type make install-doc without having to care about setting anything (though to be honest, I do not even know what they build by default; maybe they do build manpages). I also notice that we have DEFAULT_HELP_FORMAT (which is html on Windows). Wouldn't that be a sane default for DEFAULT_DOC_TARGET if it is set? I guess we can set all three independently for maximum flexibility, though, but it seems like a sane fallback. -Peff -- To unsubscribe from this list: send the line unsubscribe git in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html