[Swan-dev] always generating the man page

[Lennart Sorensen]

On Thu, May 07, 2015 at 03:10:35PM -0400, Paul Wouters wrote:
> That must have been there already because when I re-installed my VMs
> two days ago I ran into the bug of man page generations that would
> not happen without xmlto ?
> 
> Note, that we should not break the build if no xmlto is found. Especialy
> to make it easier for cross compilers.
> 
> This is mostly a lot of legacy, from before the days of "man command
> option" (eg man git branch)
> 
> I don't think it matters whether "man ipsec_version" works or not, as
> long as "man ipsec version" works. This is true for all our things.
> 
> Some library functions obviously have no command, so for some of that
> developers will just have to know to prefix it, eg "man ipsec_addrtoa".
> Some of those man3 pages would otherwise cause names too generic.
> 
> One pet peeve of mine is that I think any daemon running that I can see
> with "ps" should have a man page, so "man pluto" should really work.
> Another important with with prefix is "man ipsec whack" (which is
> actually the same man page)
> 
> Note that I ran into another bug the other day. I build just before
> midnight and so the i386 build happened on date X, and the x86_64 build
> on date X+1. This causes the package to no longer be multilib clean.
> 
> It would be nice if we could either prevent/strip out the dates from the
> generated man pages, or possibly use a date limited to the year and
> month.

So you will never be bored on new years eve?

-- 
Len Sorensen