On Sat, Mar 18, 2017 at 03:32:54AM -0400, Jean-Philippe Ouellet wrote:
> Unman is correct.
> 
> Additionally, mandb index generation may be of lesser quality because
> our man pages are not actual man pages, but rather lifted from
> reStructuredText via pandoc, which generate raw *roff formatting
> macros rather than semantic mdoc (or even man(7)) ones. This is
> because reStructuredText inherently lacks such semantics, and pandoc
> does not attempt to heuristically assign any.
> 
> Example:
>     NAME
>     ====
>     qvm-block - list/set VM PCI devices.
> 
> Turns into:
>     .TH "qvm\-block" "" "" "" ""
>     .SH NAME
>     .PP
>     qvm\-block \- list/set VM PCI devices.
> 
> Instead of:
>     .Sh NAME
>     .Nm qvm-block
>     .Nd list/set VM PCI devices

Although, of course, apropos seems to work perfectly with that utility as well.

-- 
You received this message because you are subscribed to the Google Groups 
"qubes-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to qubes-users+unsubscr...@googlegroups.com.
To post to this group, send email to qubes-users@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/qubes-users/20170318131121.GA6448%40thirdeyesecurity.org.
For more options, visit https://groups.google.com/d/optout.

Reply via email to