.\" {PTM/LK/0.1/30-01-1999/"program do czytania poczty"}
.\" Tumaczenie: 30-01-1999 ukasz Kowalczyk (lukow@tempac.okwf.fuw.edu.pl)
.TH pine 1 "Wersja 4.04"
.SH NAZWA
pine \- program do czytania grup dyskusyjnych i poczty elektronicznej
.SH SKADNIA

.B pine
[
.I opcje
] [
.I adres
,
.I adres
] 

.B pinef
[
.I opcje
] [
.I adres
,
.I adres
]
.SH OPIS

Pine jest penoekranowym programem do czytania wiadomoci. W swojej
domylnej konfiguracji Pine prezentuje celowo ograniczony zestaw opcji
przeznaczony dla pocztkujcego uytkownika. Istnieje jednak wci rosnca
lista opcjonalnych moliwoci przeznaczonych dla zaawansowanych uytkownikw.
.I pinef 
jest wersj programu Pine uywajcym klawiszy funkcyjnych zamiast
jednoliterowych polece.
W podstawowym zestawie polece znajduj si nastpujce opcje:
.IP
View (przegldanie), Save (zapis), Export (zapis do pliku), 
Delete (usuwanie), Print (drukowanie), Reply (odpowiadanie) i 
Forward (dalsze przesyanie wiadomoci).
.IP
Tworzenie wiadomoci w prostym edytorze (Pico) z automatycznym amaniem
linii i kontrol pisowni. Edycja wiadomoci moe by odkadana do
pniejszej kontynuacji.
.IP
Penoekranowy wybr i zarzdzanie folderami.
.IP
Ksika adresowa, w ktrej znajduj si czsto uywane lub po prostu dugie
adresy. Mona definiowa wasne listy dystrybucyjne. Adresy mog by
pobierane z otrzymywanych wiadomoci bez potrzeby odpowiadania na nie.
.IP
Sprawdzanie, czy otrzymano nowe wiadomoci jest wykonywane co 2.5 minuty
oraz po pewnych poleceniach, np. odwieaniu ekranu (Ctrl-L).
.IP
Kontekstowa pomoc.
.PP
Pine obsuguje MIME (Multipurpose Internet Mail Extensions), internetowy
standard reprezentacji wieloczciowych i multimedialnych danych w
wiadomociach. Pine pozwala na zapis obiektw MIME do plikw i w pewnych
sytuacjach moe uruchomi odpowiedni program do ogldania takich wiadomoci.
Pine uywa systemowego pliku konfiguracyjnego 
.I mailcap 
by uruchomi waciwy program do obsugi poszczeglnych obiektw MIME.
Wbudowany program do tworzenia wiadomoci nie posiada waciwoci
multimedialnych, lecz dowolny typ danych - wcznie z multimedialnymi - 
moe zosta umieszczony w wiadomoci jako zacznik. Pozwala to posiadaczom
programw pocztowych zgodnych z MIME na wymian sformatowanych dokumentw,
arkuszy kalkulacyjnych, plikw graficznych etc. przez poczt elektroniczn.
.PP
Do obsugi lokalnych i zdalnych folderw pocztowych Pine uywa interfejsu
.I c-client
(c-client messaging API).
Ta biblioteka pozwala na wykonywanie wielu niskopoziomowych funkcji obsugi
poczty, wczajc w to funkcje obsugi wielu formatw pocztowych, protokou
IMAP (Internet Message
Access Protocol) oraz NNTP (Network News Transport Protocol). Poczta
wychodzca jest zazwyczaj przekazywana programowi 
.IR sendmail ,
ale moe by wysyana bezporednio przez SMTP (Simple Mail Transfer Protocol).
.SH OPCJE
.if n .ta 2.8i
.if t .ta 2.1i
Pine rozpoznaje nastpujce opcje linii polece:
.IP \fIadres\fR 20
Wysanie wiadomoci na podany adres e-mailowy. Pine uruchomi si w trybie tworzenia
wiadomoci.
.IP \fB-a\fR 20
Specjalny anonimowy tryb dziaania dla UWIN* (* patrz niej)
.IP \fB-c\ \fInumer_kontekstu\fR 20
mumer_kontekstu jest numerem odnoszcym si do kolekcji folderw, do ktrego
powinien zosta zastosowany argument
.I -f
linii polece. Domylnie opcja
.I -f
jest stosowana do pierwszej zdefiniowanej kolekcji folderw.
.IP \fB-d\ \fIpoziom_diagnostyki\fR 20
Wypisywanie informacji diagnostycznych na poziomie 
.I poziom_diagnostyki
(0-9) do biecego pliku
.IR .pine-debug[1-4] .
Warto 0 wycza informacje diagnostyczne i wstrzymuje tworzenie pliku
.IR .pine-debug .

