'man' página é muito estreita (não aproveitando o tamanho do terminal)

Question

Estou fazendo minha primeira página "man" e estou usando groff para fazer isso. No entanto, quando eu "compilar" e visualizá-lo, ele só ocupa uma certa quantidade de colunas no meu terminal. Eu tentei ver outras páginas de homem apenas no caso e elas se esticam com a largura do meu terminal. Para um exemplo visual:

---------------------------------------
| stuff(1)             stuff(1)         |
|                                       |
| NAME                                  |
|       a tool to do stuff but          |
|       it isn't really working         |
|                                       |
| DESCRIPTION                           |
|       yadadyadyadyadyadyadydy         |
|       segfwefwefwefwe                 |
|                                       |
|       srgswrgwrg                      |
 ---------------------------------------

... e assim por diante, espero que você tenha a idéia. A maioria das páginas man ocupa toda a largura.

Agora mesmo, depois de escrever minha man page em um arquivo de texto (usando a "sintaxe" groff / nroff), eu faço assim:

groff -Tascii -man ./path/to/man | more

    

Answer 1

Eu verifiquei o que groff call é executado quando invoco man man (que usa a largura total):

$ strace -o log -f -v -s 1024 -e trace=process man man

Procurando pelos resultados da chamada groff no seguinte:

$ grep groff log | sed 's/\], \[.*//' 
28721 execve("/usr/bin/groff", ["groff", "-mtty-char", "-Tutf8", "-mandoc",
                                         "-rLL=171n", "-rLT=171n"

Agora eu redimensiono meu xterm:

$ strace -o log2 -f -v -s 1024 -e trace=process  man man
$ grep groff log2 | sed 's/\], \[.*//'
28852 execve("/usr/bin/groff", ["groff", "-mtty-char", "-Tutf8", "-mandoc",
                                         "-rLL=119n", "-rLT=119n"

Assim, presumo que os argumentos -rLL e -rLT influenciam a largura do terminal usada por groff durante a compilação.

    

Answer 2

Acredito que as versões mais atuais de man serão DoTheRightThing ™ se você especificar sua página de manual como um argumento contendo uma barra:

man ./stuff.1