diff --git a/doc/pisi.lyx b/doc/pisi.lyx index 316218e6..50ce387c 100644 --- a/doc/pisi.lyx +++ b/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 popt-1.7-uclibc.patch.gz @@ -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 -make +automake \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 - make + automake \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