.IP \fB-d\ \fIklucz[=warto]\fR 20
Szczegowy opis tworzenia informacji diagnostycznych; "flush"
powoduje zapisywanie plikw diagnostycznych bez buforowania, "timestamp"
docza do kadego komunikatu czas jego wygenerowania, "imap=n" (gdzie n
przybiera wartoci od 0 do 4) powoduje doczanie telemetrii (ang.
telemetry) IMAP na podanym poziomie, "numfiles=n" (gdzie n przybiera
warto od 0 do 31) opisuje ilo tworzonych plikw diagnostycznych i
wreszcie "verbose=n" (gdzie n przybiera wartoci od 0 do 9) jest odwrotnym
progiem poziomu generowania oglnych wiadomoci o dziaaniu programu.
.IP \fB-f\ \fIfolder\fR 20
Otwarcie folderu (w pierwszej zdefiniowanej kolekcji folderw) zamiast INBOX.
.IP \fB-F\ \fIplik\fR 20
Otwarcie podanego pliku tekstowego w przegldarce programu Pine.
.IP \fB-h\fR 20
Pomoc: lista rozpoznawanych opcji linii polece.
.IP \fB-i\fR 20
Otwarcie indeksu folderw po uruchomieniu programu.
.IP \fB-I\ \fIklawisze\fR 20
Lista klawiszy (rozdzielona przecinkami), ktrych nacinicie Pine powinien
zasymulowa zaraz po uruchomieniu.
.IP \fB-k\fR 20
Wywoywanie polece klawiszami funkcyjnymi. Identyczne dziaanie ma
uruchomienie programu pinef.
.IP \fB-n\ \fInumer\fR 20
Uruchomienie programu z automatycznym otworzeniem wiadomoci o podanym
numerze.
.IP \fB-nr\fR 20
Specjalny tryb dla UWIN*
.IP \fB-o\fR 20
Otwarcie pierwszego folderu w trybie tylko do odczytu.
.IP \fB-p\ \fIplik_konfiguracyjny\fR 20
Uycie podanego pliku w charakterze pliku konfiguracyjnego zamiast
domylnego .pinerc.
.IP \fB-P\ \fIplik_konfiguracyjny\fR 20
Uycie podanego pliku w charakterze pliku konfiguracyjnego zamiast
domylnego pliku systemowego
.IR pine.conf .
.IP \fB-r\fR 20
Uruchomienie w trybie demonstracyjnym o ograniczonej funkcjonalnoci. 
.I Pine
bdzie wysya poczt tylko do siebie samego, a funkcje typu save i export
nie bd dziaay.
.IP \fB-z\fR 20
Udostpnienie moliwoci przeniesienia programu Pine do ta klawiszem ^Z lub
sygnaem SIGTSTP.
.IP \fB-conf\fR 20
Utworzenie wzorcowego pliku jako szablonu dla systemowego pliku
konfiguracyjnego
.I pine.conf
na standardowym wyjciu. Jest to inny plik ni indywidualny dla kadego
uytkownika 
.IR .pinerc .
.IP \fB-create_lu\ \fIksika_adresowa\ \fIporzdek_sortowania\fR 20
Utworzenie dodatkowego indeksu dla ksiki adresowej o podanej nazwie i
posortowanie jej w podanym porzdku. Moliwe wartoci dla porzdku
sortowania, to
.IR "dont-sort (brak sortowania)" ,
.IR "nickname (skrt nazwy adresata)" ,
.IR "fullname (pena nazwa adresata)" ,
.IR "nickname-with-lists-last (skrt nazwy, ale listy na kocu)" ,
or
.IR "fullname-with-lists-last (pena nazwa, ale listy na kocu)" .

