Son düzenlemeler, döküman yayınlanmak üzere..

doc/pisi.lyx

@@ -279,24 +279,28 @@ Gerekti
 \layout Subsection
 
 Kurumsal Gereksinimler
-\layout Comment
-
-(meren) Bu kısmı biraz daha açmak gerekli (yoksa değil mi?).
 \layout Itemize
 
 Paket yöneticisi birden fazla paket kaynağı ile aynı anda sorunsuz bir şekilde
  çalışabilmelidir.
 \layout Itemize
 
-Kurumlar ya da bireyler tarafından ön tanımlı depoda da bulunan kimi paketlerin
- özelleştirlmiş versiyonlarının bulunduğu depolar 
+Kurumlar ya da bireyler tarafından 
+\emph on 
+ön tanımlı depoda da bulunan
+\emph default 
+ kimi paketlerin değiştirilmiş versiyonlarının bulunduğu depolar 
 \emph on 
 overlay
 \emph default 
  olarak tanımlanabilmelidir.
 \layout Itemize
 
-Ön tanımlı depoda bulunmayan çeşitli paketlerin bulunduğu depolar 
+Ön tanımlı depoda 
+\emph on 
+bulunmayan
+\emph default 
+ çeşitli paketlerin bulunduğu depolar 
 \emph on 
 addon
 \emph default 
@@ -327,11 +331,15 @@ leri birbirinden d
  Bu araçlar basit olarak hazırlanmış ve zaman içinde ortaya çıkan ihtiyaçları
  karşılamak için sürekli yeni özellikler eklenerek bugünkü hallerine gelmişlerdi
 r.
- Bunun getirdiği karmaşıklığı temizlemek için aşağıdaki ilkeleri temel alan
- yeni bir paket yöneticisi yazmaya karar verilmiştir:
+ Bunun getirdiği karmaşıklığı temizlemek için aşağıdaki iki ilkeyi temel
+ alan yeni bir paket yöneticisinin yazılmasına verilmiştir:
 \layout Itemize
 
-Kurulum ve yapılandırma birbirinden ayrı iki görevdir.
+
+\series bold 
+Kurulum ve yapılandırma birbirinden ayrı iki görevdir
+\series default 
+.
  Kurulum, yalnızca programların kurulumu, güncellenmesi ve kaldırılması
  esnasında iş görürken, yapılandırma hem kurulumda hem de çalışan sistemde
  söz konusudur.
@@ -341,38 +349,15 @@ Kurulum ve yap
  PİSİ bu görevleri ÇOMAR'a devredecektir.
 \layout Itemize
 
-Paket meta bilgileri ile paketin derlenme ve kurulumunu yöneten betikler
- iç içe geçmemelidir.
- Varolan paket yöneticilerinde paket tanımlama dosyaları kod ile bilginin
- birbirine karıştığı, araçlarla işlemesi zor, net ve kesin tanımlanmamış
- biçimlerdedir.
-\layout Comment
 
-(meren) Bu kısımda daha önce olan ÇOMAR ile ilgili daha önceden liste halinde
- verilmiş gerekler artık yok burda..
- O gereklerin belgenin 
 \series bold 
-1699.
-
+Paket meta bilgileri ile paketin derlenme ve kurulumunu yöneten betikler
+ iç içe geçmemelidir
 \series default 
- revizyonundan alınıp Tasarım altında uygun bir yere koyulması gerekli..
-\newline 
-
-\newline 
-(meren) Daha önce hemen bu kısmın altındaki başlıklar olan 
-\begin_inset Quotes eld
-\end_inset 
-
-Neden {Portage,DPKG,RPM}
-\begin_inset Quotes erd
-\end_inset 
-
- değil başlıklarını kaldırmaya karar verdik.
- Onları tek tek anlatmanın ve eksik kalan yönlerinden bahsetmenin gereği
- olmadığını düşündük.
- Öte yandan da neden X paket yöneticisini seçmediniz sorusuna belge üzerinden
- yanıt vermemiz de hoş olurdu diye hissediyorum ben.
- Bu konuyu bir düşünelim hızlıca...
+.
+ Varolan paket yöneticilerinde paket tanımlama dosyaları kod ile bilginin
+ birbirine karıştığı, araçlarla işlemesi, içinden bilgi çıkarılması zor,
+ net ve kesin tanımlanmamış biçimlerdedir.
 \layout Section
 
 PİSİ Tasarımı
@@ -381,7 +366,8 @@ P
 Paket Oluşturma
 \layout Standard
 
-FIXME: Anlamlı bir giriş paragrafı lazım!
+Bu kısımda bir PISI 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ı
@@ -556,14 +542,14 @@ Paketi olu
 \series bold 
 Name:
 \series default 
- (*) Paket geliştiricisinin adı ve soyadı.
+ (*) Paket oluşturan kişinin adı ve soyadı.
 \layout Itemize
 
 
 \series bold 
 Email:
 \series default 
- (*) Paket geliştiricisinin e-posta adresi.
+ (*) Paket oluşturan kişinin e-posta adresi.
 \end_deeper 
 \layout Itemize
 
@@ -618,8 +604,8 @@ compressionType
 \series bold 
 level
 \series default 
- ile yamanın patch komutuna -p ile verilebilen seviyesi verilebilir, level
- verilmez ise 0 olarak kabul edilir.
+ ile yamanın patch komutuna seviye verilebilir, level verilmez ise seviye
+ 0 olarak kabul edilir.
  Örnek: 
 \newline 
 <Patch compressionType="gz" level="1">popt-1.7-uclibc.patch.gz</Patch>
