PERFORCE change 154426 for review
Gabor Pali
pgj at FreeBSD.org
Tue Dec 9 15:43:15 PST 2008
http://perforce.freebsd.org/chv.cgi?CH=154426
Change 154426 by pgj at kolbasz on 2008/12/09 23:43:08
Add Hungarian translation of chapter "The Documentation Build
Process" from FDP Primer
Affected files ...
.. //depot/projects/docproj_hu/doc/hu_HU.ISO8859-2/books/fdp-primer/doc-build/chapter.sgml#2 edit
Differences ...
==== //depot/projects/docproj_hu/doc/hu_HU.ISO8859-2/books/fdp-primer/doc-build/chapter.sgml#2 (text+ko) ====
@@ -31,113 +31,151 @@
-->
<!-- The FreeBSD Hungarian Documentation Project
+ Translated by: PALI, Gabor <pgj at FreeBSD.org>
%SOURCE% en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.sgml
%SRCID% 1.16
-->
<chapter id="doc-build" lang="hu">
- <title>The Documentation Build Process</title>
+ <title>A dokumentáció
+ elõállításának folyamata</title>
- <para>This chapter's main purpose is to clearly explain <emphasis>how
- the documentation build process is organized</emphasis>, and
- <emphasis>how to affect modifications to this process</emphasis>.
- </para>
+ <para>Ebben a fejezetben szeretnénk pontosan tisztázni
+ <emphasis>hogyan szervezõdik a dokumentáció
+ elõállításának folyamata</emphasis>
+ és <emphasis>hogyan tudunk ebbe
+ beavatkozni</emphasis>.</para>
- <para>After you have finished reading this chapter you should:</para>
+ <para>A fejezet elolvasása során
+ megismerjük:</para>
<itemizedlist>
<listitem>
- <para>Know what you need to build the FDP documentation, in
- addition to those mentioned in the <link
- linkend="tools">SGML tools chapter</link>.</para>
+ <para>az <link linkend="tools">SGML eszközeirõl
+ szóló fejezetben</link> említetteken
+ túl a &os; Dokumentációs Projekt keretein
+ belül készített dokumentáció
+ különbözõ változatainak
+ elõállításához mire van
+ még szükségünk;</para>
</listitem>
<listitem>
- <para>Be able to read and understand the
- <application>make</application> instructions that are present in
- each document's <filename>Makefile</filename>s, as well as an
- overview of the <filename>doc.project.mk</filename> includes.</para>
+ <para>a dokumentumokhoz tartozó
+ <filename>Makefile</filename> állományokban
+ szereplõ <command>make</command>
+ utasításokat, valamint a hivatkozott
+ <filename>doc.project.mk</filename> vázlatos
+ felépítését;</para>
</listitem>
-
+
<listitem>
- <para>Be able to customize the build process by using
- <application>make</application> variables and
- <application>make</application> targets.</para>
+ <para>további <command>make</command>
+ változókon és célokon keresztül
+ miként tudjuk testreszabni a dokumentáció
+ különbözõ változatainak
+ elõállítási folyamatát.</para>
</listitem>
</itemizedlist>
<sect1 id="doc-build-toolset">
- <title>The FreeBSD Documentation Build Toolset</title>
+ <title>A &os; dokumentáció
+ elõállításának
+ eszközei</title>
- <para>Here are your tools. Use them every way you can.</para>
+ <para>Munkánk folyamán az itt felsorolt
+ eszközök állnak rendelkezésünkre.
+ Használjuk ki az általuk nyújtott
+ lehetõségeket, amennyire csak tudjuk.</para>
<itemizedlist>
<listitem>
- <para>The primary build tool you will need is
- <application>make</application>, but specifically
+ <para>Az elsõdleges eszköz maga a
+ <command>make</command> parancs, pontosabban a
<application>Berkeley Make</application>.</para>
</listitem>
<listitem>
- <para>Package building is handled by FreeBSD's
- <application>pkg_create</application>. If you are not using
- FreeBSD, you will either have to live without packages, or
- compile the source yourself.</para>
+ <para>Csomagokat a &os; alaprendszerében
+ megtalálható <command>pkg_create</command>
+ programmal tudunk készíteni. Ha nem &os; alatt
+ dolgozunk, akkor vagy csomagok nélkül kell
+ dolgoznunk, vagy magunknak kell ezeket
+ elkészítenünk.</para>
</listitem>
<listitem>
- <para><application>gzip</application> is needed to create
- compressed versions of the document.
- <application>bzip2</application> compression and
- <application>zip</application> archives are also supported.
- <application>tar</application> is supported, but package
- building demands it.</para>
+ <para>A <command>gzip</command>
+ segítségével lehet az
+ elõállított dokumentumok
+ tömörített változatát
+ elkészíteni. Emellett még a
+ <command>bzip2</command> és <command>zip</command>
+ típusú tömörítés is
+ támogatott. A <command>tar</command> programot is
+ támogatjuk, a csomagok
+ készítéséhez kell.</para>
</listitem>
<listitem>
- <para><application>install</application> is the default method
- to install the documentation. There are alternatives,
- however.</para>
+ <para>A dokumentáció
+ telepítésének elfogadott eszköze az
+ <command>install</command> program. Természetesen
+ léteznek egyéb megoldások is.</para>
</listitem>
</itemizedlist>
<note>
- <para>It is unlikely you will have any trouble finding these last two, they
- are mentioned for completeness only.</para>
+ <para>Nem valószínû, hogy ez az utolsó
+ két eszközt ne lenne elérhetõ a
+ rendszerünkön, csupán a teljesség
+ kedvéért említettük meg ezeket.</para>
</note>
</sect1>
<sect1 id="doc-build-makefiles">
- <title>Understanding Makefiles in the Documentation tree</title>
+ <title>A dokumentációt tároló
+ könyvtárban található
+ <filename>Makefile</filename> állományok</title>
- <para>There are three main types of <filename>Makefile</filename>s
- in the FreeBSD Documentation Project tree.</para>
+ <para>A &os; Dokumentációs Projekt által
+ használt könyvtárakban megtalálható
+ <filename>Makefile</filename> állományoknak
+ három típusa létezik:</para>
<itemizedlist>
<listitem>
- <para><link linkend="sub-make">Subdirectory
- <filename>Makefile</filename>s</link> simply pass
- commands to those directories below them.</para>
+ <para>Az <link linkend="sub-make">alkönyvtári
+ <filename>Makefile</filename> állományok</link>
+ egyszerûen csak továbbadják a parancsokat
+ az alkönyvtáraiknak.</para>
</listitem>
<listitem>
- <para><link linkend="doc-make">Documentation
- <filename>Makefile</filename>s</link> describe the
- document(s) that should be produced from this directory.</para>
+ <para>A <link linkend="doc-make">dokumentumokra vonatkozó
+ <filename>Makefile</filename> állományok</link>
+ írják le, hogy milyen dokumentumokat kellene az
+ adott könyvtárban
+ elõállítani.</para>
</listitem>
<listitem>
- <para><link linkend="make-includes"><application>Make</application>
- includes</link> are the glue that perform the document production,
- and are usually of the form
- <filename>doc.<replaceable>xxx</replaceable>.mk</filename>.</para>
+ <para>Az <link linkend="make-includes"><filename>.mk</filename>
+ állományok</link> segítik valamilyen
+ formában a dokumentumok
+ elõállítását. Többnyire
+ <filename>doc.<replaceable>xxx</replaceable>.mk</filename>
+ névvel láthatóak.</para>
</listitem>
</itemizedlist>
<sect2 id="sub-make">
- <title>Subdirectory Makefiles</title>
+ <title>Az alkönyvtári <filename>Makefile</filename>
+ állományok</title>
- <para>These <filename>Makefile</filename>s usually take the form of:</para>
+ <para>Ezek a típusú <filename>Makefile</filename>
+ állományok általában a
+ következõ alakúak:</para>
<programlisting>SUBDIR =articles
SUBDIR+=books
@@ -147,58 +185,89 @@
DOC_PREFIX?= ${.CURDIR}/..
.include "${DOC_PREFIX}/share/mk/doc.project.mk"</programlisting>
- <para>In quick summary, the first four non-empty lines define the
- <application>make</application> variables,
- <makevar>SUBDIR</makevar>, <makevar>COMPAT_SYMLINK</makevar>,
- and <makevar>DOC_PREFIX</makevar>.</para>
+ <para>Röviden összefoglalva: az elsõ négy
+ nem üres sorban ún. <command>make</command>
+ változókat definiálunk. Ezek rendre a
+ <makevar>SUBDIR</makevar>, <makevar>COMPAT_SYMLINK</makevar>
+ és <makevar>DOC_PREFIX</makevar>.</para>
- <para>The first <makevar>SUBDIR</makevar> statement, as well as
- the <makevar>COMPAT_SYMLINK</makevar> statement, shows how to
- assign a value to a variable, overriding any previous
- value.</para>
+ <para>Az elsõ <makevar>SUBDIR</makevar> sornál,
+ illetve a <makevar>COMPAT_SYMLINK</makevar> sorában
+ láthatjuk hogyan kell egy új értéket
+ beállítani egy ilyen
+ változónak.</para>
- <para>The second <makevar>SUBDIR</makevar> statement shows how a
- value is appended to the current value of a variable. The
- <makevar>SUBDIR</makevar> variable is now <literal>articles
- books</literal>.</para>
+ <para>A második <makevar>SUBDIR</makevar> sorban azt
+ láthatjuk, hogyan tudunk a változó
+ aktuális értékéhez
+ továbbiakat hozzáfûzni. Ebben az esetben
+ tehát az utasítás
+ végrehajtása után a
+ <makevar>SUBDIR</makevar> értéke <literal>articles
+ books</literal> lesz.</para>
- <para>The <makevar>DOC_PREFIX</makevar> assignment shows how a
- value is assigned to the variable, but only if it is not already
- defined. This is useful if <makevar>DOC_PREFIX</makevar> is not
- where this <filename>Makefile</filename> thinks it is - the user
- can override this and provide the correct value.</para>
+ <para>A <makevar>DOC_PREFIX</makevar> esetében pedig olyan
+ értékadást figyelhetünk meg, amelyik
+ csak akkor hajtódik végre ténylegesen, ha a
+ változónak addig még nem volt
+ értéke. Ez olyankor tud kapóra jönni,
+ amikor a <makevar>DOC_PREFIX</makevar> nem pontosan az, amire a
+ <filename>Makefile</filename> számít — a
+ felhasználó ekkor meg tudja adni a helyes
+ értéket.</para>
- <para>Now what does it all mean? <makevar>SUBDIR</makevar>
- mentions which subdirectories below this one the build process
- should pass any work on to.</para>
+ <para>Ez így együttesen tehát mit is jelent? A
+ <makevar>SUBDIR</makevar> összefoglalja azokat a
+ könyvtárakat, amelyekben a dokumentumok
+ elõállításának
+ folyamatának folytatódnia kell majd.</para>
- <para><makevar>COMPAT_SYMLINK</makevar> is specific to
- compatibility symlinks (amazingly enough) for languages to their
- official encoding (<filename>doc/en</filename> would point to
- <filename>en_US.ISO-8859-1</filename>).</para>
+ <para>A <makevar>COMPAT_SYMLINK</makevar> a kompatibilitás
+ céljából létrehozott szimbolikus
+ linkekre vonatkozik, amelyek (valamilyen csoda folytán)
+ az adott nyelv hivatalos kódolására
+ mutatnak (tehát például a
+ <filename>doc/en</filename> a
+ <filename>en_US.ISO8859-1</filename>
+ könyvtárra).</para>
- <para><makevar>DOC_PREFIX</makevar> is the path to the root of the
- FreeBSD Document Project tree. This is not always that easy to
- find, and is also easily overridden, to allow for flexibility.
- <makevar>.CURDIR</makevar> is a <application>make</application>
- builtin variable with the path to the current directory.</para>
+ <para>A <makevar>DOC_PREFIX</makevar> a &os;
+ Dokumentációs Projekt
+ fõkönyvtárához vezetõ utat adja
+ meg. Ezt nem mindig egyszerû megtalálni,
+ ezért a rugalmasság kedvéért
+ könnyedén felül is definiálható.
+ A <makevar>.CURDIR</makevar> a <command>make</command> egyik
+ saját belsõ változója, amelyben az
+ aktuális könyvtár elérési
+ útját tárolja.</para>
- <para>The final line includes the FreeBSD Documentation Project's
- project-wide <application>make</application> system file
- <filename>doc.project.mk</filename> which is the glue which
- converts these variables into build instructions.</para>
+ <para>Végül az utolsó sorban a &os;
+ Dokumentációs Projekt összes
+ <filename>Makefile</filename> állományára
+ vonatkozó, rendszerszintû
+ <filename>doc.project.mk</filename> állományra
+ hivatkozunk, amelyen keresztül az iménti
+ változókból épül fel a
+ dokumentumok elõállításának
+ pontos menete.</para>
+ </sect2>
- </sect2>
<sect2 id="doc-make">
- <title>Documentation Makefiles</title>
+ <title>A dokumentumokra vonatkozó
+ <filename>Makefile</filename> állományok</title>
- <para>These <filename>Makefile</filename>s set a bunch of
- <application>make</application> variables that describe how to
- build the documentation contained in that directory.</para>
+ <para>Ezekben a <filename>Makefile</filename>
+ állományokban az adott könyvtárban
+ található dokumentumok
+ elõállítását
+ leíró különbözõ
+ <command>make</command> változók
+ szerepelnek.</para>
- <para>Here is an example:</para>
+ <para>Lássunk erre egy példát:</para>
- <programlisting>MAINTAINER=nik at FreeBSD.org
+ <programlisting>MAINTAINER=pgj at FreeBSD.org
DOC?= book
@@ -207,78 +276,106 @@
INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=
-# SGML content
+# Az SGML forrás
SRCS= book.sgml
DOC_PREFIX?= ${.CURDIR}/../../..
.include "$(DOC_PREFIX)/share/mk/docproj.docbook.mk"</programlisting>
- <para>The <makevar>MAINTAINER</makevar> variable is a very
- important one. This variable provides the ability to claim
- ownership over a document in the FreeBSD Documentation
- Project, whereby you gain the responsibility for maintaining
- it.</para>
+ <para>A <makevar>MAINTAINER</makevar> változó nagyon
+ fontos. A &os; Dokumentációs Projekten belül
+ ezen a változón keresztül jelezhetjük a
+ dokumentum birtoklását, vagyis
+ karbantartási kötelezettségünket.</para>
- <para><makevar>DOC</makevar> is the name (sans the
- <filename>.sgml</filename> extension) of the main document
- created by this directory. <makevar>SRCS</makevar> lists all
- the individual files that make up the document. This should
- also include important files in which a change should result
- in a rebuild.</para>
+ <para>A <makevar>DOC</makevar> hivatkozik (az
+ <filename>.sgml</filename> kiterjesztés
+ nélkül) az adott könyvtárban
+ található dokumentum fõ
+ forrására. Emellett az <makevar>SRCS</makevar>
+ változóban kell összefoglalnunk a
+ dokumentumot alkotó források neveit. Ebben
+ érdemes megadni minden olyan állományt,
+ amelynek megváltozása esetén újra
+ elõ kell állítani az érintett
+ dokumentumot.</para>
- <para><makevar>FORMATS</makevar> indicates the default formats
- that should be built for this document.
- <makevar>INSTALL_COMPRESSED</makevar> is the default list of
- compression techniques that should be used in the document
- build. <makevar>INSTALL_ONLY_COMPRESS</makevar>, empty by
- default, should be non-empty if only compressed documents are
- desired in the build.</para>
+ <para>A <makevar>FORMATS</makevar>
+ segítségével definiáljuk a dokumentum
+ alapértelmezetten elõállítandó
+ formátumait. A <makevar>INSTALL_COMPRESSED</makevar>
+ változóban a dokumentum
+ elkészítésekor felhasználandó
+ tömörítési formákat adhatjuk meg.
+ A <makevar>INSTALL_ONLY_COMPRESSED</makevar>
+ változó alapból üres, de ha adunk neki
+ valamilyen egyéb értéket, akkor a
+ dokumentumoknak csak a tömörített
+ változata fog elkészülni.</para>
<note>
- <para>We covered optional variable assignments in the
- <link linkend="sub-make">previous section</link>.</para>
+ <para>A változók feltételes
+ értékadásáról már
+ volt szó <link linkend="sub-make">az elõzõ
+ szakaszban</link>.</para>
</note>
- <para>The <makevar>DOC_PREFIX</makevar> and include statements
- should be familiar already.</para>
+ <para>A <makevar>DOC_PREFIX</makevar> változó
+ és az <literal>.include</literal> utasítás a
+ korábbiak alapján már ismerõs
+ lehet.</para>
</sect2>
</sect1>
<sect1 id="make-includes">
- <title>FreeBSD Documentation Project make includes</title>
+ <title>A &os; Dokumentációs Projekt
+ <filename>.mk</filename> állományai</title>
- <para>This is best explained by inspection of the code. Here are
- the system include files:</para>
+ <para>Ezek az állományok legjobban talán
+ önmagukon keresztül mutathatóak be. A
+ következõ rendszerszintû <filename>.mk</filename>
+ állományokat használjuk a &os;
+ Dokumentációs Projektben:</para>
<itemizedlist>
<listitem>
- <para><filename>doc.project.mk</filename> is the main project
- include file, which includes all the following include files, as
- necessary.</para>
+ <para>A <filename>doc.project.mk</filename> a központi
+ <filename>.mk</filename> állomány, amely
+ szükség szerint hivatkozik az összes
+ többi <filename>.mk</filename>
+ állományra.</para>
</listitem>
<listitem>
- <para><filename>doc.subdir.mk</filename> handles traversing of
- the document tree during the build and install processes.</para>
+ <para>Az elõállítás és a
+ telepítés során a
+ <filename>doc.subdir.mk</filename> felelõs a dokumentumokat
+ tároló könyvtárak
+ bejárásért.</para>
</listitem>
<listitem>
- <para><filename>doc.install.mk</filename> provides variables
- that affect ownership and installation of documents.</para>
+ <para>A <filename>doc.install.mk</filename> tartalmazza a
+ karbantartóval és a telepítéssel
+ kapcsolatos változókat.</para>
</listitem>
<listitem>
- <para><filename>doc.docbook.mk</filename> is included if
- <makevar>DOCFORMAT</makevar> is <literal>docbook</literal>
- and <makevar>DOC</makevar> is set.</para>
+ <para>A <filename>doc.docbook.mk</filename>
+ állomány csak akkor kerül
+ feldolgozásra, ha a <makevar>DOCFORMAT</makevar>
+ értéke <literal>docbook</literal> és a
+ <makevar>DOC</makevar> változónak van
+ értéke.</para>
</listitem>
</itemizedlist>
<sect2>
- <title>doc.project.mk</title>
+ <title>A <filename>doc.project.mk</filename>
+ állomány</title>
- <para>By inspection:</para>
+ <para>Nézzünk bele:</para>
<programlisting>DOCFORMAT?= docbook
MAINTAINER?= doc at FreeBSD.org
@@ -296,99 +393,146 @@
.include "doc.install.mk"</programlisting>
<sect3>
+ <title>Változók</title>
- <title>Variables</title>
+ <para>Ha nem állítjuk be a dokumentum
+ <filename>Makefile</filename>
+ állományában, akkor a
+ <makevar>DOCFORMAT</makevar> és a
+ <makevar>MAINTAINER</makevar> változók ezen a
+ helyen kapnak értéket.</para>
- <para><makevar>DOCFORMAT</makevar> and <makevar>MAINTAINER</makevar>
- are assigned default values, if these are not set by the
- document make file.</para>
+ <para>A <makevar>PREFIX</makevar> adja azt a
+ könyvtárat, amelyen belül
+ elérhetõek <link linkend="tools">a
+ dokumentáció
+ elõállításához
+ szükséges eszközök</link>.
+ A csomagok és portok átlagos használata
+ esetén ez a <filename>/usr/local</filename>.</para>
- <para><makevar>PREFIX</makevar> is the prefix under which the
- <link linkend="tools">documentation building tools</link> are
- installed. For normal package and port installation, this is
- <filename>/usr/local</filename>.</para>
+ <para>A <makevar>PRI_LANG</makevar> adja meg azt a nyelvet
+ és kódolást, amely a
+ dokumentációt olvasó
+ felhasználó számára
+ elsõdlegesként leginkább elfogadott.
+ Alapértelmezés szerint ez az amerikai
+ angol.</para>
- <para><makevar>PRI_LANG</makevar> should be set to whatever
- language and encoding is natural amongst users these documents are
- being built for. US English is the default.</para>
-
<note>
- <para><makevar>PRI_LANG</makevar> in no way affects what documents
- can, or even will, be built. Its main use is creating links to
- commonly referenced documents into the FreeBSD documentation
- install root.</para>
+ <para>A <makevar>PRI_LANG</makevar> változó
+ semmilyen hatással nincs a dokumentumok
+ elõállítására.
+ Egyedül a &os; dokumentáció
+ telepítésekor a leggyakrabban hivatkozott
+ dokumentumokhoz létrehozandó szimbolikus
+ linkek készítésénel van
+ szerepe.</para>
</note>
</sect3>
<sect3>
- <title>Conditionals</title>
-
- <para>The <literal>.if defined(DOC)</literal> line is an example of
- a <application>make</application> conditional which, like in
- other programs, defines behavior if some condition is true or
- if it is false. <literal>defined</literal> is a function which
- returns whether the variable given is defined or not.</para>
+ <title>Elágazások</title>
+
+ <para>A <literal>.if defined(DOC)</literal> sorban a
+ <filename>Makefile</filename> állományokban
+ megadható elágazásokra láthatunk
+ példát. Hasonlóan más
+ programokhoz, a <filename>Makefile</filename>
+ mûködését tudjuk meghatározni
+ egy logikai kifejezés
+ igazságértéktõl függõen.
+ Ebben a kifejezésben a <literal>defined</literal>
+ függvény, amely megadja, hogy a
+ paramétereként megadott változó
+ definiált-e.</para>
- <para><literal>.if ${DOCFORMAT} == "docbook"</literal>, next,
- tests whether the <makevar>DOCFORMAT</makevar> variable is
- <literal>"docbook"</literal>, and in this case, includes
- <filename>doc.docbook.mk</filename>.</para>
+ <para>A következõ elágazásban, vagyis az
+ <literal>.if ${DOCFORMAT} == "docbook"</literal>
+ utasításban azt vizsgáljuk meg, hogy a
+ <makevar>DOCFORMAT</makevar> változó
+ értéke <literal>"docbook"</literal> vagy sem.
+ Amennyiben a válasz erre igen (vagyis
+ <quote>igaz</quote>), beemeljük a
+ <filename>doc.docbook.mk</filename> tartalmát.</para>
- <para>The two <literal>.endif</literal>s close the two above
- conditionals, marking the end of their application.</para>
+ <para>Az elõbb említett két
+ elágazást rendre az <literal>.endif</literal>
+ kulcsszóval zárjuk le.</para>
</sect3>
</sect2>
<sect2>
- <title>doc.subdir.mk</title>
+ <title>A <filename>doc.subdir.mk</filename>
+ állomány</title>
- <para>This is too long to explain by inspection, you should be
- able to work it out with the knowledge gained from the previous
- chapters, and a little help given here.</para>
+ <para>Ez az állomány már
+ túlságosan nagy ahhoz, hogy a fejezeten belül
+ könnyen ki lehessen elemezni. Ezért az
+ elõzõ szakaszok alapján a részleteket a
+ kedves Olvasóra bízzuk, ehhez adunk még itt
+ némi segítséget.</para>
<sect3>
- <title>Variables</title>
+ <title>Változók</title>
<itemizedlist>
<listitem>
- <para><makevar>SUBDIR</makevar> is a list of subdirectories
- that the build process should go further down
- into.</para>
+ <para>A <makevar>SUBDIR</makevar> tartalmazza azokat az
+ alkönyvtárakat, amelyeket a feldolgozás
+ során be kell járnunk.</para>
</listitem>
<listitem>
- <para><makevar>ROOT_SYMLINKS</makevar> is the name of
- directories that should be linked to the document
- install root from their actual locations, if the current
- language is the primary language (specified by
- <makevar>PRI_LANG</makevar>).</para>
+ <para>A <makevar>ROOT_SYMLINKS</makevar> a
+ dokumentáció
+ fõkönyvtárából
+ szimbolikusan linkelendõ könyvtárak
+ neveit adja meg, amennyiben az adott nyelv (a
+ <makevar>PRI_LANG</makevar> változó szerint)
+ az elsõdleges.</para>
</listitem>
<listitem>
- <para><makevar>COMPAT_SYMLINK</makevar> is described in the
- <link linkend="sub-make">Subdirectory Makefile</link>
- section.</para>
+ <para>A <makevar>COMPAT_SYMLINK</makevar>
+ változót már korábban bemutattuk
+ <link linkend="sub-make">az alkönyvtári
+ <filename>Makefile</filename>
+ állományok</link> címû
+ szakaszban.</para>
</listitem>
</itemizedlist>
</sect3>
<sect3>
- <title>Targets and macros</title>
+ <title>Célok és makrók</title>
- <para>Dependencies are described by
- <literal><replaceable>target</replaceable>:
- <replaceable>dependency1 dependency2 ...</replaceable></literal>
- tuples, where to build <literal>target</literal>, you need to build
- the given dependencies first.</para>
+ <para>A függõségi viszonyokat
+ <literal><replaceable>cél</replaceable>:
+ <replaceable>függõség1
+ függõség2 ...</replaceable></literal>
+ formában írjuk fel, ahol így megmondjuk,
+ hogy a <literal>cél</literal>
+ létrehozásához elõször milyen
+ elemeknek kell létezniük. Ezeket nevezzük
+ függõségeknek.</para>
- <para>After that descriptive tuple, instructions on how to build
- the target may be given, if the conversion process between the
- target and its dependencies are not previously defined, or if
- this particular conversion is not the same as the default
- conversion method.</para>
+ <para>A függõségi viszony megadása alatt
+ lehetõségünk van részletezni a
+ függõségekbõl a cél
+ elõállításához
+ szükséges utasításokat. Ezt akkor
+ kell megtenni, ha a cél és a
+ függõségek közti
+ átalakítást elõzõleg még
+ nem definiáltuk, vagy ha az adott esetben az
+ átalakítás eltér a
+ korábbiaktól.</para>
- <para>A special dependency <literal>.USE</literal> defines
- the equivalent of a macro.</para>
+ <para>A <literal>.USE</literal> nevû speciális
+ függõség egy makróval
+ egyenértékû eszköz
+ használatára ad lehetõséget.</para>
<programlisting>_SUBDIRUSE: .USE
.for entry in ${SUBDIR}
@@ -397,80 +541,114 @@
${MAKE} ${.TARGET:S/realpackage/package/:S/realinstall/install/} DIRPRFX=${DIRPRFX}${entry}/ )
.endfor</programlisting>
- <para>In the above, <maketarget>_SUBDIRUSE</maketarget> is now a
- macro which will execute the given commands when it is listed
- as a dependency.</para>
+ <para>A fenti kódrészletben tehát a
+ <maketarget>_SUBDIRUSE</maketarget> most már egy
+ <quote>makró</quote> lesz, amely ha megjelenik a
+ függõségek között, akkor a
+ törzsében megadott parancsokat hajtja
+ végre.</para>
- <para>What sets this macro apart from other targets? Basically,
- it is executed <emphasis>after</emphasis> the instructions
- given in the build procedure it is listed as a dependency to,
- and it does not adjust <makevar>.TARGET</makevar>, which is the
- variable which contains the name of the target currently
- being built.</para>
+ <para>Mi különbözteti meg ezt a makrót a
+ többi céltól? Két lényeges
+ eltérés: elõször is, a benne megadott
+ utasítások a rá
+ függõségként hivatkozó
+ célhoz társított
+ átalakítást végzõ
+ utasítások <emphasis>után</emphasis>
+ fognak lefutni, másrészt nem befolyásolja
+ a jelenleg feldolgozás alatt álló
+ cél nevét tároló
+ <makevar>.TARGET</makevar> változó
+ értékét.</para>
<programlisting>clean: _SUBDIRUSE
rm -f ${CLEANFILES}</programlisting>
- <para>In the above, <maketarget>clean</maketarget> will use the
- <maketarget>_SUBDIRUSE</maketarget> macro after it has
- executed the instruction
- <command>rm -f ${CLEANFILES}</command>. In effect, this causes
- <maketarget>clean</maketarget> to go further and further down
- the directory tree, deleting built files as it goes
- <emphasis>down</emphasis>, not on the way back up.</para>
+ <para>Ebben a kódrészletben a tehát
+ <maketarget>clean</maketarget> esetében csak az
+ <command>rm -r ${CLEANFILES}</command> parancs lefutása
+ után fog végrehajtódni a
+ <maketarget>_SUBDIRUSE</maketarget> makró tartalma.
+ Ennek hatására a <maketarget>clean</maketarget>
+ megy egyre lentebb és lentebb a
+ könyvtárszerkezetben,
+ <emphasis>miközben</emphasis> törli a
+ elõzõleg elõállított
+ állományokat.</para>
<sect4>
- <title>Provided targets</title>
+ <title>Definiált célok</title>
<itemizedlist>
<listitem>
- <para><maketarget>install</maketarget> and
- <maketarget>package</maketarget> both go down the
- directory tree calling the real versions of themselves
- in the subdirectories
- (<maketarget>realinstall</maketarget> and
- <maketarget>realpackage</maketarget>
- respectively).</para>
+ <para>Az <maketarget>install</maketarget> és a
+ <maketarget>package</maketarget> célok
+ egyaránt folyamatosan haladnak lefelé a
+ könyvtárszerkezetben és az
+ alkönyvtárakban hívják
+ saját maguk tényleges
+ változatát (ezek a
+ <maketarget>realinstall</maketarget> és
+ <maketarget>realpackage</maketarget>).</para>
</listitem>
<listitem>
- <para><maketarget>clean</maketarget> removes files created
- by the build process (and goes down the directory tree
- too). <maketarget>cleandir</maketarget> does the same,
- and also removes the object directory, if any.</para>
+ <para>A <maketarget>clean</maketarget>
+ eltávolítja a folyamat során
+ keletkezett állományokat (és az
+ elõbbiekhez hasonlóan lefele halad a
+ könyvtárszerkezetben). A
+ <maketarget>cleandir</maketarget> ugyanezt
+ csinálja, de ha talál a
+ tárgykódokhoz tartozó
+ könyvtárat, akkor azt is törli.</para>
</listitem>
</itemizedlist>
</sect4>
</sect3>
<sect3>
- <title>More on conditionals</title>
+ <title>Bõvebben a feltételes
+ kifejezésekrõlzekrõl</title>
<itemizedlist>
<listitem>
- <para><literal>exists</literal> is another condition
- function which returns true if the given file exists.</para>
+ <para>Az <literal>exists</literal> egy másik logikai
+ függvény, amellyel lekérdezhetjük,
+ hogy a paramétereként megadott
+ állomány létezik-e.</para>
</listitem>
<listitem>
- <para><literal>empty</literal> returns true if the given
- variable is empty.</para>
+ <para>Az <literal>empty</literal> logikai
+ függvény igaz értékû, ha a
+ paramétereként megadott
+ változó értéke
+ üres.</para>
</listitem>
<listitem>
- <para><literal>target</literal> returns true if the given
- target does not already exist.</para>
+ <para>A <literal>target</literal> logikai
+ függvény igaz értékû, ha a
+ paraméterként megadott cél még
+ nem létezik.</para>
</listitem>
</itemizedlist>
</sect3>
<sect3>
- <title>Looping constructs in make (.for)</title>
+ <title>Ciklusszerverzési lehetõségek
+ (<literal>.for</literal>)</title>
- <para><literal>.for</literal> provides a way to repeat a set of
- instructions for each space-separated element in a variable.
- It does this by assigning a variable to contain the current
- element in the list being examined.</para>
+ <para>A <literal>.for</literal> utasítás
+ segítségével adott
+ utasításokat tudunk elvégezni egy
+ változó tartalmaként megadott,
+ szóközökkel határolt elemekre. A
+ ciklus belsejében egy változóból
+ érhetjük el az aktuálisan feldolgozott
+ elemet.</para>
<programlisting>_SUBDIRUSE: .USE
.for entry in ${SUBDIR}
@@ -479,12 +657,15 @@
${MAKE} ${.TARGET:S/realpackage/package/:S/realinstall/install/} DIRPRFX=${DIRPRFX}${entry}/ )
.endfor</programlisting>
- <para>In the above, if <makevar>SUBDIR</makevar> is empty, no
- action is taken; if it has one or more elements, the
- instructions between <literal>.for</literal> and
- <literal>.endfor</literal> would repeat for every element,
- with <makevar>entry</makevar> being replaced with the value of
- the current element.</para>
+ <para>A fenti kódrészletben ha a
+ <makevar>SUBDIR</makevar> üres, akkor nem
+ történik semmi. Ha viszont egy vagy több
+ elemet is tartalmaz, akkor a <literal>.for</literal> és
+ az <literal>.endfor</literal> között megadott
+ utasítások megismétlõdnek minden
+ egyes elem esetén. Ezek értékét a
+ ciklus belsejében rendre a <makevar>entry</makevar>
+ változóban veszi fel.</para>
</sect3>
</sect2>
</sect1>
More information about the p4-projects
mailing list