Jest to uyteczne do tworzenia globalnych lub dzielonych ksiek adresowych.
Po utworzeniu w ten sposb indeksu, plik powinien zosta przeniesiony lub
skopiowany w taki sposb, by zmianie nie uleg czas modyfikacji. Czas
modyfikacji ksiki adresowej jest zachowywany w nowotworzonym pliku z
indeksem i przy kadym uruchomieniu programu sprawdzany. Jeeli czas
modyfikacji ksiki adresowej ulegnie zmianie, pine utworzy indeks od nowa.
Innymi sowy, po utworzeniu indeksu za pomoc opisywanej opcji, nie kopiuj
ksiki adresowej do jej docelowego pooenia w taki sposb, ktry zmieni
jej czas modyfikacji.
.IP \fB-pinerc\ \fIplik\fR 20
Zapisanie biecej konfiguracji programu do podanego pliku.
.IP \fB-sort\ \fIporzdek_sortowania\fR
Posortowanie ekranu FOLDER INDEX w jednej z nastpujcych kolejnoci:
.I arrival (czas nadejcia), subject (temat), from (pole from), date (data),
.I size (rozmiar), orderedsubj (pseudo wtek)
lub
.I reverse (odwrotna kolejno). Arrival
jest domylnym porzdkiem sortowania. Porzdek OrderedSubj symuluje
sortowanie pod ktem wtkw. Kady porzdek sortowania moe zosta odwrcony
przez dodanie do niego 
.IR /reverse .

.I Reverse
bez dodatkowych opcji dziaa jak
.IR arrival/reverse .
.IP \fI-option\=\fIwarto\fR 20
Nadanie opcji konfiguracyjnej podanej wartoci. Np. 
-signature-file=sig1 lub -feature-list=signature-at-bottom
(Uwaga: wartoci opcji feature-list s addytywne)
.PP
* UWIN = University of Washington Information Navigator
.SH KONFIGURACJA

Istnieje kilka poziomw konfiguracji programu Pine. Wartoci konfiguracyjne
na danym poziomie maj wyszy priorytet ni te wartoci na niszych poziomach.
W porzdku rosncego priorytetu:

 o wbudowane wartoci domylne.
.br
 o plik
.I pine.conf
dla caego systemu.
.br
 o osobisty plik
.I .pinerc 
kadego uytkownika (wartoci w nim mona ustawia za pomoc menu
Setup/Config).
.br
 o opcje linii polece
.br
 o plik
.I pine.conf.fixed
dla caego systemu.

Istnieje wyjtek od zasady, w myl ktrej wartoci konfiguracyjne s
zastpowane przez wartoci tych samych opcji o wyszym priorytecie: 
wartoci nadawane zmiennej feature-list s addytywne, lecz mog by
zanegowane doczeniem "no-" na pocztku danej wartoci dla tej zmiennej.
Pine w systemie Unix uywa nastpujcych zmiennych rodowiskowych.

  TERM
.br
  DISPLAY     (okrela, czy Pine moe wywietla zaczniki typu IMAGE).
.br
  SHELL       (domyln wartoci jest /bin/sh, jeeli ta zmienna nie jest
ustawiona).
.br
  MAILCAPS    (lista cieek do plikw mailcap rozdzielonych rednikami).
  
.SH PLIKI
.if n .ta 2.8i
.if t .ta 2.1i

