Changeset View
Standalone View
en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
Show First 20 Lines • Show All 4,116 Lines • ▼ Show 20 Lines | |||||
.include <bsd.port.post.mk></programlisting> | .include <bsd.port.post.mk></programlisting> | ||||
</example> | </example> | ||||
</sect1> | </sect1> | ||||
<sect1 xml:id="using-xfce"> | <sect1 xml:id="using-xfce"> | ||||
<title>Using Xfce</title> | <title>Using Xfce</title> | ||||
<para><varname>USE_XFCE</varname> is used to | <para>Ports that need <application>Xfce</application> libraries or | ||||
autoconfigure the dependencies for ports which use an Xfce | applications set <literal>USES=xfce</literal>.</para> | ||||
based library or application like | |||||
<package role="port">x11-toolkits/libxfce4gui</package> | |||||
and <package role="port">x11-wm/xfce4-panel</package>.</para> | |||||
<para>These Xfce libraries and applications are | <para>Specific <application>Xfce</application> library and | ||||
recognized:</para> | application dependencies are set with values assigned to | ||||
wblock: This sentence goes in a circle from "when a port needs" to "dependencies the port needs". It… | |||||
Done Inline ActionsStill needs wblock: Still needs
s/libraries/library/
s/applications/application/ | |||||
<varname>USE_XFCE</varname>. They are defined in | |||||
<filename>/usr/ports/Mk/Uses/xfce.mk</filename>. The possible | |||||
values are:</para> | |||||
Not Done Inline ActionsI like this. wblock: I like this. | |||||
<itemizedlist> | <variablelist> | ||||
<title>Values of <varname>USE_XFCE</varname></title> | |||||
<varlistentry> | |||||
<term>garcon</term> | |||||
<listitem> | <listitem> | ||||
<para>libexo: <package | <para><package role="port">sysutils/garcon</package></para> | ||||
role="port">x11/libexo</package></para> | |||||
</listitem> | </listitem> | ||||
</varlistentry> | |||||
<varlistentry> | |||||
<term>libexo</term> | |||||
<listitem> | <listitem> | ||||
<para>libgui: <package | <para><package role="port">x11/libexo</package></para> | ||||
role="port">x11-toolkits/libxfce4gui</package></para> | |||||
</listitem> | </listitem> | ||||
</varlistentry> | |||||
<varlistentry> | |||||
<term>libgui</term> | |||||
<listitem> | <listitem> | ||||
<para>libutil: <package | <para><package | ||||
role="port">x11/libxfce4util</package></para> | role="port">x11-toolkits/libxfce4gui</package></para> | ||||
</listitem> | </listitem> | ||||
</varlistentry> | |||||
<varlistentry> | |||||
<term>libmenu</term> | |||||
<listitem> | <listitem> | ||||
<para>libmcs: <package | <para><package role="port">x11/libxfce4menu</package></para> | ||||
Not Done Inline Actions"current" is a little unclear. Does it mean "the list of dependencies that can be declared"? wblock: "current" is a little unclear. Does it mean "the list of dependencies that can be declared"? | |||||
Not Done Inline ActionsIt means that in doubt, this file contains the reference code as the handbook may lag a bit. Maybe I should merge this paragraph and the one before the list. I'll try that. mat: It means that in doubt, this file contains the reference code as the handbook may lag a bit. | |||||
role="port">x11/libxfce4mcs</package></para> | |||||
</listitem> | </listitem> | ||||
</varlistentry> | |||||
<varlistentry> | |||||
<term>libutil</term> | |||||
<listitem> | <listitem> | ||||
<para>mcsmanager: <package | <para><package role="port">x11/libxfce4util</package></para> | ||||
role="port">sysutils/xfce4-mcs-manager</package></para> | |||||
</listitem> | </listitem> | ||||
</varlistentry> | |||||
<varlistentry> | |||||
<term>panel</term> | |||||
Not Done Inline ActionsWhat does "own" mean? "Custom"? (And it should be capitalized in this title.) wblock: What does "own" mean? "Custom"? (And it should be capitalized in this title.) | |||||
Not Done Inline ActionsI have no idea, I don't use either Xfce or GTK3. Maybe the order of the words is wrong and it should be "Using Xfce's own GTK3 widgets" mat: I have no idea, I don't use either Xfce or GTK3. Maybe the order of the words is wrong and it… | |||||
<listitem> | <listitem> | ||||
<para>panel: <package | <para><package | ||||
Not Done Inline ActionsNo "s" on "specific", and it would be more understandable with a dash (and no comma after "widgets"): <application>GTK3</application>-specific widgets <package wblock: No "s" on "specific", and it would be more understandable with a dash (and no comma after… | |||||
role="port">x11-wm/xfce4-panel</package></para> | role="port">x11-wm/xfce4-panel</package></para> | ||||
</listitem> | </listitem> | ||||
</varlistentry> | |||||
<listitem> | <varlistentry> | ||||
<para>thunar: <package | <term>thunar</term> | ||||
role="port">x11-fm/thunar</package></para> | |||||
</listitem> | |||||
<listitem> | <listitem> | ||||
<para>wm: <package | <para><package role="port">x11-fm/thunar</package></para> | ||||
role="port">x11-wm/xfce4-wm</package></para> | |||||
</listitem> | </listitem> | ||||
</varlistentry> | |||||
<varlistentry> | |||||
<term>xfconf</term> | |||||
<listitem> | <listitem> | ||||
<para>xfdev: <package | <para><package role="port">x11/xfce4-conf</package></para> | ||||
role="port">dev/xfce4-dev-tools</package></para> | |||||
</listitem> | </listitem> | ||||
</itemizedlist> | </varlistentry> | ||||
</variablelist> | |||||
<para>These additional parameters are recognized:</para> | <example xml:id="use-xfce"> | ||||
<title><varname>USES=xfce</varname> Example</title> | |||||
<itemizedlist> | <programlisting>USES= xfce | ||||
<listitem> | USE_XFCE= libmenu</programlisting> | ||||
<para>configenv: Use this if the port requires a special | </example> | ||||
modified <varname>CONFIGURE_ENV</varname> to find its | |||||
required libraries.</para> | |||||
<programlisting>-I${LOCALBASE}/include -L${LOCALBASE}/lib</programlisting> | <example xml:id="use-xfce-gtk3"> | ||||
<title>Using Xfce's Own GTK3 Widgets</title> | |||||
Not Done Inline ActionsI don't really have an example, I added that bit to remind people that THEY SHALL LIST ALL DEPENDENCIES EXPLICITLY :-) mat: I don't really have an example, I added that bit to remind people that **THEY SHALL LIST ALL… | |||||
<para>gets added to CPPFLAGS to | <para>In this example, the ported application uses the | ||||
<varname>CONFIGURE_ENV</varname>.</para> | <application>GTK3</application>-specific widgets <package | ||||
</listitem> | role="port">x11/libxfce4menu</package> and <package | ||||
Not Done Inline ActionsNo comma needed here. There is no pause, it just says "X uses A and B." wblock: No comma needed here. There is no pause, it just says "X uses A and B." | |||||
</itemizedlist> | role="port">x11/xfce4-conf</package>.</para> | ||||
<para>Therefore, if a port has a dependency on | <programlisting>USES= xfce:gtk3 | ||||
<package role="port">sysutils/xfce4-mcs-manager</package> | USE_XFCE= libmenu xfconf</programlisting> | ||||
and requires the special CPPFLAGS in its configure | </example> | ||||
environment, the syntax will be:</para> | |||||
<programlisting>USE_XFCE= mcsmanager configenv</programlisting> | <tip> | ||||
<para><application>Xfce</application> components included this | |||||
way will automatically include any dependencies they need. It | |||||
is no longer necessary to specify the entire list. If the | |||||
port only needs <package | |||||
role="port">x11-wm/xfce4-panel</package>, use:</para> | |||||
<programlisting>USES= xfce | |||||
USE_XFCE= panel</programlisting> | |||||
<para>There is no need to list the components <package | |||||
role="port">x11-wm/xfce4-panel</package> needs itself like | |||||
this:</para> | |||||
<programlisting>USES= xfce | |||||
USE_XFCE= libexo libmenu libutil panel</programlisting> | |||||
<para>However, <application>Xfce</application> components and | |||||
non-<application>Xfce</application> dependencies of the port | |||||
Done Inline ActionsSpelling error, I think: s/garanties/guarantees/ gjb: Spelling error, I think: s/garanties/guarantees/ | |||||
Not Done Inline Actionsgoogle translate agrees with you :-) mat: google translate agrees with you :-) | |||||
Not Done Inline ActionsWell, s/guarantees/guarantee/ but the meaning is still fuzzy. wblock: Well, s/guarantees/guarantee/
but the meaning is still fuzzy. | |||||
must be included explicitly. Do not count on an | |||||
<application>Xfce</application> component to provide a | |||||
sub-dependency other than itself for the main port.</para> | |||||
</tip> | |||||
Not Done Inline ActionsThis sentence is kind of hard to understand. The previous sentence says "There is no need to list the components..." But then this one seems to contradict that. Maybe. There are two different starts to the sentence: Note, however, that, So... what is this really trying to say? wblock: This sentence is kind of hard to understand. The previous sentence says "There is no need to… | |||||
Not Done Inline Actionsyou must list all the dependencies the port needs to build, and not count on a dependency to bring in something as it could change. mat: you must list all the dependencies the port needs to build, and not count on a dependency to… | |||||
Not Done Inline ActionsAha! So is this xfce components included this way will automatically include any dependencies they need. However, xfce components and non-xfce dependencies of the port must be included explicitly. Do not count on an xfce component to provide a sub-dependency other than itself for the main port. (An example might help.) wblock: Aha! So is this
xfce components included this way will automatically include any… | |||||
</sect1> | </sect1> | ||||
<sect1 xml:id="using-mozilla"> | <sect1 xml:id="using-mozilla"> | ||||
<title>Using Mozilla</title> | <title>Using Mozilla</title> | ||||
<table frame="none" xml:id="using-mozilla-variables"> | <table frame="none" xml:id="using-mozilla-variables"> | ||||
<title>Variables for Ports That Use Mozilla</title> | <title>Variables for Ports That Use Mozilla</title> | ||||
▲ Show 20 Lines • Show All 456 Lines • Show Last 20 Lines |
This sentence goes in a circle from "when a port needs" to "dependencies the port needs". It is really at least two sentences.
Try to be declarative rather than using an if/then structure ("when" is better than if, but there is still a pause after it).
Maybe:
Ports that need Xfce libraries or applications set USES=xfce. Specific dependencies are set with values assigned to USE_XFCE as shown below.