Barış'la yaptığımız düzenlemeler

doc/pisi.lyx

@@ -396,9 +396,37 @@ Paketin bir kategori/sistem/kolleksiyon'a aitli
 \series bold 
 PartOf: 
 \series default 
-Paketin hangi aitliğin parçası olduğunu belirtir.
+Paketin hangi bütünün/grubun parçası olduğunu belirtir.
  Aitlik özellikleri için Freshmeat'in Trove kategorileri örnek verilebilir.
  ( örn: LyX and TeTex are parts of Tex:Distrubiton )
+\newline 
+
+\series bold 
+IsA
+\series default 
+ ve 
+\series bold 
+ParfOf
+\series default 
+ bir 
+\series bold 
+PİSİ
+\series default 
+ paketinin farklı türdeki aitliklerini ifade eder.
+ 
+\series bold 
+PartOf
+\series default 
+ ile belirtilen bir 
+\series bold 
+Component
+\series default 
+'in tümünü sisteme kurabilirsiniz.
+ Fakat 
+\series bold 
+IsA
+\series default 
+ ile belirtilen aitlikleri yanlızca sorgulayabilirsiniz.
 \layout Itemize
 
 
@@ -451,7 +479,12 @@ sha1sum
 \series bold 
 Patches
 \series default 
-: Orjinal koda uygulanacak yamaların sıralı bir listesini içerir.
+: Orjinal koda uygulanacak yamaların 
+\series bold 
+sıralı
+\series default 
+ bir listesini içerir.
+ Yamalar bu bölümde tanımlanan sıra ile kaynak koda uygulanır.
 \begin_deeper 
 \layout Itemize
 
@@ -556,6 +589,25 @@ VersionTo:
 History
 \series default 
 : Pakete yapılan güncellemelerin bir listesini verir.
+ 
+\series bold 
+History
+\series default 
+ altındaki güncellemeleri belirten 
+\series bold 
+Update
+\series default 
+ taglarının mutlaka tarihe göre sıralı olması gerekmektedir.
+ En son güncelleme en üstte bulunmalıdır.
+ Çünkü en son güncellemeden alınan 
+\series bold 
+Version
+\series default 
+ ve 
+\series bold 
+Release
+\series default 
+ bilgisi pakete uygulanacaktır.
 \begin_deeper 
 \layout Itemize
 
@@ -572,7 +624,7 @@ Update
 Type: 
 \series default 
 Güncellemenin tipini belirtir.
- ( Güvenlik, Bug, Enhancement v.s )
+ (Güvenlik, Bug, Enhancement v.s)
 \layout Itemize
 
 
@@ -601,57 +653,59 @@ Release:
 Package: 
 \series medium 
 Uygulamadan oluşturulacak bir pakedi tanımlar.
+ 
+\series default 
+Package
+\series medium 
+ içerisindeki bazı taglar 
+\series default 
+PİSİ
+\series medium 
+ içerisindekileri tekrarlayacaklardır.
+ Bu tekrarlamaların bazıları override edilirken (üzerine yazılırken) bazıları
+ merge (birleştirilecek) edilecek.
 \layout Itemize
 
 
 \series bold 
-Name
+Name: 
 \series default 
-: Oluşturulacak pakedin adı.
+Override
 \layout Itemize
 
 
 \series bold 
-Summary
+Summary: 
 \series default 
-: Tek satırlık açıklayıcı bilgi.
- Çoklu dil desteğine sahiptir.
+Override
 \layout Itemize
 
 
 \series bold 
 Description
 \series default 
-: Uygulama hakkında özet açıklama.
- Çoklu dil desteğine sahiptir.
+: Override
 \layout Itemize
 
 
 \series bold 
 License
 \series default 
-: Uygulamanın lisansını belirtir (GPL, BSD, vb).
+: Override
 \layout Itemize
 
 
 \series bold 
 IsA: 
 \series default 
-Paketin bir kategori/sistem/kolleksiyon'a aitliğini belirtir.
- ( 
-\emph on 
-örn:
-\emph default 
- k3b is a KDE program )
+Merge
 \layout Itemize
 
 
 \series bold 
 PartOf: 
 \series default 
