Solved textproc/mantra and tmux

grahamperrin

Son of Beastie

Reaction score: 830
Messages: 2,681

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.)
 
OP
grahamperrin

grahamperrin

Son of Beastie

Reaction score: 830
Messages: 2,681

tmux followed by mantra (alone):

1634624256118.png
1634624281712.png


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

1634624412042.png
 

Erichans

Member

Reaction score: 69
Messages: 86

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
 

T-Daemon

Daemon

Reaction score: 939
Messages: 1,832

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
 

Erichans

Member

Reaction score: 69
Messages: 86

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.
 

0mp

New Member
Developer

Reaction score: 9
Messages: 9

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 ;)).
 
OP
grahamperrin

grahamperrin

Son of Beastie

Reaction score: 830
Messages: 2,681

Thanks everyone. Part of my confusion was lack of familiarity with tmux. (It's possible that I never used it before.)
 
Top