/var/spool/mail/xxxx	Domylny folder dla przychodzcej poczty.
.br
~/mail	Domylny katalog dla folderw.
.br
~/.addressbook	Domylna nazwa pliku z ksik adresow.
.br
~/.addressbook.lu	Domylna nazwa pliku z indeksem ksiki adresowej.
.br
~/.pine-debug[1-4]	Pliki, do ktrych zapisywane s komunikaty diagnostyczne.
.br
~/.pinerc	Osobisty plik konfiguracyjny.
.br
~/.newsrc	Opis stanu subskrybowanych grup dyskusyjnych.
.br
~/.signature	Domylna nazwa pliku z sygnatur.
.br
~/.mailcap	Osobisty plik mailcap (man mailcap(4))
.br
~/.mime.types	Osobiste rozszerzenie rozpoznawanych typw MIME
.br
/etc/mailcap	Systemowy plik mailcap (man mailcap(4))
.br
/etc/mime.types	Systemowe opis rozpoznawanych typw MIME
.br
/usr/lib/pine.info	Lokalny wskanik do administratora systemu
.br
/usr/lib/pine.conf	Systemowy plik konfiguracyjny
.br
/usr/lib/pine.conf.fixed	 Plik konfiguracyjny, ktrego ustawienia nie mog by zmieniane
.br
/tmp/.\\var\\spool\\mail\\xxxx	Pliki blokujce dla kadego folderu
.br
~/.pine-interrupted-mail	Wiadomo, ktrej tworzenie zostao przerwane
.br
~/mail/postponed-msgs	Wiadomo, ktrej tworzenie zostao odoone na pniej
.br
~/mail/sent-mail	Archiwum wysanych wiadomoci
.br
~/mail/saved-messages	Domylny folder na zapisywane wiadomoci
.SH "ZOBACZ TAKE"

pico(1), binmail(1), aliases(5), mailaddr(7), sendmail(8), spell(1), imapd(8)

.br
Grupa dyskusyjna:  comp.mail.pine
.br
Pine Information Center:  http://www.washington.edu/pine
.br
Dystrybucja rdowa:  ftp://ftp.cac.washington.edu/pine/pine.tar.Z
.br
Pine Technical Notes (informacje techniczne), zawarte w dystrybucji rdowej
.br
Interfejs (API) biblioteki przesyania wiadomociC-Client, zawarty w
dytrybucji rdowej.
.SH PODZIKOWANIA
.na 
.nf

Zesp rozwoju programu Pine (cz UW Office 
of Computing & Communications) na Uniwersytecie w Waszyngtonie
(University of Washington):

.\" celowo nie przetumaczone

 Project Leader:           Mike Seibel.
 Principal authors:        Mike Seibel, Steve Hubert, Laurence Lundblade.
 C-Client library & IMAPd: Mark Crispin.
 Pico, the PIne COmposer:  Mike Seibel.
 Bug triage, user support: David Miller.
 Port integration:         David Miller.
 Documentation:            David Miller, Stefan Kramer, Kathryn Sharpe.
 PC-Pine for DOS:          Mike Seibel.
 PC-Pine for Windows:      Tom Unger.
 Project oversight:        Terry Gray.
 Principal Patrons:        Ron Johnson, Mike Bryant.
 Additional support:       NorthWestNet.
 Initial Pine code base:   Elm, by Dave Taylor & USENET Community Trust.
 Initial Pico code base:   MicroEmacs 3.6, by Dave G. Conroy.
 User Interface design:    Inspired by UCLA's "Ben" mailer for MVS.
 Suggestions/fixes/ports:  Folks from all over!

.\"Copyright 1989-1996 by the University of Washington.
.\"Pine and Pico are trademarks of the University of Washington.
Copyright 1989-1996 by the University of Washington.
Pine i Pico s zastrzeonymi znakami handlowymi Uniwersytetu w Waszyngtonie

98.05.06