On 8/8/2016 12:49 PM, John Kasunich wrote:
> 
> Is it impossible to generate traditional manpages (viewable by "man")
> from the asciidoc sources?  

Apparently, it is.  That's how things came to be the way they are.

We decided to standardize on asciidoc for documentation, and despite
much effort it was not possible to get consistently good results in
man format via automatic conversion, so mank was created.

>>  I don't think typing one extra letter is too bad a compromise.  Try it.
> 
> It's not typing the letter that's the problem.  Its knowing that you
> need to type the letter.

I think having stub man pages referring to mank will help a lot with
this.  The issue goes from a show-stopper for the user "Where's the
documentation?!?" to a strange nuisance "When will I remember to type
mank first?!?".  :)

-- 
Charles Steinkuehler
[email protected]

-- 
website: http://www.machinekit.io blog: http://blog.machinekit.io github: 
https://github.com/machinekit
--- 
You received this message because you are subscribed to the Google Groups 
"Machinekit" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
Visit this group at https://groups.google.com/group/machinekit.
For more options, visit https://groups.google.com/d/optout.

Reply via email to