@@ -687,9 +673,7 @@ BuildDependencies
 Dependency
 \series default 
 : Bir bağımlılığı tanımlar.
- Burada bahsedilen bağımlılık paket bağımlılığı olabilir (TODO: Comar bağımlılık
-larını da bir şekilde ifade etmek gerekiyordu.
- Bu belgede daha önce vardı sanırım çıkartmışız).
+ Burada bahsedilen bağımlılık paket bağımlılığı olabilir.
  
 \series bold 
 versionFrom
@@ -702,7 +686,7 @@ versionTo
  edilebilir.
  Örnek:
 \newline 
-<Dependency versionFrom="1.8">make</Dependency>
+<Dependency versionFrom="1.8">automake</Dependency>
 \end_deeper 
 \layout Itemize
 
@@ -795,44 +779,44 @@ Package
 
 
 \series bold 
-Name: 
+Name 
 \series default 
-Override
+(tanımlı ise Source bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
 \series bold 
-Summary: 
+Summary 
 \series default 
-Override
+(tanımlı ise Source bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
 \series bold 
-Description
+Description 
 \series default 
-: Override
+(tanımlı ise Source bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
 \series bold 
-License
+License 
 \series default 
-: Override
+(tanımlı ise Source bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
 \series bold 
-IsA: 
+IsA 
 \series default 
-Merge
+(tanımlı ise Source bölümündeki ile birleştirilir)
 \layout Itemize
 
 
 \series bold 
-PartOf: 
+PartOf 
 \series default 
-Override
+(tanımlı ise Source bölümündekinin yerine kullanılır)
 \layout Itemize
 
 
@@ -853,13 +837,7 @@ Package:
 \series bold 
 Provides: 
 \series default 
-Paketin sağladığı ÇOMAR OM ayaklarının bir listesini verir.
- 
-\series bold 
-OM: 
-\series default 
-Çomar OM ayağının adını verir.
- (FIXME)
+Paketin sağladığı ÇOMAR OM bacaklarının bir listesini verir.
 \layout Itemize
 
 
@@ -1097,7 +1075,7 @@ en
 
 
 \size scriptsize 
-      <Dependency versionFrom="1.8">make</Dependency>
+      <Dependency versionFrom="1.8">automake</Dependency>
 \layout LyX-Code
 
 
@@ -1302,13 +1280,6 @@ from pisi.actionsapi import autotools
 \layout LyX-Code
 
 
-\size scriptsize 
-WorkDir='popt-1.7'
-\layout LyX-Code
-
-\layout LyX-Code
-
-
 \size scriptsize 
 def setup():
 \layout LyX-Code
@@ -1458,8 +1429,6 @@ Packager
 
 \series bold 
 Name
-\series default 
-.
 \layout Itemize
 
 
@@ -1534,7 +1503,7 @@ Conflicts
 \series bold 
 Provides:
 \series default 
- FIXME: ????????????????????????
+ Paketin hangi OM bacaklarını sağladığını belirtir.
 \layout Itemize
 
 
@@ -1832,11 +1801,7 @@ cpid/
 \begin_deeper 
 \layout Itemize
 
-
-\series bold 
-a
-\series default 
-cpid-1.0.2.pspec
+pspec.xml
 \layout Itemize
 
 actions.py
@@ -1933,69 +1898,69 @@ r
 
 
 \series bold 
-Name: 
+Name
 \layout Itemize
 
 
 \series bold 
-Summary:
+Summary
 \series default 
  
 \layout Itemize
 
 
 \series bold 
-Description:
+Description
 \layout Itemize
 
 
 \series bold 
-Version: 
+Version 
 \layout Itemize
 
 
 \series bold 
-Release: 
+Release 
 \layout Itemize
 
 
 \series bold 
-License: 
+License
 \layout Itemize
 
 
 \series bold 
-RuntimeDependencies:
+RuntimeDependencies
 \layout Itemize
 
 
 \series bold 
-InstallDependencies:
+InstallDependencies
 \layout Itemize
 
 
 \series bold 
-Provides: 
+Provides 
 \layout Itemize
 
 
 \series bold 
-History:
+History
 \layout Itemize
 
 
 \series bold 
-Conflicts:
+Conflicts
 \layout Itemize
 
 
 \series bold 
-PackageSize: 
+PackageSize 
 \layout Itemize
 
 
 \series bold 
-InstalledSize: 
+InstalledSize
 \layout Standard
 
 
@@ -2473,33 +2438,30 @@ pisi-index.xml
 
 
 \series bold 
-Kaynak Veritabanları:
+Kaynak Veritabanları
 \layout Subsubsection
 
 Kurulum Veritabanı
 \layout Standard
 
-FIXME: Dizaynı sonrası güncellenmeli
+FIXME: Ayrıntılı tanım eklenecek
 \layout Subsubsection
 
 Depo Veritabanları
 \layout Standard
 
-FIXME: Dizaynı sonrası güncellenmeli
+FIXME: Ayrıntılı tanım eklenecek
 \layout Subsubsection
 
 Kaynak Veritabanları
 \layout Standard
 
-FIXME: Dizaynı sonrası güncellenmeli
+FIXME: Ayrıntılı tanım eklenecek
 \layout Subsection
 
 libpisi
 \layout Standard
 
-FIXME: Revize edilmeli
-\layout Standard
-
 Paket veritabanının ana yüklenicisi libpisi kütüphanesi olacaktır.
  Kütüphanenin temel görevleri aşağıdaki liste ile özetlenebilir.
 \layout Itemize