From 667bdd1b7813db8a15b4a3917309b8fed40dbfaf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=2E=C3=87a=C4=9Flar=20Onur?= Date: Tue, 12 Jul 2005 07:06:39 +0000 Subject: [PATCH] =?UTF-8?q?Kozmetik=20de=C4=9Fi=C5=9Fiklikler,=20Sir=20I'm?= =?UTF-8?q?=20ready=20to=20go...?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- doc/pisi.lyx | 320 ++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 265 insertions(+), 55 deletions(-) diff --git a/doc/pisi.lyx b/doc/pisi.lyx index 50ce387c..1e416315 100644 --- a/doc/pisi.lyx +++ b/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. - PİSİ bu görevleri ÇOMAR'a devredecektir. + Uludağ projesi için yapılandırma işlerini yürütecek araç +\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 - duyulacak meta dosyalar ve süreçler netleştirilmeye çalışılmıştır. +Bu kısımda bir +\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. - Bulunması zorunlu olan etiketler aşağıda (*) ile belirtilirler. + Her +\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). - Eğer bu etiket tanımlı değilse tip Normal olarak kabul edilir. + Güncellemenin tipini belirtir ( +\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. - Bu tekrarlamaların bazıları override edilirken (üzerine yazılırken) bazıları - merge (birleştirilecek) edilecek. + içerisindeki bazı taglar +\emph on +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 \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 -r yardımı ile yaratılacaktır. +Kullanıcı bilgisayarında oluşturulacak depo veritabanı +\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 - ortamı tarafından hazırlanıp uygun görülen depoya yerleştirilecektir. +Depoya eklenecek ikili paketler geliştiriciden alınmayacak, +\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 - (metadata.xml dosyası veya install/ dizini gibi) +Verilen bir +\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