$ pr

Özet

pr [+page] [-column] [-adFfmprt] [[-e] [char] [gap]] [-L locale]
   [-h header] [[-i] [char] [gap]] [-l lines] [-o offset]
   [[-s] [char]] [[-n] [char] [width]] [-w width] [-] [file ...]

Açıklama

pr aracı, metin dosyaları için bir yazdırma ve sayfalama filtresidir. Birden fazla girdi dosyası belirtildiğinde her biri okunur, biçimlendirilir ve standart çıktıya yazılır.

Varsayılan olarak girdi, her biri aşağıdakileri içeren 66 satırlık sayfalara ayrılır:

• Sayfa numarası, tarih, saat ve dosyanın yol adını içeren 5 satırlık başlık.
• Boş satırlardan oluşan 5 satırlık altbilgi.

Standart çıktı bir terminal ile ilişkilendirilmişse, pr aracının işlemi tamamlanana kadar hata bildirimleri bastırılır.

Çoklu sütun çıktısı belirtildiğinde metin sütunları eşit genişliktedir. Varsayılan olarak metin sütunları en az bir boşlukla ayrılır. Bir metin sütununa sığmayan girdi satırları kırpılır. Tek sütunlu çıktıda satırlar kırpılmaz.

Seçenekler

Aşağıdaki seçenek açıklamalarında column, lines, offset, page ve width pozitif ondalık tam sayılardır; gap ise negatif olmayan bir ondalık tam sayıdır.

• +page: Biçimlendirilmiş girdinin page numaralı sayfasından çıktı vermeye başlar.

• -column: Girdi dosyasından metnin alınma sırasına göre, her sütundan aşağıya doğru dikey olarak yazılan, column sütun genişliğinde çıktı üretir. Varsayılan değer 1'dir. -e ve -i seçenekleri varsayılır. Bu seçenek -m ile birlikte kullanılmamalıdır. -t ile birlikte kullanıldığında çıktıyı görüntülemek için gereken minimum satır sayısı kullanılır. Metin dosyalarını daha genel bir şekilde ve ek biçimlendirme olmadan sütunlara ayırmak ve yeniden şekillendirmek için rs(1) aracına bakın.

• -a: Sütunların sayfa boyunca sırayla doldurulmasını sağlayacak şekilde -column seçeneğinin etkisini değiştirir. Örneğin column değeri 2 olduğunda, ilk girdi satırı sütun 1'in başına, ikincisi sütun 2'nin başına, üçüncüsü sütun 1'deki ikinci satıra gelir. Bu seçenek -column seçeneğinin kullanılmasını gerektirir.

• -d: Çift boşluklu çıktı üretir. Girdide bulunan her yeni satır karakterinin ardından fazladan bir yeni satır karakteri çıktıya yazılır.

• -e [char][gap]: Her girdi sekme karakterini, n * gap + 1 formülü ile belirtilen bir sonraki en büyük sütun konumuna genişletir; burada n, 0'dan büyük bir tam sayıdır. gap sıfırsa veya belirtilmemişse varsayılan değer 8'dir. Girdideki tüm sekme karakterleri uygun sayıda boşluk karakterine genişletilir. Rakam olmayan herhangi bir char karakteri belirtilirse, girdi sekme karakteri olarak o kullanılır.

• -F: Bir dizi yeni satır karakteri kullanan varsayılan davranış yerine, yeni sayfalar için bir sayfa besleme (form-feed) karakteri kullanır.

• -f: -F ile aynıdır, ancak standart çıktı bir terminal ise ilk sayfaya başlamadan önce duraklar.

• -h header: Başlık satırındaki dosya adının yerine header dizgesini kullanır.

• -i [char][gap]: Çıktıda, iki veya daha fazla ardışık boşluk gap + 1, 2 * gap + 1 gibi sütun konumlarına ulaştığında birden fazla boşluk karakterini sekme ile değiştirir. gap sıfırsa veya belirtilmemişse her sekizinci sütun konumundaki varsayılan sekme ayarları kullanılır. Rakam olmayan herhangi bir char karakteri belirtilirse çıktı sekme karakteri olarak o kullanılır.

• -L locale: Ortamda bulunan yerel ayar yerine locale argümanıyla belirtilen yerel ayarı kullanır. Yerel ayarı varsayılana sıfırlamak için C kullanın.

