~ubuntu-branches/ubuntu/feisty/kubuntu-docs/feisty

<?xml version="1.0" encoding="utf-8"?>

<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [

<!ENTITY % globalent SYSTEM "../../../libs/global.ent">

<!-- NAMES --><!ENTITY canonical-name "Canonical Ltd.">

<!ENTITY project-name "Ubuntu Documentation Project">

<!ENTITY ubuntu "<phrase>Ubuntu</phrase>">

<!-- VERSIONS --><!ENTITY distro-version "Dapper Drake">

<!ENTITY distro-rev "6.06 LTS">

<!ENTITY distro-release-date "June 2006">

<!ENTITY linux-kernel-version "2.6.15">

<!ENTITY gcc-version "4.0.3">

<!ENTITY glibc-version "2.3.6">

<!ENTITY python-version "2.4.3">

<!-- AUTHORS --><!ENTITY author-ubuntu-documentation-project SYSTEM "../common/authors/ubuntu-documentation-project.xml">

<!ENTITY author-christoph-haas SYSTEM "../common/authors/christoph-haas.xml">

<!ENTITY author-alexander-poslavsky SYSTEM "../common/authors/alexander-poslavsky.xml">

<!ENTITY author-alan-hood SYSTEM "../common/authors/alan-hood.xml">

<!ENTITY author-johnathon-hornbeck SYSTEM "../common/authors/johnathon-hornbeck.xml">

<!ENTITY author-nick-loeve SYSTEM "../common/authors/nick-loeve.xml">

<!ENTITY author-gordon-ingram SYSTEM "../common/authors/gordon-ingram.xml">

<!ENTITY author-sean-wheller SYSTEM "../common/authors/sean-wheller.xml">

<!ENTITY author-enrico-zini SYSTEM "../common/authors/enrico-zini.xml">

<!ENTITY author-kevin-muligan SYSTEM "../common/authors/kevin-muligan.xml">

<!ENTITY author-ari-torhamo SYSTEM "../common/authors/ari-torhamo.xml">

<!ENTITY author-jeff-schering SYSTEM "../common/authors/jeff-schering.xml">

<!ENTITY author-corey-burger SYSTEM "../common/authors/corey-burger.xml">

<!ENTITY author-niel-tallim SYSTEM "../common/authors/niel-tallim.xml">

<!ENTITY author-henry-meyerding SYSTEM "../common/authors/henry-meyerding.xml">

<!ENTITY author-matthew-east SYSTEM "../common/authors/matthew-east.xml">

<!ENTITY author-jerome-gotangco SYSTEM "../common/authors/jerome-gotangco.xml">

<!ENTITY author-johnathan-jesse SYSTEM "../common/authors/johnathan-jesse.xml">

<!ENTITY author-greg-taylor SYSTEM "../common/authors/greg-taylor.xml">

<!ENTITY author-troy-williams SYSTEM "../common/authors/troy-williams.xml">

<!ENTITY author-matt-galvin SYSTEM "../common/authors/matt-galvin.xml">

<!ENTITY author-robert-stoffers SYSTEM "../common/authors/robert-stoffers.xml">

<!ENTITY author-jordan-mantha SYSTEM "../common/authors/jordan-mantha.xml">

<!ENTITY author-venkat-raghavan SYSTEM "../common/authors/venkat-raghavan.xml">

<!ENTITY author-brian-burger SYSTEM "../common/authors/brian-burger.xml">

<!ENTITY author-rocco-stanzione SYSTEM "../common/authors/rocco-stanzione.xml">

<!ENTITY glossary SYSTEM "../common/C/glossary.xml">

<!-- LEGAL URLs --><!ENTITY gpl-url '<ulink url="http://www.gnu.org/licenses/gpl.html">GNU General Public License</ulink>'>

<!ENTITY cc "http://creativecommons.org/">

<!ENTITY cc-attrib '<ulink url="http://creativecommons.org/licenses/by-sa/2.0/">Attribution-ShareAlike 2.0</ulink>'>

<!ENTITY cc-fulldeed-url "http://creativecommons.org/licenses/by-sa/2.0/legalcode/">

<!ENTITY fdl-url '<ulink url="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</ulink>'>

<!ENTITY cc-disclaimer-url "http://creativecommons.org/licenses/disclaimer-popup?lang=en">

<!-- CANONICAL URL RESOURCES --><!ENTITY canonical-url "http://www.canonical.com">

<!-- UBUNTU URL RESOURCES --><!ENTITY ubuntu-packages "http://packages.ubuntu.com">

<!ENTITY ubuntu-dpkgfile "ubuntu5.10.tar">

<!ENTITY ubuntu-web "http://www.ubuntu.com">

<!ENTITY ubuntu-main "http://www.ubuntu.com">

<!ENTITY ubuntu-download "http://www.ubuntu.com/download">

<!ENTITY ubuntu-forums "http://www.ubuntu.com/community/forums">

<!ENTITY ubuntu-components "http://www.ubuntu.com/ubuntu/components">

<!ENTITY ubuntu-lists "http://lists.ubuntu.com">

<!ENTITY ubuntu-wiki "http://wiki.ubuntu.com">

<!ENTITY ubuntu-irc "irc.freenode.net channel #ubuntu">

<!ENTITY ubuntu-bugzilla "https://launchpad.net/distros/ubuntu/+bugs">

<!ENTITY ubuntu-doc-bugs "https://launchpad.net/products/ubuntu-doc/+bugs">

<!ENTITY ubuntu-paidsupport "http://www.ubuntu.com/support/supportoptions/paidsupport">

<!ENTITY ubuntu-freesupport "http://www.ubuntu.com/support/supportoptions/freesupport">

<!ENTITY ubuntu-comments "http://www.ubuntuforums.org/showthread.php?p=21787">

<!ENTITY ubuntu-documentation "http://help.ubuntu.com">

<!ENTITY ubuntu-documentation-repos "https://docteam.ubuntu.com/repos/trunk">

<!ENTITY ubuntu-doc-team "https://wiki.ubuntu.com/DocumentationTeam">

<!ENTITY ubuntu-doc-list "http://lists.ubuntu.com/mailman/listinfo/ubuntu-doc">

<!ENTITY ubuntu-shipit "http://shipit.ubuntu.com">

<!ENTITY ubuntu-launchpad "https://launchpad.ubuntu.com">

<!ENTITY ubuntu-rosetta "https://launchpad.ubuntu.com/rosetta">

<!ENTITY ubuntu-planet "http://planet.ubuntu.com">

<!ENTITY ubuntu-philosophy "http://www.ubuntu.com/ubuntu/philosophy">

<!ENTITY ubuntu-participate "http://www.ubuntu.com/community/participate/">

<!-- UBUNTU WIKI RESOURCES --><!ENTITY wiki-UserDocumentation "https://wiki.ubuntu.com/UserDocumentation">

<!ENTITY restricted-formats "https://wiki.ubuntu.com/RestrictedFormats">

<!ENTITY wiki-RestrictedFormats "https://wiki.ubuntu.com/RestrictedFormats">

<!ENTITY wiki-XChatHowto "https://wiki.ubuntu.com/XChatHowto">

<!ENTITY wiki-RootSudo "https://wiki.ubuntu.com/RootSudo">

<!ENTITY wiki-HowToGetHelp "https://wiki.ubuntu.com/HowToGetHelp">

<!ENTITY transcode "https://wiki.ubuntu.com/DVDRippingandEncoding">

<!ENTITY wiki-Wine "https://wiki.ubuntu.com/Wine">

<!ENTITY wiki-Cedega "https://wiki.ubuntu.com/Cedega">

<!ENTITY wiki-Nano "https://wiki.ubuntu.com/NanoHowto">

<!ENTITY wiki-locoteams "https://wiki.ubuntu.com/LoCoTeamList">

<!ENTITY wiki-BasicCommands "https://wiki.ubuntu.com/BasicCommands">

<!ENTITY wiki-filepermissions "https://wiki.ubuntu.com/FilePermissions">

<!-- KUBUNTU URL RESOURCES --><!ENTITY kubuntu-web "http://www.kubuntu.org">

<!ENTITY kubuntu-main "http://www.kubuntu.org">

<!ENTITY kubuntu-download "http://releases.ubuntu.com/kubuntu/">

<!ENTITY kubuntu-packages "http://packages.ubuntu.com/breezy/">

<!ENTITY kubuntu-cdpackages-nodefault "http://people.ubuntu.com/~cjwatson/seeds/kubuntu-breezy/ship">

<!ENTITY kubuntu-lists "http://lists.ubuntu.com/archives/kubuntu-users/">

<!ENTITY kubuntu-lists-users "http://lists.ubuntu.com/mailman/listinfo/kubuntu-users/">

<!ENTITY kubuntu-lists-devel "http://lists.ubuntu.com/mailman/listinfo/kubuntu-devel/">

<!ENTITY kubuntu-mirrors "http://distrowatch.com/kubuntu">

<!ENTITY kubuntu-forums "http://ubuntuforums.org/forumdisplay.php?f=68">

<!ENTITY kubuntu-forums2 "http://kubuntuforums.net">

<!ENTITY kubuntu-wiki "http://www.ubuntu.com/wiki/Kubuntu">

<!ENTITY kubuntu-irc "irc.freenode.net channel kubuntu">

<!ENTITY kubuntu-documentation-site "http://www.kubuntu.org/documentation.php">

<!ENTITY kubuntu-wiki-UserDocumentation "https://wiki.kubuntu.com/UserDocumentation">

<!-- XUBUNTU URL RESOURCES --><!ENTITY xubuntu-irc "irc.freenode.net channel xubuntu">

<!-- DEBIAN RESOURCES --><!ENTITY debian-apt "http://www.debian.org/doc/user-manuals#apt-howto">

<!-- EXTERNAL URL RESOURCES --><!ENTITY linmodem "http://www.linmodems.org/">

<!ENTITY gnome "http://www.gnome.org/">

<!ENTITY linuxorg "http://www.linux.org/">

<!ENTITY ooo "http://www.openoffice.org/">

<!ENTITY kde "http://www.kde.org/">

<!ENTITY lugww "http://lugww.counter.li.org/">

<!ENTITY ubuntu-watch "http://distrowatch.com/ubuntu/">

<!ENTITY realplayer-download "http://www.real.com/linux/">

<!ENTITY nvu-download "http://www.nvu.com/download.html">

<!ENTITY sunjava-download "http://java.sun.com/j2se/1.5.0/download.jsp">

<!ENTITY xorg "http://www.x.org">

<!ENTITY dyndns "http://www.dyndns.org">

<!ENTITY shoutcast "http://www.shoutcast.com/">

<!ENTITY freedomtoaster "http://www.freedomtoaster.org/">

<!-- ubuntu-screenshots TODO --><!ENTITY kubuntu-screenshots "http://shots.osdir.com/slideshows/slideshow.php?release=306&amp;slide=1">

<!ENTITY mozilla "http://www.mozilla.org/">

<!ENTITY mozilla-firefox "http://www.mozilla.org/products/firefox/">

<!ENTITY gnu "http://www.gnu.org/">

<!ENTITY gnu-philosophy "http://www.gnu.org/philosophy/">

<!ENTITY win4lin "http://www.win4lin.com">

<!ENTITY codeweavers "http://www.codeweavers.com">

<!ENTITY kernel "http://www.kernel.org">

<!ENTITY google "http://www.google.com">

<!ENTITY kdelook " http://www.kde-look.org">

<!ENTITY lulu-store "http://www.lulu.com/ubuntu-doc">

<!-- this entity controls the url for addons--><!ENTITY java-download "http://java.sun.com/j2se/1.5.0/download.jsp">

<!ENTITY skype-deb "skype_1.2.0.17-1_i386.deb">

<!ENTITY skype-download "http://www.skype.com/go/getskype-linux-deb">

<!ENTITY scanmodem-gz "scanModem.gz">

<!ENTITY scanmodem-url "http://linmodems.technion.ac.il/packages/scanModem.gz">

<!ENTITY ext2fs-url "http://www.fs-driver.org/index.html">

<!ENTITY mvb-tar "mvb_1.6.tgz">

<!ENTITY mvb-url "http://www.xscd.com/pub/mvb/&mvb-tar;">

<!-- TLDP --><!ENTITY ldp-pre-install-check "http://tldp.org/HOWTO/Pre-Installation-Checklist/">

<!-- LANGUAGES (sorted by two letter code)--><!ENTITY Afar "aa">

<!ENTITY Abkhazian "ab">

<!ENTITY Afrikaans "af">

<!ENTITY Amharic "af">

<!ENTITY Arabic "ar">

<!ENTITY Assamese "as">

<!ENTITY Aymara "ay">

<!ENTITY Azerbaijani "az">

<!ENTITY Bashkir "ba">

<!ENTITY Byelorussian "be">

<!ENTITY Bulgarian "bg">

<!ENTITY Bihari "bh">

<!ENTITY Bislama "bi">

<!ENTITY Bangla "bn">

<!ENTITY Bengali "bn">

<!ENTITY Tibetan "bo">

<!ENTITY Breton "br">

<!ENTITY Catalan "ca">

<!ENTITY Corsican "co">

<!ENTITY Czech "cs">

<!ENTITY Welsh "cy">

<!ENTITY Danish "da">

<!ENTITY German "de">

<!ENTITY Bhutani "dz">

<!ENTITY Greek "el">

<!-- <!ENTITY EnglishAmerican 'en'> --><!ENTITY EnglishAmerican "C">

<!ENTITY Esperanto "eo">

<!ENTITY Spanish "es">

<!ENTITY Estonian "et">

<!ENTITY Basque "eu">

<!ENTITY Persian "fa">

<!ENTITY Finnish "fi">

<!ENTITY Fiji "fj">

<!ENTITY Faeroese "fo">

<!ENTITY French "fr">

<!ENTITY Frisian "fy">

<!ENTITY Irish "ga">

<!ENTITY Gaelic "gd">

<!ENTITY ScotsGaelic "gd">

<!ENTITY Galician "gl">

<!ENTITY Guarani "gn">

<!ENTITY Gujarati "gu">

<!ENTITY Hausa "ha">

<!ENTITY Hindi "hi">

<!ENTITY Croatian "hr">

<!ENTITY Hungarian "hu">

<!ENTITY Armenian "hy">

<!ENTITY Interlingua "ia">

<!ENTITY Interlingue "ie">

<!ENTITY Inupiak "ik">

<!ENTITY Indonesian "in">

<!ENTITY Icelandic "is">

<!ENTITY Italian "it">

<!ENTITY Hebrew "iw">

<!ENTITY Japanese "ja">

<!ENTITY Yiddish "ji">

<!ENTITY Javanese "jw">

<!ENTITY Georgian "ka">

<!ENTITY Kazakh "kk">

<!ENTITY Greenlandic "kl">

<!ENTITY Cambodian "km">

<!ENTITY Kannada "kn">

<!ENTITY Korean "ko">

<!ENTITY Kashmiri "ks">

<!ENTITY Kurdish "ku">

<!ENTITY Kirghiz "ky">

<!ENTITY Latin "la">

<!ENTITY Lingala "ln">

<!ENTITY Laothian "lo">

<!ENTITY Lithuanian "lt">

<!ENTITY Latvian "lv">

<!ENTITY Lettish "lv">

<!ENTITY Malagasy "mg">

<!ENTITY Maori "mi">

<!ENTITY Macedonian "mk">

<!ENTITY Malayalam "ml">

<!ENTITY Mongolian "mn">

<!ENTITY Moldavian "mo">

<!ENTITY Marathi "mr">

<!ENTITY Malay "ms">

<!ENTITY Maltese "mt">

<!ENTITY Burmese "my">

<!ENTITY Nauru "na">

<!ENTITY Nepali "ne">

<!ENTITY Dutch "nl">

<!ENTITY Norwegian "no">

<!ENTITY Occitan "oc">

<!ENTITY Afan "om">

<!ENTITY Oromo "om">

<!ENTITY Oriya "or">

<!ENTITY Punjabi "pa">

<!ENTITY Polish "pl">

<!ENTITY Pushto "ps">

<!ENTITY Pashto "ps">

<!ENTITY Portuguese "pt">

<!ENTITY Quechua "qu">

<!ENTITY Rhaeto-Romance "rm">

<!ENTITY Kirundi "rn">

<!ENTITY Romanian "ro">

<!ENTITY Russian "ru">

<!ENTITY Kinyarwanda "rw">

<!ENTITY Sanskrit "sa">

<!ENTITY Sindhi "sd">

<!ENTITY Sangro "sg">

<!ENTITY Serbo-Croatian "sh">

<!ENTITY Singhalese "si">

<!ENTITY Slovak "sk">

<!ENTITY Slovenian "sl">

<!ENTITY Samoan "sm">

<!ENTITY Shona "sn">

<!ENTITY Somali "so">

<!ENTITY Albanian "sq">

<!ENTITY Serbian "sr">

<!ENTITY Siswati "ss">

<!ENTITY Sesotho "st">

<!ENTITY Sudanese "su">

<!ENTITY Swedish "sv">

<!ENTITY Swahili "sw">

<!ENTITY Tamil "ta">

<!ENTITY Tegulu "te">

<!ENTITY Tajik "tg">

<!ENTITY Thai "th">

<!ENTITY Tigrinya "ti">

<!ENTITY Turkmen "tk">

<!ENTITY Tagalog "tl">

<!ENTITY Setswana "tn">

<!ENTITY Tonga "to">

<!ENTITY Turkish "tr">

<!ENTITY Tsonga "ts">

<!ENTITY Tatar "tt">

<!ENTITY Twi "tw">

<!ENTITY Ukrainian "uk">

<!ENTITY Urdu "ur">

<!ENTITY Uzbek "uz">

<!ENTITY Vietnamese "vi">

<!ENTITY Volapuk "vo">

<!ENTITY Wolof "wo">

<!ENTITY Xhosa "xh">

<!ENTITY Yoruba "yo">

<!ENTITY Chinese "zh">

<!ENTITY Zulu "zu">

<!ENTITY % cdo-C SYSTEM "../../../libs/cdo-C.ent">

<!-- COMMON DOC OBJECTS --><!ENTITY copyright SYSTEM "../common/C/copyright.xml">

<!ENTITY conventions SYSTEM "../common/C/conventions.xml">

<!ENTITY feedback SYSTEM "../common/C/feedback.xml">

<!ENTITY publisher SYSTEM "../common/C/publisher.xml">

<!ENTITY legalnotice SYSTEM "../common/C/legalnotice.xml">

<!ENTITY disclaimer SYSTEM "../common/C/disclaimer.xml">

<!ENTITY inline-ubuntu-icon SYSTEM "../common/C/inlinemediaobject-ubuntu-icon.xml">

<!ENTITY inline-ubuntu-icon-header SYSTEM "../common/C/inlinemediaobject-ubuntu-icon-header.xml">

<!ENTITY relative-ubuntu-icon SYSTEM "../common/C/mediaobject-relative-ubuntu-icon.xml">

<!ENTITY ubuntu-icon SYSTEM "../common/C/mediaobject-ubuntu-icon.xml">

<!ENTITY gpl SYSTEM "../common/C/gpl.xml">

<!ENTITY fdl SYSTEM "../common/C/fdl.xml">

<!ENTITY cc-by-sa SYSTEM "../common/C/ccbysa.xml">

<!ENTITY % gnome-menus-C SYSTEM "../../../ubuntu/libs/gnome-menus-C.ent">

<!-- MENUS --><!-- Please keep entries alphabetical, it makes them much easier to find & use --><!ENTITY about-me SYSTEM "../menus/C/about-me.xml">

<!ENTITY accessories SYSTEM "../menus/C/accessories.xml">

<!ENTITY acro-read SYSTEM "../menus/C/acro-read.xml">

<!ENTITY administration SYSTEM "../menus/C/administration.xml">

<!ENTITY amule SYSTEM "../menus/C/amule.xml">

<!ENTITY archive-man SYSTEM "../menus/C/archive-man.xml">

<!ENTITY assistive-technology-preferences SYSTEM "../menus/C/assistive-technology-preferences.xml">

<!ENTITY azureus SYSTEM "../menus/C/azureus.xml">

<!ENTITY blender3d SYSTEM "../menus/C/blender3d.xml">

<!ENTITY boot SYSTEM "../menus/C/boot.xml">

<!ENTITY calculator SYSTEM "../menus/C/calculator.xml">

<!ENTITY character-map SYSTEM "../menus/C/character-map.xml">

<!ENTITY desktop-background SYSTEM "../menus/C/desktop-background.xml">

<!ENTITY desktop-preferences SYSTEM "../menus/C/desktop-preferences.xml">

<!ENTITY device-manager SYSTEM "../menus/C/device-manager.xml">

<!ENTITY dictionary SYSTEM "../menus/C/dictionary.xml">

<!ENTITY disks SYSTEM "../menus/C/disks.xml">

<!ENTITY downloader-x SYSTEM "../menus/C/downloader-x.xml">

<!ENTITY file-management SYSTEM "../menus/C/file-management.xml">

<!ENTITY firefox SYSTEM "../menus/C/firefox.xml">

<!ENTITY firestarter-firewall-tool SYSTEM "../menus/C/firestarter-firewall-tool.xml">

<!ENTITY font SYSTEM "../menus/C/font.xml">

<!ENTITY gaim SYSTEM "../menus/C/gaim.xml">

<!ENTITY games SYSTEM "../menus/C/games.xml">

<!ENTITY gftp SYSTEM "../menus/C/gftp.xml">

<!ENTITY gimp SYSTEM "../menus/C/gimp.xml">

<!ENTITY gnome-app-install SYSTEM "../menus/C/gnomeappinstall.xml">

<!ENTITY gnome-config-editor SYSTEM "../menus/C/gnome-config-editor.xml">

<!ENTITY gparted SYSTEM "../menus/C/gparted.xml">

<!ENTITY graphics SYSTEM "../menus/C/graphics.xml">

<!ENTITY gthumb SYSTEM "../menus/C/gthumb.xml">

<!ENTITY home-folder SYSTEM "../menus/C/home-folder.xml">

<!ENTITY inkscape SYSTEM "../menus/C/inkscape.xml">

<!ENTITY internet SYSTEM "../menus/C/internet.xml">

<!ENTITY keyboard SYSTEM "../menus/C/keyboard.xml">

<!ENTITY keyboard-shortcuts SYSTEM "../menus/C/keyboard-shortcuts.xml">

<!ENTITY limewire SYSTEM "../menus/C/limewire.xml">

<!ENTITY login-screen-setup SYSTEM "../menus/C/login-screen-setup.xml">

<!ENTITY logout SYSTEM "../menus/C/logout.xml">

<!ENTITY menu-editor SYSTEM "../menus/C/menu-editor.xml">

<!ENTITY menus-and-toolbars SYSTEM "../menus/C/menus-and-toolbars.xml">

<!ENTITY mouse SYSTEM "../menus/C/mouse.xml">

<!ENTITY multimedia-systems-selector SYSTEM "../menus/C/multimedia-systems-selector.xml">

<!ENTITY network-proxy SYSTEM "../menus/C/network-proxy.xml">

<!ENTITY networking SYSTEM "../menus/C/networking.xml">

<!ENTITY nvu SYSTEM "../menus/C/nvu.xml">

<!ENTITY open-office SYSTEM "../menus/C/open-office.xml">

<!ENTITY palmos-devices SYSTEM "../menus/C/palmos-devices.xml">

<!ENTITY preferred-applications SYSTEM "../menus/C/preferred-applications.xml">

<!ENTITY printing SYSTEM "../menus/C/printing.xml">

<!ENTITY qtparted SYSTEM "../menus/C/qtparted.xml">

<!ENTITY remote-desktop SYSTEM "../menus/C/remote-desktop.xml">

<!ENTITY removable-drives-and-media SYSTEM "../menus/C/removable-drives-and-media.xml">

<!ENTITY realplayer SYSTEM "../menus/C/realplayer.xml">

<!ENTITY rhythmbox SYSTEM "../menus/C/rhythmbox.xml">

<!ENTITY route-planner SYSTEM "../menus/C/route-planner.xml">

<!ENTITY screen-resolution SYSTEM "../menus/C/screen-resolution.xml">

<!ENTITY screensaver SYSTEM "../menus/C/screensaver.xml">

<!ENTITY scribus SYSTEM "../menus/C/scribus.xml">

<!ENTITY services SYSTEM "../menus/C/services.xml">

<!ENTITY sessions SYSTEM "../menus/C/sessions.xml">

<!ENTITY shared-folders SYSTEM "../menus/C/shared-folders.xml">

<!ENTITY skype SYSTEM "../menus/C/skype.xml">

<!ENTITY software-properties SYSTEM "../menus/C/software-properties.xml">

<!ENTITY sound SYSTEM "../menus/C/sound.xml">

<!ENTITY soundandvideo SYSTEM "../menus/C/soundandvideo.xml">

<!ENTITY synaptic SYSTEM "../menus/C/synaptic.xml">

<!ENTITY systemtools SYSTEM "../menus/C/systemtools.xml">

<!ENTITY terminal SYSTEM "../menus/C/terminal.xml">

<!ENTITY text-editor SYSTEM "../menus/C/text-editor.xml">

<!ENTITY theme SYSTEM "../menus/C/theme.xml">

<!ENTITY time-date SYSTEM "../menus/C/time-date.xml">

<!ENTITY totem SYSTEM "../menus/C/totem.xml">

<!ENTITY ubuntu-update-manager SYSTEM "../menus/C/ubuntu-update-manager.xml">

<!ENTITY users SYSTEM "../menus/C/users.xml">

<!ENTITY users-groups SYSTEM "../menus/C/users-groups.xml">

<!ENTITY windows SYSTEM "../menus/C/windows.xml">

<!ENTITY xchat-gnome SYSTEM "../menus/C/xchat-gnome.xml">

<!ENTITY xine SYSTEM "../menus/C/xine.xml">

<!ENTITY xmms SYSTEM "../menus/C/xmms.xml">

<!ENTITY % xinclude SYSTEM "../../../libs/xinclude.mod">

<!ELEMENT xi:include (xi:fallback)?>

<!ATTLIST xi:include xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude">

<!ATTLIST xi:include href CDATA #REQUIRED>

<!ATTLIST xi:include parse (xml | text) "xml">

<!ATTLIST xi:include xpointer CDATA #IMPLIED>

<!ATTLIST xi:include encoding CDATA #IMPLIED>

<!ATTLIST xi:include accept CDATA #IMPLIED>

<!ATTLIST xi:include accept-charset CDATA #IMPLIED>

<!ATTLIST xi:include accept-language CDATA #IMPLIED>

<!ELEMENT xi:fallback ANY>

<!ATTLIST xi:fallback xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude">

<!ENTITY % local.preface.class "| xi:include">

<!ENTITY % local.part.class "| xi:include">

<!ENTITY % local.chapter.class "| xi:include">

<!ENTITY % local.divcomponent.mix "| xi:include">

<!ENTITY % local.para.char.mix "| xi:include">

<!ENTITY % local.info.class "| xi:include">

<!ENTITY % local.common.attrib "xmlns:xi            CDATA       #FIXED       'http://www.w3.org/2001/XInclude'">

<!ENTITY language "en">

]>

