Solved textproc/mantra and tmux

textproc/mantra installed.

(Thanks to vermaden for the hint; <https://vermaden.wordpress.com/2021/10/19/valuable-news-2021-10-19/>.)

Code:
% man mantra
No manual entry for mantra
% mantra
ERROR: TMUX environment variable is empty, aborting; mantra works correctly only when executed from within a tmux session
% mantra freebsd-install.8
ERROR: TMUX environment variable is empty, aborting; mantra works correctly only when executed from within a tmux session
% tmux
[exited]
%

– I tried mantra freebsd-install.8 during the run of tmux, it did nothing.

<https://github.com/0mp/mantra#usage> appears simple enough.

Pages such as <https://github.com/tmux/tmux/wiki/FAQ> and <https://stackoverflow.com/q/20701757/38108> are too much for me at the moment.

Is there a very simple way for me to get started?

Or should I delete/ignore my installation of mantra? (I'm curious about it, that's all.)
 
tmux followed by mantra (alone):

1634624256118.png
1634624281712.png


Following the developer's example, nothing in response to the command:

1634624412042.png
 
From what I can see by peeking at the code (mantra). It looks like a tool to automagically reload a manpage file under construction/inspection that has changed, presumably because that manpage file is being worked on. I get the following results when opening a man page with mantra (from within a tmux session):
Code:
% mantra
ERROR: No manual pages in the current directory to default to
% cd /usr/share/man/man1
% mantra find.1.gz
The find manpage is now in view, looking "just like" man find . I have no way to verify my assumption because l have no experience in producing man pages.

The example mentioned seems to refer to:
Code:
% mantra /usr/share/man/man9/style.9

Perhaps a suggestion for this tool: make a man page for mantra ;)

P.S. curious too
 
The example mentioned seems to refer to:
Code:
% mantra /usr/share/man/man9/style.9
More likely (is there a typo?) :
Code:
% mantra /usr/src/share/man/man9/style.9

The description of https://github.com/0mp/mantra says:
Mantra is a CLI for previewing mandoc manual pages with live auto-reload in a pager.

And for mandoc:
mandoc is a suite of tools compiling mdoc, the roff macro language of choice for BSD manual pages, and man, the predominant historical language for UNIX manuals
 
Thank you.

Given the example at the section Usage on the github page (mantra):
Code:
mantra style.9

It would have been more helpful, at least to me, to have that written out as:
Code:
% mantra /usr/src/share/man/man9/style.9
Especially since in absence of a manual page, typing mantra -h does not mention any usage example.

I do appreciate that this is a pre 1.0 version.
 
Given the example at the section Usage on the github page (mantra):
Code:
mantra style.9

It would have been more helpful, at least to me, to have that written out as:
Code:
% mantra /usr/src/share/man/man9/style.9
Especially since in absence of a manual page, typing mantra -h does not mention any usage example.
Hey, the author of mantra here. Thanks for checking it out and suggesting improvements. I didn't expect that the example could be confusing. I'll update it soon (unless someone submits a PR for that ;)).
 
Thanks everyone. Part of my confusion was lack of familiarity with tmux. (It's possible that I never used it before.)
 
Back
Top