-Paketin hangi aitliğin parçası olduğunu belirtir.
- Aitlik özellikleri için Freshmeat'in Trove kategorileri örnek verilebilir.
- ( örn: LyX and TeTex are parts of Tex:Distrubiton )
+Merge
 \layout Itemize
 
 
@@ -795,17 +849,49 @@ File
 \end_deeper 
 \layout Subsubsection
 
-Actions Dosyası
+actions.py Dosyası
 \layout Standard
 
 Bu dosya bir Python betiği olup, kaynağın kurulması, derlenmesi, test edilmesi,
  sisteme kurulması gibi işlevleri yerine getiren fonksiyonlardan oluşur.
+ 
+\layout Standard
+
+Paketin oluşturulması sırasında derleme sistemi 
+\series bold 
+actions.py
+\series default 
+ içerisindeki 3 fonksiyon adını arar ve çalıştırır; 
+\series bold 
+setup, build, install
+\series default 
+.
+ Bu fonksiyonlardan install'ın tanımlanması zorunlu olmakla birlikte setup
+ ve build sadece tanımlanmışsa çalıştırılır.
+ 
+\layout Standard
+
+
+\series bold 
+actions.py
+\series default 
+'ler tarafından kullanılmak üzere 
+\series bold 
+PİSİ
+\series default 
+ tarafından hazır bir 
+\series bold 
+API
+\series default 
+ actionsapi adında sunulacaktır.
 \layout Subsubsection
 
 ChangeLog Dosyası
 \layout Standard
 
 Pakedin sürümlerindeki değişikliklerin açıklamalarını içerir.
+ Bu dosya bilindik ChangeLog stilindedir ve PSPEC içindeki History bilgisi
+ ile ilgili değildir.
 \layout Subsection
 
 metadata.xml
@@ -861,14 +947,12 @@ Metadata
 \series bold 
 Name
 \series default 
- {From Package Tag}: Uygulamanın adı.
+ {From Package Tag}
 \layout Itemize
 
 
 \series bold 
-Homepage: 
-\series default 
-Uygulamanın web sitesinin URL'sini belirtir.
+Homepage
 \layout Itemize
 
 
@@ -876,11 +960,6 @@ Uygulaman
 Summary 
 \series default 
 {From Package Tag}
-\series bold 
-:
-\series default 
- Tek satırlık açıklayıcı bilgi.
- Çoklu dil desteğine sahiptir.
 \layout Itemize
 
 
@@ -888,11 +967,6 @@ Summary
 Description 
 \series default 
 {From Package Tag}
-\series bold 
-: 
-\series default 
-Uygulama hakkında özet açıklama.
- Çoklu dil desteğine sahiptir.
 \layout Itemize
 
 
@@ -900,15 +974,6 @@ Uygulama hakk
 IsA 
 \series default 
 {From Package Tag}
-\series bold 
-: 
-\series default 
-Paketin bir kategori/sistem/kolleksiyon'a aitliğini belirtir.
- ( 
-\emph on 
-örn:
-\emph default 
- k3b is a KDE program )
 \layout Itemize
 
 
@@ -916,34 +981,24 @@ Paketin bir kategori/sistem/kolleksiyon'a aitli
 PartOf 
 \series default 
 {From Package Tag}
-\series bold 
-: 
-\series default 
-Paketin hangi aitliğin parçası olduğunu belirtir.
- Aitlik özellikleri için Freshmeat'in Trove kategorileri örnek verilebilir.
- ( örn: LyX and TeTex are parts of Tex:Distrubiton )
 \layout Itemize
 
 
 \series bold 
-Packager: 
-\series default 
-Paketi oluşturan kişilerin adı/soyadı ve e-posta adresi belirtir.
+Packager
 \begin_deeper 
 \layout Itemize
 
 
 \series bold 
-Name:
+Name
 \series default 
- Paket geliştiricisinin adı ve soyadı.
+.
 \layout Itemize
 
 
 \series bold 
-Email:
-\series default 
- Paket geliştiricisinin e-posta adresi.
+Email
 \end_deeper 
 \layout Itemize
 
