.\" -*- coding: UTF-8 -*-
'\" t
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH LESSKEY 1 "Version 679 : 28 mai 2025"  
.SH NOM
lesskey — Personnalisation des raccourcis clavier de less
.SH "SYNOPSIS (obsolète)"
\fBlesskey [\-o sortie] [\-\-] [entrée]\fP
.br
\fBlesskey [\-\-output=sortie] [\-\-] [entrée]\fP
.br
\fBlesskey \-V\fP
.br
\fBlesskey \-\-version\fP
.SH PORTÉE
Ce document décrit le format du fichier source de \fBlesskey\fP utilisé par
\fBless\fP(1) à partir de la version 582. Dans les versions précédentes de
\fBless\fP(1), un programme séparé nommé \fBlesskey\fP était utilisé pour compiler
le fichier source de \fBlesskey\fP en un format compréhensible par
\fBless\fP(1). Cette phase de compilation n’étant plus nécessaire, le programme
\fBlesskey\fP est obsolète, bien que le format du fichier soit toujours pris en
charge par \fBless\fP(1).
.PP
.SH DESCRIPTION
Un fichier \fIlesskey\fP permet de spécifier un ensemble de raccourcis clavier
et de variables d’environnement à utiliser lors d’une invocation de
\fBless\fP(1).
.SH "FORMAT DU FICHIER"
Le fichier d’entrée se compose d’une ou plusieurs sections. Chacune d’entre
elles commence par une ligne qui identifie le type de la section. Les types
de section valables sont :
.IP \fB#command\fP
Personnalisation des raccourcis clavier pour les commandes.
.IP \fB#line\-edit\fP
Personnalisation des raccourcis clavier pour l’édition de ligne.
.IP \fB#env\fP
Définition de variables d’environnement.
.PP
Les lignes vides sont ignorées. Tout texte dans une ligne qui suit un
croisillon (#) est ignoré, sauf dans les cas indiqués ci\-après.
.
.SH "SECTION DE COMMANDES"
La section de commandes débute par la ligne
.sp
\fB#command\fP
.sp
Si la section de commandes est la première du fichier, cette ligne peut être
omise. La section de commandes se compose de lignes de la forme :
.sp
  \fIchaîne\fP <blanc> \fIaction\fP <blanc>
[[chaîne_supplémentaire] <caractère_nouvelle_ligne>
.sp
Les blancs sont constitués de n’importe quelle séquence d’une ou plusieurs
espaces et/ou tabulations. La \fIchaîne\fP contient les touches de commande qui
invoquent l’\fIaction\fP. Il peut s’agir d’une touche de commande unique ou
d’une séquence de plusieurs touches (jusqu’à 15). L’\fIaction\fP est le nom de
l’action de \fBless\fP(1) issue des listes des sections EXEMPLE ci\-après. Les
caractères de la \fIchaîne\fP peuvent apparaître littéralement ou préfixés par
un caret (^) pour indiquer une touche de contrôle. Une barre oblique
inversée suivie d’un à trois chiffres octaux permet de spécifier un
caractère par sa valeur octale. Une barre oblique inversée suivie de
certains caractères spécifie les caractères d’entrée comme suit :
.RS 5m
.TS
l l l.
\eb	RETOUR ARRIÈRE	(0x08)
\ee	ÉCHAPPEMENT	(0x1B)
\en	SAUT DE LIGNE	(0x0A)
\er	RETOUR	(0x0D)
\et	TABULATION	(0x09)
.TE
.sp
\ek suivi d’un unique caractère représente le ou les caractères produits
lorsqu’une de ces touches est pressée :
.TS
l l.
\ekb	RETOUR ARRIÈRE (la touche RETOUR_ARRIÈRE)
\ekB	Ctrl\-RETOUR_ARRIÈRE
\ekd	FLÈCHE_BAS
\ekD	PAGE_SUIVANTE
\eke	FIN
\ekh	DÉBUT
\eki	INSERTION
\ekl	FLÈCHE_GAUCHE
\ekL	Ctrl\-FLÈCHE_GAUCHE
\ekr	FLÈCHE_DROITE
\ekR	Ctrl\-FLÈCHE_DROITE
\ekt	TABULATION_ARRIÈRE
\eku	FLÈCHE_HAUT
\ekU	PAGE_PRÉCÉDENTE
\ekx	SUPPRESSION
\ekX	Ctrl\-SUPPRESSION
\ek1	F1
.TE

.PP
Une barre oblique inversée suivie de n’importe quel autre caractère indique
que ce dernier doit être considéré littéralement. Les caractères qui doivent
être précédés d’une barre oblique inversée comprennent le caret (^),
l’espace, la tabulation, le croisillon (#) et la barre oblique inversée
elle\-même.
.PP
Une action peut être suivie d’une chaîne supplémentaire. Quand une telle
commande est entrée pendant l’exécution de \fBless\fP(1), l’action est
effectuée, puis la chaîne supplémentaire est analysée comme si elle avait
été tapée dans \fBless\fP(1). 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\-après. La chaîne
supplémentaire a une signification spéciale pour l’action « quit » : quand
\fBless\fP(1) se termine, la valeur ASCII du premier caractère de la chaîne
supplémentaire est utilisée comme code de retour.
.
.SH EXEMPLE
Le fichier d’entrée suivant décrit l’ensemble des touches de commande par
défaut utilisé par \fBless\fP(1). La documentation de chaque commande se trouve
dans la page de manuel de \fBless\fP(1) dans la description de la séquence de
touches qui invoque la commande.
.sp
.RS 5m
.TS
l l.
\fB#command\fP
\er	forw\-line
\en	forw\-line
e	forw\-line
j	forw\-line
\ekd	forw\-line
^E	forw\-line
^N	forw\-line
k	back\-line
y	back\-line
^Y	back\-line
^K	back\-line
^P	back\-line
J	forw\-line\-force
K	back\-line\-force
Y	back\-line\-force
\eej	forw\-newline
\eek	back\-newline
d	forw\-scroll
^D	forw\-scroll
u	back\-scroll
^U	back\-scroll
\e40	forw\-screen
f	forw\-screen
^F	forw\-screen
^V	forw\-screen
\ekD	forw\-screen
b	back\-screen
^B	back\-screen
\eev	back\-screen
\ekU	back\-screen
z	forw\-window
w	back\-window
\ee\e40	forw\-screen\-force
\eeb	back\-screen\-force
F	forw\-forever
\eeF	forw\-until\-hilite
R	repaint\-flush
r	repaint
^R	repaint
^L	repaint
\eeu	undo\-hilite
\eeU	clear\-search
g	goto\-line
\ekh	goto\-line
<	goto\-line
\ee<	goto\-line
p	percent
%	percent
\ee(	left\-scroll
\ee)	right\-scroll
\ekl	left\-scroll
\ekr	right\-scroll
\ee{	no\-scroll
\ee}	end\-scroll
{	forw\-bracket {}
}	back\-bracket {}
(	forw\-bracket ()
)	back\-bracket ()
[	forw\-bracket []
]	back\-bracket []
\ee^F	forw\-bracket
\ee^B	back\-bracket
G	goto\-end
\ee>	goto\-end
>	goto\-end
\eke	goto\-end
\eeG	goto\-end\-buffered
\&=	status
^G	status
:f	status
/	forw\-search
?	back\-search
\ee/	forw\-search *
\ee?	back\-search *
n	repeat\-search
\een	repeat\-search\-all
N	reverse\-search
\eeN	reverse\-search\-all
^O^N	osc8\-forw\-search
^On	osc8\-forw\-search
^O^P	osc8\-back\-search
^Op	osc8\-back\-search
^O^O	osc8\-open
&	filter
m	set\-mark
M	set\-mark\-bottom
\eem	clear\-mark
\&'	goto\-mark
^X^X	goto\-mark
E	examine
:e	examine
^X^V	examine
:n	next\-file
:p	prev\-file
t	next\-tag
T	prev\-tag
:x	index\-file
:d	remove\-file
\-	toggle\-option
:t	toggle\-option t
s	toggle\-option o
	## Utiliser un nom d’option long en faisant débuter la 
	## chaîne supplémentaire avec UN tiret ; par exemple :
	##   s toggle\-option \-log\-file\en
\&_	display\-option
|	pipe
v	visual
!	shell
#	pshell
+	firstcmd
\ee[M	mouse
\ee[<	mouse6
H	help
h	help
V	version
0	digit
1	digit
2	digit
3	digit
4	digit
5	digit
6	digit
7	digit
8	digit
9	digit
q	quit
Q	quit
:q	quit
:Q	quit
ZZ	quit
.TE
.RE
.sp
.SH PRIORITÉ
Les commandes spécifiées par \fBlesskey\fP 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 » (non valable). Une touche
peut aussi être définie pour ne rien faire en utilisant l’action
« noaction » (pas d’action). « noaction » est similaire à « invalid »,
excepté que \fBless\fP(1) émettra un bip d’erreur pour une commande
« invalid », alors qu’il ne le fera 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 :
.sp
\fB#stop\fP
.sp
Cette ligne aura pour effet que toutes les commandes par défauts seront
ignorées. La ligne #stop doit être la dernière de cette section du fichier.
.PP
Soyez conscient que la ligne #stop peut être dangereuse. Comme toutes les
commandes par défaut sont désactivées, vous devez fournir suffisamment de
commandes avant la ligne #stop pour activer toutes les actions
nécessaires. Par exemple, ne pas fournir de commande « quit » (quitter) peut
s’avérer assez gênant.
.
.SH "SECTION D’ÉDITION DE LIGNE"
La section d’édition de ligne commence par la ligne :
.sp
\fB#line\-edit\fP
.sp
Cette section spécifie de nouveaux raccourcis clavier pour les commandes
d’édition de ligne d’une manière similaire à celle dont les raccourcis
clavier pour les commandes ordinaires sont spécifiées dans la section
#command. La section d’édition de ligne consiste en une liste de paires
touche/action, une paire par ligne, comme dans l’exemple ci\-après.
.
.SH EXEMPLE
Le fichier d’entrée suivant décrit l’ensemble des touches d’édition de ligne
par défaut utilisé par \fBless\fP(1) :
.sp
.RS 5m
.TS
l l.
\fB#line\-edit\fP
\et	forw\-complete
\e17	back\-complete
\ee\et	back\-complete
^L	expand
^V	literal
^A	literal
\eel	right
\ekr	right
\eeh	left
\ekl	left
\eeb	word\-left
\ee\ekl	word\-left
\eew	word\-right
\ee\ekr	word\-right
\eei	insert
\eex	delete
\ekx	delete
\eeX	word\-delete
\eekx	word\-delete
\ee\eb	word\-backspace
\ee0	home
\ekh	home
\ee$	end
\eke	end
\eek	up
\eku	up
\eej	down
^G	abort
\ee[M	mouse
\ee[<	mouse6
.TE
.RE
.sp
.
.SH "VARIABLES D’ENVIRONNEMENT DE LESS"
La section des variables d’environnement commence par la ligne
.sp
\fB#env\fP
.sp
Cette ligne est suivie d’une liste de définitions de variables
d’environnement. Chaque ligne comporte un nom de variable d’environnement,
un signe égal (=) et la valeur à affecter à la variable d’environnement. Les
blancs situés avant et après le signe égal sont ignorés. Les variables
définies de cette façon ne sont visibles que par \fBless\fP(1). Si une variable
est spécifiée à la fois dans l’environnement du système et dans un fichier
\fIlesskey\fP, c’est la valeur définie dans le fichier \fIlesskey\fP qui a
priorité.
.
.sp
Si, à la place de =, le nom de la variable est suivi de +=, la chaîne est
concaténée à la valeur actuelle de la variable. Cette opération ne
fonctionne actuellement que si la ligne contenant += suit immédiatement la
définition originelle de la même variable (dans une ligne contenant =), sans
définitions d’autres variables intercalées. Elle n’est possible que pour une
variable définie dans le fichier, pas pour une variable de l’environnement
du système. La chaîne est concaténée littéralement sans ajout de blanc ; si
un blanc est souhaité, il devra être ajouté à la fin de la ligne précédente
(il ne peut pas être ajouté au début de la chaîne +=, car un blanc après le
signe égal est ignoré, comme indiqué ci\-avant).
.
.sp
Dans la chaîne située après le signe égal, une sous\-chaîne de la forme
${NOM_VAR} sera remplacée par la valeur de la variable d’environnement
\fINOM_VAR\fP. La valeur de la variable peut provenir de l’environnement du
système, d’un fichier \fIlesskey\fP précédent ou d’une définition précédente
dans le fichier \fIlesskey\fP actuel. Des remplacements de texte simples
peuvent être effectués en utilisant la syntaxe
${NOM_VAR/CHAINE_ORIG/CHAINE_REMPL}. Cette dernière remplace toutes les
occurrences de « CHAINE_ORIG » dans la variable d’environnement \fINOM_VAR\fP
par la chaîne « CHAINE_REMPL ». « CHAINE_ORIG » est recherchée en effectuant
une simple comparaison de textes ; les métacaractères ne sont pas pris en
charge. Toute occurrence de barre oblique (/) ou d’accolade fermante (})
dans « CHAINE_ORIG » ou « CHAINE_REMPL » doit être protégée en la faisant
précéder de DEUX barres obliques inversées. Si « CHAINE_REMPL » est vide,
toutes les occurrences de « CHAINE_ORIG » seront supprimées. La présence
d’une barre oblique immédiatement avant l’accolade fermante n’est pas
obligatoire. Il est possible d’effectuer des remplacements multiples en
utilisant la syntaxe
${NOM_VAR/CHAINE_ORIG1/CHAINE_REMPL1/CHAINE_ORIG2/CHAINE_REMPL2/
\&... CHAINE_ORIGn/CHAINE_REMPLn}.
.
.SH "CONFIGURATION CONDITIONNELLE"
Si une ligne commence par « #version » suivi d’un opérateur de comparaison
et d’un numéro de version, le reste de la ligne ne sera traité que si la
version de l’instance de \fBless\fP(1) (ou \fBlesskey\fP) en cours d’exécution
satisfait à la condition, ce qui peut s’avérer utile dans le cas où un
fichier \fIlesskey\fP est utilisé par différentes versions de \fBless\fP(1).
.sp
Supposons par exemple qu’une nouvelle commande « sideways\-search » a été
ajoutée dans la version 777 de \fBless\fP(1) ; la ligne suivante assignera
alors la nouvelle commande à la touche Q, mais seulement pour les versions
de \fBless\fP(1) qui la prennent en charge et elle sera ignorée des versions de
\fBless\fP(1) antérieures à 777.
.sp
.nf
	#version >= 777  Q sideways\-search
.fi
.sp
Six opérateurs de comparaison sont pris en charge :
.RS 5m
.TS
l l.
 >	Supérieure à
 <	Inférieure à
 >=	Supérieure ou égale à
 <=	Inférieure ou égale à
 =	Égale à
 !=	Différente de
.TE
.RE
.sp
La fonctionnalité « #version » est prise en charge à partir de la
version 594 de \fBless\fP(1) et \fBlesskey\fP. Dans les versions antérieures,
toutes les lignes commençant par « #version » seront ignorées.
.
.SH EXEMPLE
Le fichier d’entrée suivant active les options \-i et \-S à chaque exécution
de \fBless\fP(1) et ajoute une option \-\-color pour les versions 595 et
ultérieures.
.sp
.nf
	#env
	## Notez qu’il doit y avoir une espace à la fin de la ligne suivante
	## pour séparer l’option \-\-color de l’option \-S.
	LESS = \-i\ \-S\ 	#version\ >=\ 595\ \ LESS\ +=\ \-\-color=Hkc
.fi
.
.SH "VOIR AUSSI"
\fBless\fP(1)
.
.SH AVERTISSEMENTS
Sur les systèmes MS\-DOS et OS/2, certaines touches envoient une séquence de
caractères qui commence par le caractère NUL (NDT : de code ASCII 0). Ce
caractère NUL doit être représenté sous la forme \e340 dans un fichier
\fIlesskey\fP.
.
.SH COPYRIGHT
Copyright (C) 1984\-2025 Mark Nudelman
.PP
\fBless\fP(1) 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 ou de la Less
License. Voir le fichier \fIREADME\fP dans la distribution de \fBless\fP(1) pour
plus de détails à propos de la redistribution. Vous devriez avoir reçu une
copie de la GNU General Public License en même temps que \fBless\fP(1) ; voir
le fichier \fICOPYING\fP. Si ce n'est pas le cas, écrivez à la Free Software
Foundation, 59 Temple Place, Suite 330, Boston, MA 02111\-1307, USA. Vous
devriez aussi avoir reçu une copie de la Less License ; voir le fichier
\fILICENSE\fP.
.PP
\fBless\fP(1) est distribué dans le but d’être utile, mais SANS AUCUNE
GARANTIE ; sans même une quelconque garantie de QUALITÉ MARCHANDE ou
D’ADÉQUATION À UNE UTILISATION PARTICULIÈRE. Consulter la GNU General Public
License pour plus de détails.
.
.SH AUTEUR
.
Mark Nudelman
.br
Envoyez les rapports de bogue à
.UR https://github.com/gwsw/less/issues
.UE .
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Lucien Gentis <lucien.gentis@univ-lorraine.fr>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .