Imprimer des pages de manuel à largeur fixe

Avec l'exemple de commande

man apropos > outputfile

un fichier texte est généré qui contient la manpage formatée de apropos(avec quelques petites différences par rapport à l' man aproposimpression directe à l'écran, comme les caractères gras).

Mais je voudrais définir manuellement la largeur de ligne maximale du fichier de sortie généré, afin que tous les paragraphes soient justifiés à cette largeur.

manles pages sont créées via groff: par exemple, j'ai essayé de mettre .ll 50avant un paragraphe du .gz manfichier texte source d' origine , mais c'est trivial si j'ai besoin de travailler sur plusieurs manpages. De plus tous les personnages ne sont pas reconnus:

apropos.1:45: warning: can't find character with input code 195
apropos.1:45: warning: can't find character with input code 168
apropos.1:47: warning: can't find character with input code 178
apropos.1:131: warning: can't find character with input code 169

Je me demande donc s'il existe une méthode plus simple. Comment modifier la largeur maximale de ligne, lors de la création d'un outputfile? Existe-t-il une commande spécifique?

Modifier :

(Toutes les considérations suivantes concernent Ubuntu 18.04: je ne peux plus les tester dans les versions précédentes, y compris le 14.04 de la question ci-dessus.)

En ce qui concerne une solution temporaire d'une ligne, si elle MANWIDTHn'a pas déjà été exportée avec une valeur personnalisée, il n'y a pas de différence entre

$ MANWIDTH=60 man apropos > outputfile

et

$ COLUMNS=60 man apropos > outputfile

La première, en utilisant MANWIDTH, est cependant meilleure en principe.

Edit 2 (pas strictement lié à la question):

Pour définir à la place un paramètre de largeur permanent à appliquer à toute impression de page de manuel, il est nécessaire d' exporter la valeur souhaitée de la variable. Avec:

$ export MANWIDTH=60
# zero or more additional lines
$ man apropos > outputfile

man apropossera imprimé avec la même largeur quel que soit le redimensionnement de la fenêtre du terminal. Au lieu,

$ export COLUMNS=60
# zero or more additional lines
$ man apropos > outputfile

fournira le même résultat qu'auparavant uniquement si la fenêtre du terminal n'est pas redimensionnée entre exportet man <page> > outputfile.

Utilisez la MANWIDTHvariable d'environnement:

MANWIDTH=60 man apropos > apropos.txt

La page de manuel de man 2.7.4 indique:

Si $ MANWIDTH est défini, sa valeur est utilisée comme longueur de ligne pour laquelle les pages de manuel doivent être formatées. S'il n'est pas défini, les pages de manuel seront formatées avec une longueur de ligne appropriée au terminal actuel (en utilisant la valeur de $ COLUMNS, un ioctl (2) si disponible, ou retomber à 80 caractères si aucun n'est disponible).

Autrement dit, il remplace à la fois COLUMNSet la ioctlvaleur. Je préfère ne pas compter sur la modification COLUMNS(bien que cela fonctionne ici) car sa valeur est mise à jour dynamiquement à chaque fois que la taille de la fenêtre change.

L'utilisation de MANWIDTHau lieu de COLUMNSvous permet également de rendre la modification permanente en ajoutant une ligne telle que export MANWIDTH=60votre fichier de démarrage du shell.

Essayez de définir la COLUMNSvariable d'environnement. Fonctionne pour moi avec mande mandb2.7.0.2 sur Debian avec groff1.22.3.

$ COLUMNS=60 man apropos | head
APROPOS(1)          Manual pager utils          APROPOS(1)



NAME
       apropos - search the manual page names and descrip‐
       tions

SYNOPSIS
       apropos [-dalv?V] [-e|-w|-r]  [-s  list]  [-m  sys‐

$ COLUMNS=70 man apropos | head
APROPOS(1)               Manual pager utils               APROPOS(1)



NAME
       apropos - search the manual page names and descriptions

SYNOPSIS
       apropos  [-dalv?V] [-e|-w|-r] [-s list] [-m system[,...]] [-M
       path] [-L locale] [-C file] keyword ...

Avec la version sur Ubuntu 14.04, je dois l'écrire:

COLUMNS=60 < /dev/null man apropos | head

Là, mansemble ignorer la COLUMNSvariable d'environnement si stdin est un terminal (il interroge ensuite le terminal pour la largeur du terminal).

Vous pouvez également essayer:

s=$(stty -g); stty cols 60; man apropos | head; stty "$s"

Qui avec zshvous peut raccourcir en:

STTY='cols 60' man apropos | head

Vous pouvez le faire en invoquant groffà la main:

gzip -dcf "$(man -w apropos)" |
  groff -ekpstR -mtty-char -mandoc -Tutf8 -rLL=60n |
  col -bpx

Votre ne peut pas trouver caractère avec le code d' entrée erreurs étaient parce que vous avez utilisé au -Tasciilieu de -Tutf8et ne pas utiliser -kde pré-traiter les fichiers avec preconv.

Vous pouvez utiliser la fmtcommande, qui pour autant que je sache, est présente dans n'importe quelle distribution Linux.

man apropos | fmt -w 70 

terminera les lignes à 70 caractères.

Vous pouvez utiliser fold

man cp | fold -w 20

se pliera après chaque 20 caractères (!). Notez que cela coupera les mots en deux car la seule option est "plier tous les 20 caractères"

en prenant soin de cela, vous pouvez utiliser sedcomme suit (avec une longueur de ligne dynamique)

man cp | sed 's/.\{20\} /&\n/g'

ajoutera une nouvelle ligne après 20 caractères aléatoires suivis d'un espace (c'est-à-dire un nouveau mot). Ainsi, les lignes peuvent dépasser 20 caractères (la correspondance est de 20 caractères, puis un espace pour qu'un mot de 26 caractères donne une ligne de 26 caractères)

Pour avoir omis le dernier espace de la sedcommande:

sed 's/\(.\{20\}\) /\1\n/g'