Kozmetik değişiklikler, Sir I'm ready to go...

doc/pisi.lyx

@@ -345,8 +345,20 @@ Kurulum ve yap
  söz konusudur.
  Bu ayrı görevleri sorumluluk sınırları belirlenmiş ayrı araçların yerine
  getirmesi uygundur.
- Uludağ projesi için yapılandırma işlerini yürütecek araç ÇOMAR'dır.
+ Uludağ projesi için yapılandırma işlerini yürütecek araç 
- PİSİ bu görevleri ÇOMAR'a devredecektir.
+\series bold 
+ÇOMAR
+\series default 
+'dır.
+ 
+\series bold 
+PİSİ
+\series default 
+ bu görevleri
+\series bold 
+ ÇOMAR
+\series default 
+'a devredecektir.
 \layout Itemize
 
 
@@ -366,8 +378,12 @@ P
 Paket Oluşturma
 \layout Standard
 
-Bu kısımda bir PISI paketinin oluşturulması ve kullanılması esnasında gerek
+Bu kısımda bir 
- duyulacak meta dosyalar ve süreçler netleştirilmeye çalışılmıştır.
+\series bold 
+PİSİ
+\series default 
+ paketinin oluşturulması ve kullanılması esnasında gerek duyulacak meta
+ dosyalar ve süreçler netleştirilmeye çalışılmıştır.
 \layout Subsubsection
 
 PSPEC Dosyası
@@ -393,22 +409,50 @@ PSPEC
 \layout Standard
 
 Dosya biçimi XML'dir ve aşağıdaki etiketleri içerir.
- Her PSPEC dosyasında tüm etiketlerin bulunması zorunlu değildir.
+ Her 
- Bulunması zorunlu olan etiketler aşağıda (*) ile belirtilirler.
+\series bold 
+PSPEC
+\series default 
+ dosyasında tüm etiketlerin bulunması zorunlu değildir.
+ Bulunması zorunlu olan etiketler aşağıda (*) ile belirtilmiştir.
 \layout Standard
 
-PSPEC dosyaları PSPEC deposunda pakete ait dizinde 
+
+\series bold 
+PSPEC
+\series default 
+ dosyaları 
+\series bold 
+PSPEC
+\series default 
+ deposunda pakete ait dizinde 
 \series bold 
 pspec.xml
 \series default 
  adı ile tutulurlar.
 \layout Standard
 
-Her PSPEC dosyası PISI etiketi (tag) altında bir Source ve 
+Her 
+\series bold 
+PSPEC
+\series default 
+ dosyası 
+\series bold 
+PİSİ
+\series default 
+ etiketi (tag) altında bir 
+\emph on 
+Source
+\emph default 
+ ve 
 \bar under 
 en az
 \bar default 
- bir Package olmak üzere iki ana bölüm içermek zorundadırlar.
+ bir 
+\emph on 
+Package
+\emph default 
+ olmak üzere iki ana bölüm içermek zorundadırlar.
 \layout Paragraph
 
 PISI
@@ -515,7 +559,11 @@ IsA
 \series default 
  ile belirtilen aitlikleri yanlızca sorgulayabilirsiniz.
 \newline 
-Source ve Package tagları içerisinde yalnızca birer tane 
+
+\emph on 
+Source ve Package
+\emph default 
+ tagları içerisinde yalnızca birer tane 
 \series bold 
 PartOf
 \series default 
@@ -729,8 +777,20 @@ Update
 \series bold 
 Type:
 \series default 
- Güncellemenin tipini belirtir (Security, Bug, Enhancement, Normal v.s).
+ Güncellemenin tipini belirtir (
- Eğer bu etiket tanımlı değilse tip Normal olarak kabul edilir.
+\series bold 
+\emph on 
+Security, Bug, Enhancement, Normal
+\series default 
+\emph default 
+ v.s).
+ Eğer bu etiket tanımlı değilse tip 
+\series bold 
+\emph on 
+Normal
+\series default 
+\emph default 
+ olarak kabul edilir.
 \layout Itemize
 
 
@@ -763,7 +823,11 @@ Package:
  
 \series medium 
 Uygulamadan oluşturulacak bir pakedi tanımlar.
- Her PSPEC dosyası en az bir 
+ Her 
+\series default 
+PSPEC
+\series medium 
+ dosyası en az bir 
 \series default 
 Package
 \series medium 
@@ -772,51 +836,79 @@ Package
 
 Package
 \series medium 