• -l lines: 66 satırlık varsayılan değeri geçersiz kılar ve sayfa uzunluğunu lines satır olarak ayarlar. lines değeri, başlık ve altbilgi derinliklerinin satır cinsinden toplamından büyük değilse pr, -t etkinmiş gibi hem başlığın hem de altbilginin çıktısını bastırır.

• -m: Birden fazla dosyanın içeriğini birleştirir. Her dosya işleneni tarafından belirtilen dosyalardan alınan birer satır, sütun konumlarının sayısı cinsinden eşit sabit genişlikteki metin sütunlarına yan yana yazılır. Metin sütunlarının sayısı başarıyla açılan dosya işleneni sayısına bağlıdır. Birleştirilen maksimum dosya sayısı, sayfa genişliğine ve işlem başına açık dosya sınırına bağlıdır. -e ve -i seçenekleri varsayılır.

• -n [char][width]: width basamaklı satır numaralandırması sağlar. Belirtilmemişse width için varsayılan değer 5'tir. Numara, her metin sütununun veya her -m çıktı satırının ilk width sütun konumunu kaplar. Rakam olmayan bir char verilirse, satır numarasını sonrasındaki içerikten ayırmak için satır numarasına eklenir. char için varsayılan karakter sekmedir. width sütunundan daha uzun olan satır numaraları kırpılır.

• -o offset: Çıktının her satırının önüne offset sayıda boşluk ekler. -o seçeneği belirtilmemişse varsayılan değer sıfırdır. Kaplanan alan, çıktı satırı genişliğine ek olarak değerlendirilir.

• -p: Standart çıktı bir terminal ise her sayfadan önce duraklar. pr, standart hataya bir uyarı karakteri yazar ve terminalde bir satırbaşı (carriage return) karakterinin okunmasını bekler.

• -r: Bir dosya açılamadığında hata raporu yazmaz.

• -s char: Metin sütunlarını uygun sayıda boşluk yerine tek bir char karakteri ile ayırır. char için varsayılan karakter sekmedir.

• -t: Genellikle her sayfa için sağlanan beş satırlık tanımlayıcı başlığı ve beş satırlık altbilgiyi yazdırmaz. Her dosyanın son satırından sonra sayfa sonuna kadar boşluk bırakmadan yazdırmayı sonlandırır.

• -w width: Yalnızca çoklu metin sütunu çıktısı için satır genişliğini width sütun konumuna ayarlar. -w belirtilmemişse ve -s de belirtilmemişse varsayılan genişlik 72'dir. -w belirtilmemişse ve -s belirtilmişse varsayılan genişlik 512'dir.

• file: Yazdırılacak dosyanın yol adıdır. Hiçbir dosya işleneni belirtilmemişse veya dosya işleneni - ise standart girdi kullanılır.

-s seçeneği, seçenek harfinin argümanından ayrılmasına izin vermez. -e, -i ve -n seçenekleri ise mevcut olmaları durumunda her iki argümanın da seçenek harfinden ayrılmamasını gerektirir.

Çıkış Durumu

pr aracı başarı durumunda 0, hata oluştuğunda ise >0 değeriyle çıkar.

Tanılama

pr, bir terminale yazdırırken kesme (interrupt) alırsa sonlanmadan önce birikmiş tüm hata mesajlarını ekrana boşaltır.

Hata mesajları, yazdırma işlemi sırasında standart hataya yazılır. Çıktı bir terminale yazdırılırken hata mesajları, tüm başarılı dosya yazdırma işlemleri tamamlandıktan sonra yazılır.

Eski Davranış Açıklaması

Sekme durağından (tab stop) önceki son boşluk bir sekme karakteri ile değiştirilir. Eski (legacy) modda ise değiştirilmez.

Eski mod hakkında daha fazla bilgi için compat(5) kılavuzuna bakın.

Ayrıca Bakınız

cat(1), more(1), rs(1), compat(5)

Standartlar

pr aracı, IEEE Std 1003.1-2001 (POSIX.1) ile uyumludur.

Tarihçe

Version 1 AT&T UNIX sürümünde bir pr komutu yer almıştır.

Hatalar

pr aracı, çoklu bayt (multibyte) karakterleri tanımaz.