.\" -*- coding: UTF-8 -*-
'\" t
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH LESSKEY 1 "wersja 590: 03 czerwca 2021"  
.SH NAZWA
lesskey \- określ przypisanie klawiszy dla less
.SH "SKŁADNIA (przestarzała)"
\fBlesskey\fP [\fB\-o\fP \fIwyjście\fP] [\fB\-\-\fP] [\fIwejście\fP]
.br
\fBlesskey\fP [\fB\-\-output=\fP\fIwyjście\fP] [\fB\-\-\fP] [\fIwejście\fP]
.br
\fBlesskey \-V\fP
.br
\fBlesskey \-\-version\fP
.SH ZAKRES
Niniejszy dokument opisuje format pliku źródłowego \fIlesskey\fP, który jest
używany przez \fBless\fP w wersji 582 i późniejszych. W poprzednich wersjach
\fBless\fP, do skompilowania pliku źródłowego \fIlesskey\fP, do formatu
zrozumiałego dla \fBless\fP, służył oddzielny program zwany \fBlesskey\fP. Obecnie
krok kompilacji jest zbędny, dlatego program \fBlesskey\fP jest uważany za
przestarzały, choć format pliku pozostaje obsługiwany, tyle że przez sam
program \fBless\fP.
.PP
.SH "FORMAT PLIKU"
Plik wejściowy składa się z jednej lub więcej \fIsekcji\fP.  Każda sekcja
zaczyna się od wiersza identyfikującego jej typ.  Możliwymi sekcjami są:
.IP #command
Definiuje nowe klawisze komend.
.IP #line\-edit
Definiuje nowe klawisze edycji wiersza.
.IP #env
Definiuje zmienne środowiska.
.PP
Wiersze puste i rozpoczynające się od znaku krzyżyka (#) są ignorowane, z
wyjątkiem specjalnych wierszy nagłówkowych sekcji.
.
.SH "SEKCJA KOMEND"
Sekcja komend rozpoczyna się od wiersza
.sp
#command
.sp
Jeżeli sekcja komend jest pierwszą sekcją w pliku, to wiersz ten może zostać
pominięty.  Sekcja komend składa się z wierszy o postaci:
.sp
    \fIłańcuch\fP <biały\-znak> \fIakcja\fP [dodatkowy\-łańcuch]
<nowy\-wiersz>
.sp
Biały znak jest dowolnym ciągiem jednego lub więcej znaków spacji i/lub
tabulacji.  \fIłańcuch\fP jest klawiszem (klawiszami) wywołującym daną akcję.
\fIłańcuch\fP może być pojedynczym klawiszem komendy lub sekwencją co najwyżej
15 klawiszy.  \fIakcja\fP jest nazwą akcji less, z poniżej podanej listy.
Znaki \fIłańcucha\fP mogą występować dosłownie albo być poprzedzone znakiem
daszku (^) wskazującym na klawisz sterujący (złożenie z Ctrl).  Do zapisu
znaku poprzez jego wartość ósemkową można posłużyć się znakiem odwrotnego
ukośnika (backslash) i jedną do trzech cyfr ósemkowych.  Odwrotny ukośnik w
połączeniu z pewnymi znakami określa następujące znaki wejściowe:
.IP \eb
BACKSPACE
.IP \ee
ESCAPE
.IP \en
NOWY WIERSZ
.IP \er
RETURN
.IP \et
TABULATOR
.IP \eku
STRZAŁKA_W_GÓRĘ
.IP \ekd
STRZAŁKA_W_DÓŁ
.IP \ekr
STRZAŁKA_W_PRAWO
.IP \ekl
STRZAŁKA_W_LEWO
.IP \ekU
PAGE UP (strona w górę)
.IP \ekD
PAGE DOWN (strona w dół)
.IP \ekh
HOME
.IP \eke
END
.IP \ekx
DELETE
.PP
Odwrotny ukośnik poprzedzający dowolny inny znak oznacza, że znak ten
powinien zostać potraktowany dosłownie.  Wśród znaków, które muszą być
poprzedzone odwrotnym ukośnikiem występują daszek (^), spacja, znak
tabulacji i sam odwrotny ukośnik.
.PP
Po akcji może wystąpić \[Bq]dodatkowy\[rq] łańcuch.  Jeśli wprowadzona
zostanie taka komenda podczas pracy z \fIless\fP, to wykonywana jest akcja, a
następnie analizowany jest podany dodatkowy łańcuch, tak jak gdyby został on
naciśnięty (wpisany do \fIless\fP).  Właściwość ta może posłużyć w pewnych
przypadkach do poszerzenia funkcjonalności komendy.  Proszę sprawdzić
komendy \[Bq]{\[rq] i \[Bq]:t\[rq] w przykładzie poniżej.  Dla akcji
\[Bq]quit\[rq] dodatkowy łańcuch ma znaczenie specjalne: gdy \fIless\fP kończy
pracę, pierwszy znak tego dodatkowego łańcucha używany jest jako status
zakończenia.
.
.SH PRZYKŁAD
Poniższy plik wejściowy opisuje zestaw domyślnych klawiszy komend używany
przez less:
.sp
.RS 5m
.TS
l l.
#command
\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
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
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
\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
&	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
\&_	display\-option
|	pipe
v	visual
!	shell
+	firstcmd
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 PRIORYTET
Komendy określone przez \fIlesskey\fP mają pierwszeństwo przed komendami
domyślnymi.  Domyślny klawisz komendy może zostać wyłączony przez zawarcie
go w pliku wejściowym z przypisaną akcją \[Bq]invalid\[rq] (niepoprawny).
Alternatywnie, można zdefiniować, by klawisz nie robił niczego, przypisując
mu akcję \[Bq]noaction\[rq] (bez akcji).  \[Bq]noaction\[rq] jest podobne do
\[Bq]invalid\[rq], lecz \fIless\fP będzie sygnalizował dźwiękiem błąd dla
\[Bq]niepoprawnej\[rq] komendy, czego nie czyni dla komendy \[Bq]bez
akcji\[rq].  Dodatkowo, można wyłączyć WSZYSTKIE domyślne komendy włączając
do pliku wejściowego taki wiersz sterujący:
.sp
#stop
.sp
Spowoduje to, że wszystkie komendy domyślne będą ignorowane.  Wiersz #stop
powinien być ostatnim wierszem w tej sekcji pliku.
.PP
Należy być świadomym tego, że #stop może być niebezpieczne. Ponieważ
wyłączone są wszystkie domyślne komendy, należy zapewnić wystarczający
zestaw komend przed wierszem #stop, tak by udostępnić wszelkie niezbędne
akcje.  Na przykład, zaniedbanie dostarczenia komendy \[Bq]quit\[rq] może
prowadzić do frustracji.
.
.SH "SEKCJA EDYCJI WIERSZA"
Sekcja edycji wiersza rozpoczyna się wierszem:
.sp
#line\-edit
.sp
Sekcja ta określa nowe przypisania klawiszy dla komend edycji wiersza, w
sposób podobny do przypisań klawiszy do zwykłych komend w sekcji #command.
Sekcja edycji wiersza składa się z listy klawiszy i akcji, po jednej parze
na wiersz, tak jak w przykładzie poniżej.
.
.SH PRZYKŁAD
Poniższy plik wejściowy opisuje zestaw domyślnych klawiszy edycji wiersza
używany przez less:
.sp
.RS 5m
.TS
l l.
#line\-edit
\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
.TE
.RE
.sp
.
.SH "ZMIENNE ŚRODOWISKA LESS"
Sekcja zmiennych środowiska rozpoczyna się wierszem
.sp
#env
.sp
Po nim występuje lista przypisań wartości dla zmiennych środowiskowych.
Każdy wiersz składa się z nazwy zmiennej środowiska, znaku równości (=)
oraz wartości, jaka ma zostać przypisana tej zmiennej.  Zmienne przypisane w
ten sposób widoczne są wyłącznie dla \fIless\fP.  Jeżeli dana zmienna określona
jest w środowisku systemowym i równocześnie w pliku lesskey, to
pierwszeństwo ma jej wartość z pliku lesskey.  Mimo, że plik lesskey może
służyć do nadpisywania zestawu zmiennych ze środowiska systemu, to głównym
celem nadawania wartości zmiennym w lesskey jest po prostu przechowywanie
całej informacji konfiguracyjnej dla \fIless\fP w jednym pliku.
.
.SH PRZYKŁAD
Poniższy plik wejściowy ustawia opcję \-i podczas uruchamiania \fIless\fP oraz
podaje, że używanym zestawem znaków ma być \[Bq]latin1\[rq]:
.sp
.nf
	#env
	LESS = \-i
	LESSCHARSET = latin1
.fi
.sp
.
.SH "ZOBACZ TAKŻE"
\fBless\fP(1)
.
.SH OSTRZEŻENIA
W systemach MS\-DOS i OS/2 pewne klawisze wysyłają sekwencje rozpoczynające
się od znaku NUL (0).  Taki znak NUL w pliku lesskey powinien być
reprezentowany przez \e340.
.
.SH PRAWA\ AUTORSKIE
Copyright (C) 1984\-2021 Mark Nudelman
.PP
less jest częścią projektu GNU i stanowi wolne oprogramowanie. Można go
rozprowadzać dalej i/lub modyfikować na warunkach albo (1) Powszechnej
Licencji Publicznej GNU, wydanej przez Fundację Wolnego Oprogramowania, albo
(2) Licencji Less. Szczegóły dotyczące rozprowadzania znajdują się w pliku
README pakietu dystrybucyjnego less. Wraz z less powinieneś otrzymać
egzemplarz Powszechnej Licencji Publicznej GNU (GNU General Public License)
\- zobacz plik COPYING. Jeśli nie \- napisz do Free Software Foundation, 59
Temple Place, Suite 330, Boston, MA 02111\-1307, USA. Powinieneś także
otrzymać kopię Licencji Less \- zobacz plik LICENSE.
.PP
less rozpowszechniany jest z nadzieją, iż będzie użyteczny \- jednak BEZ
JAKIEJKOLWIEK GWARANCJI, nawet domyślnej gwarancji PRZYDATNOŚCI HANDLOWEJ
albo PRZYDATNOŚCI DO OKREŚLONYCH ZASTOSOWAŃ. W celu uzyskania bliższych
informacji sięgnij do Powszechnej Licencji Publicznej GNU.
.
.SH AUTOR
.
Mark Nudelman
.br
Błędy prosimy zgłaszać pod adresem https://github.com/gwsw/less/issues
.PP
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
Wojtek Kotwica <wkotwica@post.pl>,
Robert Luberda <robert@debian.org>
i
Michał Kułach <michal.kulach@gmail.com>
.
.PP
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
.PP
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy
dyskusyjnej
.MT manpages-pl-list@lists.sourceforge.net
.ME .
