lesskey - spécifier les liaisons de touches pour less

lesskey [-o sortie] [--] [entrée]
lesskey [--output=sortie] [--] [entrée]
lesskey -V
lesskey --version

lesskey est utilisé pour spécifier un ensemble de liaisons de touches destinées à être utilisés par less. Le fichier d'entrée est un fichier texte décrivant les liaisons de touches. Si le fichier d'entrée est « - », l'entrée standard est lue. Si aucun fichier d'entrée n'est spécifié, un nom de fichier standard est utilisé en tant que nom pour le fichier d'entrée, et dépend du système utilisé : sur les systèmes Unix, il s'agit de $HOME/.lesskey ; sur les systèmes MS-DOS, $HOME/_lesskey est utilisé alors que $HOME/lesskey.ini l'est sur les systèmes OS/2 (ou bien $INIT/lesskey.ini si $HOME n'est pas défini). Le fichier de sortie est un fichier binaire qui est utilisé par less. Si aucun fichier de sortie n'est spécifié, et que la variable d'environnement LESSKEY est définie, sa valeur est utilisée en tant que nom pour le fichier de sortie. Sinon, un nom de fichier standard est utilisé comme nom pour le fichier de sortie, et dépend du système utilisé : sur les systèmes Unix et OS-9, il s'agit de $HOME/.less ; sur les systèmes MS-DOS, $HOME/_less est utilisé alors que $HOME/less.ini l'est sur les systèmes OS/2 (ou bien $INIT/lesskey.ini si $HOME n'est pas défini). Si le fichier de sortie existe déjà, lesskey l'écrasera.
L'option -V ou --version affiche le numéro de version de lesskey et arrête immédiatement le programme. Si -V ou --version est présent, les autres options et arguments sont ignorés.
Le fichier d'entrée est constitué d'une ou de plusieurs sections. Chaque section débute par une ligne qui identifie son type. Les sections possibles sont :

#command

Définir de nouvelles touches de commandes.

#line-edit

Définir de nouvelles touches d'édition de ligne.

#env

Définir des variables d'environnement.