@@ -951,62 +1006,46 @@ Email:
 \series bold 
 License
 \series default 
- {From Package Tag}: Uygulamanın lisansını belirtir (GPL, BSD, vb).
+ {From Package Tag}
 \layout Itemize
 
 
 \series bold 
 History
-\series default 
-: Pakete yapılan güncellemelerin bir listesini verir.
 \begin_deeper 
 \layout Itemize
 
 
 \series bold 
 Update
-\series default 
-: Bir güncellemeyi tarif eder.
 \begin_deeper 
 \layout Itemize
 
 
 \series bold 
-Type: 
-\series default 
-Güncellemenin tipini belirtir.
- ( Güvenlik, Bug, Enhancement v.s )
+Type
 \layout Itemize
 
 
 \series bold 
 Date
-\series default 
-: Güncellemenin tarihi.
 \layout Itemize
 
 
 \series bold 
-Version: 
-\series default 
-Uygulamanın sürüm numarası.
+Version
 \layout Itemize
 
 
 \series bold 
-Release:
-\series default 
- Pakedin sürüm numarası.
+Release
 \end_deeper 
 \end_deeper 
 \layout Itemize
 
 
 \series bold 
-Conflicts:
-\series default 
- Paketin çalışması/işlevini yerine getirmesi için, sistemde olmaması gereken
- paketleri belirtir.
+Conflicts
 \layout Itemize
 
 
@@ -1019,47 +1058,33 @@ Provides:
 
 \series bold 
 RuntimeDependencies
-\series default 
-: Pakedin çalışabilmesi için gereken bağımlılıkların bir listesini verir.
- 
 \begin_deeper 
 \layout Itemize
 
 
 \series bold 
 Dependency
-\series default 
-: Bir bağımlılık tanımlar.
 \begin_deeper 
 \layout Itemize
 
 
 \series bold 
 Name
-\series default 
-: Bağımlılık duyulan pakedin adı.
 \layout Itemize
 
 
 \series bold 
-Version:
-\series default 
- Bağımlı olunan tek bir sürüm numarasını bildirir.
+Version
 \layout Itemize
 
 
 \series bold 
-VersionFrom:
-\series default 
- Bu sürüm numarasından sonraki tüm sürüm numaralarına bağımlılığı tarif
- eder.
+VersionFrom
 \layout Itemize
 
 
 \series bold 
-VersionTo:
-\series default 
- Bu sürüm numaralarına kadar olan bağımlılığı tarif eder.
+VersionTo
 \end_deeper 
 \end_deeper 
 \layout Itemize
@@ -1067,47 +1092,33 @@ VersionTo:
 
 \series bold 
 InstallDependencies
-\series default 
-: Pakedin çalışabilmesi için gereken bağımlılıkların bir listesini verir.
- 
 \begin_deeper 
 \layout Itemize
 
 
 \series bold 
 Dependency
-\series default 
-: Bir bağımlılık tanımlar.
 \begin_deeper 
 \layout Itemize
 
 
 \series bold 
 Name
-\series default 
-: Bağımlılık duyulan pakedin adı.
 \layout Itemize
 
 
 \series bold 
-Version:
-\series default 
- Bağımlı olunan tek bir sürüm numarasını bildirir.
+Version
 \layout Itemize
 
 
 \series bold 
-VersionFrom:
-\series default 
- Bu sürüm numarasından sonraki tüm sürüm numaralarına bağımlılığı tarif
- eder.
+VersionFrom
 \layout Itemize
 
 
 \series bold 
-VersionTo:
-\series default 
- Bu sürüm numaralarına kadar olan bağımlılığı tarif eder.
+VersionTo
 \end_deeper 
 \end_deeper 
 \layout Itemize
@@ -1115,14 +1126,6 @@ VersionTo:
 
 \series bold 
 Files
-\series default 
-: Pakedin kurulacak dosyalarının tiplerini belirlemek için kullanılır.
- Dosya tipleri ile ilgili bigi 
-\begin_inset LatexCommand \ref{FType}
-
-\end_inset 
-
- kısmında verilmiştir.
 \begin_deeper 
 \layout Itemize