Re: Committer Request for wip/herbe

[Greg Troxel <gdt%lexort.com@localhost>]

Kevin Bloom <kevin.bloom%posteo.net@localhost> writes:

> Greg Troxel <gdt%lexort.com@localhost> wrote:
>
> Couldn't agree more. Another program I really like, misc/pick, does a
> similar thing in the latest version 4.0.0 - the author decided man
> isn't cool anymore or something. Also, removed the --version flag,
> which is odd to me. I wonder if there is a new trend to void man
> pages?

I really don't know.

>> But you mention a README.  If upstream has README that explains things,
>> it should be installed in share/doc/herbe/README.  See 21.6.2 in the
>> guide.   If that's sufficient, a missing man page is less serious, but
>> it is the unix norm to have a man page.
>
> Okay, I'll do this. The README is basically the only documentation. Is
> it okay if it's a markdown README?

I think it's ok, and I am not aware of anybody else thinking it isn't.
markdown is readable with more.  I tend to preserve the filename of
upstream docs, as they go in a per-package directory.