Re: [PATCH rdma-core] Support writing man pages in MarkDown

[Jason Gunthorpe <jgg-VPRAkNaXOzVWk0Htik3J/w@public.gmane.org>]

On Tue, Dec 12, 2017 at 11:11:15PM +0000, Hefty, Sean wrote:
> > Since this may be a problem, I am thinking about following the
> > libfabric approach and either including the precompiled man pages in
> > the source tree, or just providing a framework for downstream to add-
> > on precompiled files (with a cbuild command to make them) Looking for
> > feedback on what path is best..
> 
> FWIW, one of the reasons libfabric went with pre-compiled man pages
> was to include a date for the last edit.  A service automatically
> updates the date when updating the page.

This isn't going to be so useful here since all the markdown pages
were created today..

What I did was to copy the date from the original man page over to the
markdown header:

date: 2015-01-29

So the date visible in the man page doesn't change from what it was
before (which in turn is a kind of meaningless value these days since
we never bothered to keep it up to date in most cases)

Other projects don't bother with the date, for instance systemd just
drops in in the package version number in that space, which actually
seems more usefull to me.

Jason
--
To unsubscribe from this list: send the line "unsubscribe linux-rdma" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html