- içerisindeki bazı taglar Source içerisindekileri tekrarlayabilir.
+ içerisindeki bazı taglar 
- Bu tekrarlamaların bazıları override edilirken (üzerine yazılırken) bazıları
+\emph on 
- merge (birleştirilecek) edilecek.
+Source
+\emph default 
+ içerisindekileri tekrarlayabilir.
+ Bu tekrarlamaların bazıları üzerine yazılırken (override) bazıları birleştirile
+cektir (merge).
 \layout Itemize
 
 
 \series bold 
 Name 
 \series default 
-(tanımlı ise Source bölümündekinin yerine kullanılır)
+(tanımlı ise 
+\emph on 
+Source
+\emph default 
+ bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
 \series bold 
 Summary 
 \series default 
-(tanımlı ise Source bölümündekinin yerine kullanılır)
+(tanımlı ise 
+\emph on 
+Source
+\emph default 
+ bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
 \series bold 
 Description 
 \series default 
-(tanımlı ise Source bölümündekinin yerine kullanılır)
+(tanımlı ise 
+\emph on 
+Source
+\emph default 
+ bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
 \series bold 
 License 
 \series default 
-(tanımlı ise Source bölümündekinin yerine kullanılır)
+(tanımlı ise 
+\emph on 
+Source
+\emph default 
+ bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
 \series bold 
 IsA 
 \series default 
-(tanımlı ise Source bölümündeki ile birleştirilir)
+(tanımlı ise 
+\emph on 
+Source
+\emph default 
+ bölümündeki ile birleştirilir)
 \layout Itemize
 
 
 \series bold 
 PartOf 
 \series default 
-(tanımlı ise Source bölümündekinin yerine kullanılır)
+(tanımlı ise 
+\emph on 
+Source
+\emph default 
+ bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
@@ -827,17 +919,26 @@ Conflicts:
  paketleri belirtir, bu örneğin aynı dosyayı iki paketin de taşıması durumunda
  olabilir.
  
+\begin_deeper 
+\layout Itemize
+
+
 \series bold 
 Package:
 \series default 
  Olmaması gereken paket adını verir.
+\end_deeper 
 \layout Itemize
 
 
 \series bold 
 Provides: 
 \series default 
-Paketin sağladığı ÇOMAR OM bacaklarının bir listesini verir.
+Paketin sağladığı 
+\series bold 
+ÇOMAR OM
+\series default 
+ bacaklarının bir listesini verir.
 \layout Itemize
 
 
@@ -854,7 +955,11 @@ RuntimeDependencies
 Dependency
 \series default 
 : Bir bağımlılık tanımlar.
- BuildDependency ile aynı yapıdadır
+ 
+\series bold 
+BuildDependency
+\series default 
+ ile aynı yapıdadır
 \end_deeper 
 \layout Itemize
 
@@ -872,7 +977,11 @@ InstallDependencies
 Dependency
 \series default 
 : Bir bağımlılık tanımlar.
- BuildDependency ile aynı yapıdadır
+ 
+\series bold 
+BuildDependency
+\series default 
+ ile aynı yapıdadır
 \end_deeper 
 \layout Itemize
 
@@ -1220,11 +1329,33 @@ en
 </PISI>
 \layout Standard
 
-Yukarıdaki örnek dosyada Package içerisinde tanımlanmayan taglar Source
+Yukarıdaki örnek dosyada 
+\emph on 
+Package
+\emph default 
+ içerisinde tanımlanmayan taglar 
+\emph on 
+Source
+\emph default 
  içerisinden alınarak kullanılacaktır.
- Bir kaynak paketten birden fazla ikili (binary) paket oluşturmak için Package
+ Bir kaynak paketten birden fazla ikili (binary) paket oluşturmak için 
+\emph on 
+Package
+\emph default 
  etiketleri farklı isimler (Name) verilerek arttırılabilir.
- Paketler Files içerisinde bulunan Path taglarına göre bölümlendirilecektir.
+ 
+\emph on 
+Paketler
+\emph default 
+ 
+\series bold 
+Files
+\series default 
+ içerisinde bulunan 
+\series bold 
+Path
+\series default 
+ taglarına göre bölümlendirilecektir.
 \layout Subsubsection
 
 actions.py Dosyası
@@ -1261,7 +1392,7 @@ P
 \series bold 
 API
 \series default 
- actionsapi adında sunulacaktır.
+ ActionsAPI adında sunulacaktır.
 \layout Paragraph
 
 Örnek bir actions.py dosyası:
@@ -1397,7 +1528,15 @@ PISI
 
 Source: 
 \series medium 
-Bu bölümdeki bilgiler PSPEC dosyasının Source bölümünden alınır.
+Bu bölümdeki bilgiler 
+\series default 
+PSPEC
+\series medium 
+ dosyasının 
+\emph on 
+Source
+\emph default 
+ bölümünden alınır.
 \layout Itemize
 
 
@@ -1585,7 +1724,11 @@ XML
 \series bold 
 Metadata
 \series default 
- XML dosyalarının yapısı PSPEC dosyası ile hemen hemen aynıdır.
+ XML dosyalarının yapısı 
+\series bold 
+PSPEC
+\series default 
+ dosyası ile hemen hemen aynıdır.
  Yalnızca Metadata paket oluşumundan sonra elimizde olan bazı ek bilgileri
  de içerir.
  
@@ -1696,7 +1839,7 @@ pisi-files.dtd
  dosyasında tanımlanmıştır.
 \layout Standard
 
-TODO: Örnek Lazım!
+TODO: Örnek 
 \layout Subsection
 
 PSPEC Deposu
@@ -2009,20 +2152,34 @@ pisi.index
  olarak oluşturacaktır.
 \layout Standard
 
-Kullanıcı bilgisayarında oluşturulacak depo veritabanı pisi.index ve Changeset'le
+Kullanıcı bilgisayarında oluşturulacak depo veritabanı 
-r yardımı ile yaratılacaktır.
+\series bold 
+pisi.index
+\series default 
+ ve 
+\series bold 
+Changeset
+\series default 
+'ler yardımı ile yaratılacaktır.
  Kullanıcının depodaki paketlerin en güncel bilgilerini alabilmesi için
  depo veritabanını düzenli olarak güncellemesi gerekmektedir.
  Bu işlem bir arkaplan uygulaması ile otomatik olarak yaptırılabilir.
 \layout Standard
 
-Depoya eklenecek ikili paketler geliştiriciden alınmayacak, PİSİ derleme
+Depoya eklenecek ikili paketler geliştiriciden alınmayacak, 
- ortamı tarafından hazırlanıp uygun görülen depoya yerleştirilecektir.
+\series bold 
+PİSİ
+\series default 
+ derleme ortamı tarafından hazırlanıp uygun görülen depoya yerleştirilecektir.
  Böylece geliştiricinin sisteminden kaynaklanabilecek olası problemlerin
  (sürüm farklılıkları, sorunlu ya da güvensiz yazılımlar vs.) önüne geçilecektir.
 \layout Standard
 
-PİSİ istemcisi birden fazla depo ile çalışabilecektir.
+
+\series bold 
+PİSİ
+\series default 
+ istemcisi birden fazla depo ile çalışabilecektir.
  Birden fazla depo tanımlanması durumunda öncelikli depo her zaman 
 \series bold 
 Pardus Resmi Deposu
@@ -2035,13 +2192,17 @@ Pardus Resmi Deposu
 PİSİ Paketinin Yapısı
 \layout Standard
 
-PİSİ paketleri ikili bir biçimde sunulacaktır.
+
+\series bold 
+PİSİ
+\series default 
+ paketleri ikili bir biçimde sunulacaktır.
  Bu bölüm paketlerin biçemini (format) ve içerdiklerini tanımlamaktadır.
 \layout Standard
 
 
 \series bold 
-PISI
+PİSİ
 \series default 
  paketi, içerisinde aşağıdaki bölümler olan bir 
 \emph on 
@@ -2055,8 +2216,12 @@ PK-ZIP
 \series bold 
 metadata.xml:
 \series default 
- PSPEC dosyasından alınacak ve üzerine eklenecek bilgiler ile oluşturulacak
+ 
- Meta bilgisi
+\series bold 
+PSPEC
+\series default 
+ dosyasından alınacak ve üzerine eklenecek bilgiler ile oluşturulacak Meta
+ bilgisi
 \layout Itemize
 
 
@@ -2084,7 +2249,7 @@ install/ dizini:
 Süreçlerin Tarifi
 \layout Standard
 
-Süreç tariri paket sisteminin en temel görevlerini, tasarımı özetlemek amacı
+Süreç tarifi paket sisteminin en temel görevlerini, tasarımı özetlemek amacı
  ile anlatır.
 \layout Subsubsection
 
@@ -2143,7 +2308,7 @@ PSPEC
  ve doğruluğu kontrol edilir.
  Gerekli dosya ve yamalar yukarıda anlatılan biçime uygun bir şekilde 
 \series bold 
-PISI 
+PİSİ 
 \series default 
 tarafından açılır ve gerekli yamalar koda uygulanır.
  
@@ -2160,7 +2325,17 @@ beti
 \layout Itemize
 
 Geliştirici (tercihen grafik arayüz yardımı ile) derleme sonrası oluşturulan
- dosyaları, PSPEC dosyasında tanımlanan Package bölümlerine göre sınıflandırır.
+ dosyaları, 
+\series bold 
+PSPEC
+\series default 
+ dosyasında tanımlanan 
+\series bold 
+\emph on 
+Package
+\series default 
+\emph default 
+ bölümlerine göre sınıflandırır.
  Oluşturulacak her paket için 
 \series bold 
 files.xml
@@ -2361,7 +2536,7 @@ CSL
 Bağımlılık çözmek
 \layout Standard
 
-TODO: Güzel anlatım, uzun bilimsel hikaye gerek
+TODO: Ayrıntılı algoritmik anlatım gerekiyor
 \layout Standard
 
 
@@ -2396,7 +2571,7 @@ OM
 Veritabanları
 \layout Standard
 
-FIXME: Dizaynı sonrası güncellenmeli
+FIXME: Ayrıntılı tanım eklenecek
 \layout Standard
 
 İstemci makinadaki paket veritabanı aşağıdaki bölümlere sahip olacaktır.
@@ -2472,11 +2647,19 @@ Bir paketi sisteme kurma
 Sistemden bir paketi kaldırma
 \layout Itemize
 
-Verilen bir PİSİ paketini açma
+Verilen bir 
+\series bold 
+PİSİ
+\series default 
+ paketini açma
 \layout Itemize
 
-Verilen bir PİSİ paketi içerisinden yalnızca bir dosyayı/dizini çıkarma
+Verilen bir 
- (metadata.xml dosyası veya install/ dizini gibi)
+\series bold 
+PİSİ
+\series default 
+ paketi içerisinden yalnızca bir dosyayı/dizini çıkarma (metadata.xml dosyası
+ veya install/ dizini gibi)
 \layout Itemize
 
 Bağımlılık çözümleme
@@ -2494,10 +2677,18 @@ Verilen bir ikili paketi sorgulama
 İkili paketler deposundan bir paketi çekme/alma (fetch).
 \layout Itemize
 
-PSPEC dosyalarını okuma/işleme/oluşturma.
+
+\series bold 
+PSPEC
+\series default 
+ dosyalarını okuma/işleme/oluşturma.
 \layout Itemize
 
-PSPEC dosyasında belirtilen bir uygulama kaynağını çekme/alma (fetch)
+
+\series bold 
+PSPEC
+\series default 
+ dosyasında belirtilen bir uygulama kaynağını çekme/alma (fetch)
 \layout Itemize
 
 Farklı dosya tiplerini (zip, tar, tar.gz, tar.bz2) açma
@@ -2506,7 +2697,11 @@ Farkl
 Action betiklerini çalıştırma
 \layout Itemize
 
-İkili PİSİ paketi oluşturma
+İkili 
+\series bold 
+PİSİ 
+\series default 
+paketi oluşturma
 \layout Itemize
 
 Kurulu paketler veritabanını güncelleme (yeni girdi ekleme, girdi silme
@@ -2523,8 +2718,19 @@ Dosya
 Paketi imzalama ve imzanın doğruluğunu kontrol etme.
 \layout Itemize
 
-COMAR sistemi ile iletişim kurma (CSL betiklerinin COMAR'a bildirilmesi,
+
- betiklerin COMAR'dan kaldırılması)
+\series bold 
+ÇOMAR
+\series default 
+ sistemi ile iletişim kurma (CSL betiklerinin 
+\series bold 
+ÇOMAR
+\series default 
+'a bildirilmesi, betiklerin 
+\series bold 
+ÇOMAR
+\series default 
+'dan kaldırılması)
 \layout Standard
 
 Bu gerekleri sağlamak için libpisi modülleri aşağıdaki şekilde gruplanmışlardır.
@@ -2578,7 +2784,11 @@ Package (xml, zip, gpg, util mod
 PİSİ Package Builder (GUI)
 \layout Itemize
 
-PSPEC dosyasını kullanıcının tanımları doğrultusunda oluşturacak
+
+\series bold 
+PSPEC
+\series default 
+ dosyasını kullanıcının tanımları doğrultusunda oluşturacak
 \layout Itemize
 
 Action betiklerini kullanıcıya yazdıracak