Date: Tue, 9 Dec 2008 23:43:14 GMT From: Gabor Pali <pgj@FreeBSD.org> To: Perforce Change Reviews <perforce@FreeBSD.org> Subject: PERFORCE change 154426 for review Message-ID: <200812092343.mB9NhEUn093973@repoman.freebsd.org>
next in thread | raw e-mail | index | archive | help
http://perforce.freebsd.org/chv.cgi?CH=154426 Change 154426 by pgj@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@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@FreeBSD.org + <programlisting>MAINTAINER=pgj@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@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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200812092343.mB9NhEUn093973>