<chapter id="gs-chap" status="complete">

        <title>Первые шаги</title>

 

        <sect1 id="gs-tools" status="complete">

                <title>Инструменты для работы с пакетами</title>

                

                <para>Существует большое количество программ, написанных специально для работы с пакетами в основанных на Debian системах. Многие из них не <emphasis>необходимы</emphasis> для создания пакетов, но очень полезны и зачастую автоматизируют повторяющиеся задания. Их страницы <application>man</application> и <application>info</application> хороший источник информации. Однако, следующий список пакетов, который выделен затенением, необходим для работы с пакетами:</para>

 

                <variablelist>

                        <varlistentry>

                                <term><application>build-essential</application></term>

                                <listitem><para>это метапакет, который зависит от <application>libc6-dev</application>, <application>gcc</application>, <application>g++</application>, <application>make</application>, и <application>dpkg-dev</application>. Одним из пакетов, с которым вы возможно не знакомы является <application>dpkg-dev</application>. Он содержит инструменты такие, как <application>dpkg-buildpackage</application> и <application>dpkg-source</application>, которые используются для создания, распаковки и сборки исходников и бинарных пакетов.</para></listitem>

                        </varlistentry>

 

                        <varlistentry>

                                <term><application>devscripts</application></term>

                                <listitem><para>содержит много скриптов, которые делают работу по поддержке пакетов намного легче. Некоторые из наиболее часто используемых - это <application>debdiff</application>, <application>dch</application>, <application>debuild</application>, и <application>debsign</application>.</para></listitem>

                        </varlistentry>

 

                        <varlistentry><term><application>debhelper</application> и <application>dh-make</application></term>

                                <listitem><para>скрипты, которые автоматизируют обычные задачи работы с пакетами. <application>dh-make</application> может использоваться для начальной "дебианизации" и содержит много файлов примеров.</para></listitem>

                        </varlistentry>

                                

                        <varlistentry><term><application>diff</application> и <application>patch</application></term> <listitem><para>are used to create

                                                and apply patches, respectively. They are used extensively in packaging

                                                because it is easier, cleaner, and more efficient to represent

                                                small changes as patches rather than to have multiple copies of a

                                                file.</para></listitem> </varlistentry>

                        

                        <varlistentry><term><application>gnupg</application></term>

                                <listitem><para>это полная и свободная замена PGP, используемая для цифровой подписи файлов (в том числе и пакетов)</para></listitem>

                        </varlistentry>

                                

                        <varlistentry><term><application>fakeroot</application></term>

                                <listitem><para>моделирует запуск команды с администраторскими привелегиями. Полезна при создании бинарных пакетов, работая с правами обычного пользователя.</para></listitem>

                        </varlistentry>

                        

                        <varlistentry><term><application>lintian</application> и <application>linda</application></term>

                                <listitem><para>разбирают пакеты Debian и сообщают о багах и нарушениях Policy. Они содержат автоматизированные проверки многих аспектов политики Debian Policy и распространненых ошибок.</para></listitem>

                        </varlistentry>

                        

                        <varlistentry><term><application>pbuilder</application></term>

                                <listitem><para>создает окружение chroot и собирает пакет внутри этого окружения. Это идеальная система чтобы проверять, что зависимости пакета верны, и чтобы собирать чистые пакеты для тестов и распространения.</para></listitem> </varlistentry>

                </variablelist>

 

        </sect1>

 

 

        <sect1 id="gs-bin_source" status="complete">

                <title>Бинарные пакеты и пакеты исходных кодов</title>

                

                <para>Большинство пользователей дистрибутивов, основанных на Debian, вроде <phrase>Ubuntu</phrase>, никогда не будут иметь дела с реальными исходными кодами, используемыми для создания всех приложений на их компьютерах. Вместо этого, исходные коды компилируются в <emphasis>бинарные (binary)</emphasis> пакеты из пакетов  <emphasis>исходных кодов (source)</emphasis>, котрые  собственно содержат как исходный код программы, так и правила для создания бинарных пакетов. Сборщики пакетов загружают пакеты исходных кодов вместе с внесенными ими изменениями на системы сборки, которые затем компилируют бинарные пакеты для каждой архитектуры. Отдельная система занимается  распространением сгенерированных бинарных .deb файлов и изменений исходных кодов по зеркалам репозиториев.</para>

 

        </sect1>

                

        <sect1 id="gs-pbuilder" status="complete" xreflabel="pbuilder">

                <title>Персональный сборщик: pbuilder</title>

                

                <para>Using pbuilder as a package builder allows you to build the package from

                        within a chroot environment. You can build binary packages without using

                        <application>pbuilder</application>, but you must have all the build

                        dependencies installed on your system first. However, pbuilder allows the

                        packager to check the build dependencies because the package is built within a

                        minimal <phrase>Ubuntu</phrase> installation, and the build dependencies are downloaded

                        according to the <filename>debian/control</filename> file.</para>

 

                <para>The following is a brief guide to installing, using, and

                        updating a pbuilder environment, however, there are many details

                        of <application>pbuilder</application> usage that are outside the

                        realm of this guide. The <application>pbuilder</application> man

                        page has lots of information and should be consulted if you

                        have problems or need more detailed information.</para>

 

        <sect2>

                <title>Установка и конфигурация окружения pbuilder</title>

                

                <para>Первая и наиболее очевидная вещь которую необходимо сделать - установить <application>pbuilder</application>. Если вы желаете создать <application>pbuilder</application> более нового релиза, чем тот который у вас установлен, вам понадобится вручную установить <application>debootstrap</application> .deb (на <ulink url="http://packages.ubuntu.com">packages.ubuntu.com</ulink>) из нового релиза. Чтобы создать pbuilder выполните:</para>

                

                <screen>

