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’a été 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é en tant que 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 provoque l’affichage du numéro de version de lesskey et l’arrêt immédiat du 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 le type de la section. 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 <espace_blanche> action [chaîne_supplémentaire] <entrée>

Les espaces blanches sont constituées 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. La chaîne peut être une touche de commande unique, ou une séquence de plusieurs touches (jusqu’à 15). La chaîne 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 UP

\kD

PAGE DOWN

\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 \ 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 ensuite la chaîne de caractères supplémentaire est 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 renvoyée.

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

<

aller-Ã -la-ligne

\e<

aller-Ã -la-ligne

p

pourcentage

%

pourcentage

\e[

défilement-gauche

\e]

défilement-droite

\e(

défilement-gauche

\e)

défilement-droite

{

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

=

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-marqueur

’

aller-marqueur

^X^X

aller-marqueur

E

examiner

:e

examiner

^X^V

examiner

:n

fichier-suivant

:p

fichier-précédent

:x

fichier-index

-

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 ». En 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 forcera à ignorer toutes les commandes par défaut. La ligne #stop devrait être la dernière ligne 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 de nouvelles liaisons de touches pour les commandes d’édition de lignes, d’une façon similaire à celle dont les liaisons de touches pour les commandes ordinaires sont spécifiées dans la section #command. La section d’édition de ligne est constituée d’une liste de touches et d’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 lignes 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 espaces blanches situées avant et après le signe = sont ignorées. 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 est de centraliser toutes les informations de configuration de less dans un fichier.

Le fichier d’entrée suivant ajoute 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 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). Le 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.

less est distribué dans l’espoir qu’il soit utile, mais SANS AUCUNE GARANTIE ; ni même qu’il conviendra à 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 vous n’en disposez pas, écrivez à la Free Software Foundation, 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

Mark Nudelman <marknu@flash.net>
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>, 2001.