Les lignes blanches et les lignes débutant par un signe dièse (#) sont ignorées, sauf dans le cas des lignes d'en-tête de section spéciales.

La section de commandes débute par la ligne
#command
Si la section de commandes est la première du fichier, cette ligne peut être omise. La section de commandes est constituée de lignes de la forme :
       chaîne <cars-espacement> action [chaîne_supplémentaire]
<entrée>
Les caractères d'espacement sont constitués de n'importe quelle séquence d'espaces et/ou de tabulations. La chaîne de caractères est constituée de la ou des touches de commande qui invoquent l'action. Elle peut être une touche de commande unique, ou une séquence de plusieurs touches (jusqu'à 15). L'action est le nom de l'action de less, qui fait partie de la liste ci-dessous. Les caractères de la chaîne peuvent apparaître littéralement, ou être préfixés par un accent circonflexe pour indiquer une touche de contrôle. Un backslash suivi d'un à trois chiffres octaux peut être utilisé pour spécifier un caractère par sa valeur octale. Un backslash suivi de certains caractères spécifie les caractères d'entrée comme suit :

\b

EFFACEMENT ARRIÈRE

\e

ESCAPE

\n

SAUT DE LIGNE

\r

ENTRÉE

\t

TABULATION

\ku

FLÈCHE-HAUT

\kd

FLÈCHE-BAS

\kr

FLÈCHE-DROITE

\kl

FLÈCHE-GAUCHE

\kU

PAGE-PRÉCÉDENTE

\kD

PAGE-SUIVANTE

\kh

HOME

\ke

END

\kx

DELETE

Un \ suivi par n'importe quel autre caractère indique que ce caractère doit être traité littéralement. Les caractères devant être précédés par un \ incluent l'accent circonflexe, l'espace, la tabulation et le backslash lui-même.
Une action peut être suivie par une chaîne de caractères supplémentaire. Quand une telle commande est entrée pendant l'exécution de less, l'action est effectuée, et la chaîne de caractères supplémentaire est ensuite analysée, comme si elle avait été tapée dans less. Cette fonctionnalité peut dans certains cas être utilisée pour étendre les possibilités d'une commande. Par exemple, voyez les commandes « { » et
 « :t » dans l'exemple ci-dessous. La chaîne de caractères supplémentaire a une signification spéciale pour l'action « quit » : quand less se termine, le premier caractère de la chaîne de caractères supplémentaire est utilisé comme valeur de retour.

Le fichier d'entrée suivant décrit l'ensemble des touches de commandes par défaut (NdT : traduites) utilisées par less :

        #command
        \r              avancer-ligne
        \n              avancer-ligne 
        e               avancer-ligne 
        j               avancer-ligne 
        \kd          avancer-ligne
        ^E              avancer-ligne 
        ^N              avancer-ligne 
        k               reculer-ligne 
        y               reculer-ligne 
        ^Y              reculer-ligne 
        ^K              reculer-ligne 
        ^P              reculer-ligne 
        J               avancement-ligne-forcé 
        K               recul-ligne-forcé 
        Y               recul-ligne-forcé 
        d               défilement-avant 
        ^D              défilement-avant 
        u               défilement-arrière 
        ^U              défilement-arrière 
        \40          avancer-écran 
        f               avancer-écran 
        ^F              avancer-écran 
        ^V              avancer-écran 
        \kD          avancer-écran
        b               reculer-écran 
        ^B              reculer-écran 
        \ev             reculer-écran 
        \kU       reculer-écran
        z               forw-window 
        w               back-window 
        \e\40   avancement-écran-forcé
        F               toujours-avancer
        R               repeindre-vider_tampons
        r               repeindre 
        ^R              repeindre 
        ^L              repeindre 
        \eu             annuler-mise_évidence
        g               aller-à-la-ligne 
        \kh       aller-à-la-ligne
        <               aller-à-la-ligne 
        \e<             aller-à-la-ligne 
        p               pourcentage 
        %               pourcentage 
        \e[             défilement-gauche
        \e]             défilement-droit
        \e(             défilement-gauche
        \e)             défilement-droit
        {               accolade-avant {}
        }               accolade-arrière {}
        (               parenthèse-avant ()
        )               parenthèse-arrière ()
        [               crochet-avant []
        ]               crochet-arrière []
        \e^F            crochet-avant 
        \e^B            crochet-arrière
        G               aller-fin
        \e>             aller-fin 
        >               aller-fin 
        \ke       aller-fin
        =               statut
        ^G              statut 
        :f              statut 
        /               recherche-avant 
        ?               recherche-arrière 
        \e/             recherche-avant *
        \e?             recherche-arrière *
        n               répéter-recherche 
        \en             répéter-recherche-tous
        N               rechercher-arrière 
        \eN             rechercher-arrière-tous 
        m               spécifier-marque
        '               aller-marque
        ^X^X            aller-marque 
        E               examiner 
        :e              examiner
        ^X^V            examiner
        :n              fichier-suivant 
        :p              fichier-précédent
        t               marque-suivante
        T               marque-précédente
        :x              fichier-index 
        :d              supprimer-fichier
        -               basculer-option 
        :t              basculer-option t
        s               basculer-option o
        _               afficher-option 
        |               tube 
        v               visuel 
        !               shell 
        +               première-commande 
        H               aide 
        h               aide 
        V               version 
        0               chiffre
        1               chiffre
        2               chiffre
        3               chiffre
        4               chiffre
        5               chiffre
        6               chiffre
        7               chiffre
        8               chiffre
        9               chiffre
        q               quitter 
        Q               quitter 
        :q              quitter 
        :Q              quitter 
        ZZ              quitter 

Les commandes spécifiées par lesskey ont priorité sur les commandes par défaut. Une touche de commande par défaut peut être désactivée en l'incluant dans le fichier d'entrée avec l'action « invalid » (invalide). Alternativement, une touche peut être définie pour ne rien faire en utilisant l'action « noaction » (pas d'action). « noaction » est similaire à « invalid », mais less émettra un bip sonore d'erreur pour une commande « invalid », mais pas pour une commande « noaction ». De plus, TOUTES les commandes par défaut peuvent être désactivées en ajoutant cette ligne de contrôle dans le fichier d'entrée :
#stop
Cela fera ignorer toutes les commandes par défaut. La ligne #stop devrait être la dernière de cette section du fichier.
Soyez conscient que #stop peut être dangereux. Puisque toutes les commandes par défaut sont désactivées, vous devez fournir des commandes en nombre suffisant avant la ligne #stop pour activer toutes les actions nécessaires. Par exemple, ne pas fournir de commande « quit » (quitter) peut être assez embêtant.

La section d'édition de ligne commence par la ligne
#line-edit.
Cette section spécifie les nouvelles liaisons de touches des commandes d'édition de ligne, de la même façon que les liaisons de touches des commandes ordinaires sont spécifiées dans la section #command. La section d'édition de ligne est constituée d'une liste de paires touche/actions, une par ligne comme dans l'exemple ci-dessous.

Le fichier d'entrée suivant décrit l'ensemble des touches d'édition de ligne par défaut (NdT : traduites) utilisées par less :

        #line-edit
        \t              compléter-avant
        \17             compléter-arrière
        \e\t            compléter-arrière
        ^L              développer
        ^V              littéral
        ^A              littéral
        \el             droite
        \kr             droite
        \eh             gauche
        \kl             gauche
        \eb             mot-gauche
        \e\kl   mot-gauche
        \ew             mot-droite
        \e\kr   mot-droite
        \ei             insérer
        \ex             effacer
        \kx             effacer
        \eX             effacer-mot
        \ekx            effacer-mot
        \e\b            effacer-mot-arrière
        \e0             début
        \kh             début
        \e$             fin
        \ke             fin
        \ek             haut
        \ku             haut
        \ej             bas

La section des variables d'environnement commence par la ligne
#env
qui est suivie par une liste d'affectations de variables d'environnement. Chaque ligne est constituée d'un nom de variable d'environnement, d'un signe égal (=), et de la valeur à affecter à la variable d'environnement. Les caractères d'espacement situés avant et après le signe égal sont ignorés. Les variables affectées de cette façon ne sont visibles que par less. Si une variable est spécifiée dans l'environnement du système et aussi dans un fichier lesskey, la valeur située dans le fichier a priorité sur la variable d'environnement. Bien que le fichier lesskey puisse être utilisé pour surcharger les variables définies dans l'environnement, le principal objectif de l'affectation de variables dans le fichier de touches de less est de centraliser toutes les informations de configuration de less dans un fichier.

Le fichier d'entrée suivant spécifie l'option -i à chaque fois que less est lancé, et fixe le jeu de caractères utilisé à « latin1 »:

        #env
        LESS = -i
        LESSCHARSET = latin1

less(1)

Il n'est pas possible de spécifier des touches spéciales, comme la flèche vers le haut, d'une manière indépendante du clavier. La seule façon de spécifier de telles touches est de spécifier la séquence d'échappement qu'envoie un clavier particulier quand une telle touche est pressée.
Sur les systèmes MS-DOS et OS/2, certaines touches envoient une séquence de caractères qui débute par un caractère NUL (0). Ce caractère NUL devrait être représenté par \340 dans un fichier lesskey.

Copyright (C) 2000 Mark Nudelman
lesskey fait partie du projet GNU et est un logiciel libre. Vous pouvez le redistribuer et/ou le modifier sous les termes de la GNU General Public License comme publiée par la Free Software Foundation ; soit la version 2, soit (à votre convenance) n'importe quelle version ultérieure.
lesskey est distribué dans l'espoir qu'il soit utile, mais SANS AUCUNE GARANTIE ; sans même la garantie implicite de VALEUR MARCHANDE ou de CONVENANCE À UN USAGE PARTICULIER. Voyez la GNU General Public License pour plus de détails.
Vous devriez avoir reçu une copie de la GNU General Public License en même temps que lesskey ; voyez le fichier COPYING. Si ce n'est pas le cas, écrivez à la Free Software Foundation, 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

Mark Nudelman <markn@greenwoodsoftware.com>
Envoyez les rapports de bogues ou les commentaires à l'adresse ci-dessus, ou à bug-less@gnu.org.

Frédéric Delanoy <delanoy_f at yahoo.com>, 2002.