sudo pbuilder create --distribution &lt;distro&gt; \

        --othermirror "deb http://archive.ubuntu.com/ubuntu &lt;distro&gt; universe multiverse"

                </screen>

 

                <para>where &lt;distro&gt; is the release you want

                        (<emphasis>edgy</emphasis> for instance) to create the pbuilder

                        for. If you would like to create more than one

                        <application>pbuilder</application> environment you can append the

                        <emphasis>--basetgz</emphasis> flag with the desired location for

                        the compressed <application>pbuilder</application> environment.

                        The default is <filename>/var/cache/pbuilder/base.tgz</filename>.

                        If you do choose to use <emphasis>--basetgz</emphasis> you will

                        need to use it with the other <application>pbuilder</application>

                        commands so <application>pbuilder</application> knows which

                        compressed build environment to use.</para>

                

                <note><para>Creating a pbuilder environment will take some time as

                                <application>debootstrap</application> essentially downloads a minimal

                                <phrase>Ubuntu</phrase> installation.</para></note>

 

        </sect2>        

        

        <sect2>

                <title>Использование pbuilder</title>

                <para>Now that you have a running pbuilder you can build binary packages from

                        the source package by invoking:</para>

 

                <screen>sudo pbuilder build *.dsc</screen>

 

                <para>This will build all the source packages in the current directory. The

                        resulting .debs and source packages can be found in

                        <filename>/var/cache/pbuilder/result/</filename> (which can be

                        changed with the <emphasis>--buildresult</emphasis> flag).</para>

 

        </sect2>

 

        <sect2>

                <title>Обновление pbuilder</title>

                

                <para>Для обеспечения правильного нахождения зависимостей, у вас всегда должна быть текущая версия pbuilder всякий раз когда вы тестируете ваши пакеты с исходными кодами, особенно если вы создаете часто изменяемый релиз для разработки.</para>

 

                <screen>sudo pbuilder update</screen>

 

                <para/>

                

                <para>Если вы хотите обновить ваш pbuilder, вы можете использовать <application>pbuilder update</application> в комбинации с флагом <emphasis>--distribution</emphasis>:</para>

 

                <screen>sudo pbuilder update --distribution &lt;newdistro&gt; --override-config</screen>

 

        </sect2>

        

</sect1>

 

</chapter>