doc/en/gnome/docs/gnome_porting.sgml
Hiroki Sato cfd9e12239 www cleanup mega commit:
- Move includes.nav*.sgml to share/sgml/navibar.ent and
   <lang>/share/sgml/nabibar.l10n.ent.

 - Move includes.sgml and includes.xsl to
   share/sgml/common.ent, share/sgml/header.ent, <lang>/share/sgml/l10n.ent,
   and <lang>?share/sgml/header.l10n.ent.

 - Move most of XSLT libraries to share/sgml/*.xsl and
   <lang>/share/sgml/*.xsl.

 - Move news.xml and other *.xml files for the similar purpose
   to share/sgml/*.xml and <lang>/share/sgml/*.xml.

 - Switch to use a custom DTD for HTML document.  Now we use
   "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension", which is
   HTML 4.01 + some entities previously pulled via
   "<!ENTITY % includes SYSTEM "includes.sgml"> %includes;" line.
   The location of entity file will be resolved by using catalog file.

 - Add DOCTYPE declearation to XML documents.  This makes the followings
   possible:

   * Use of &foo; entities for SGML in an XML file instead of defining
     {$foo} as the same content.

   * &symbolic; entities for Latin characters.

 - Duplicated information between SGML and XML, or English and
   translated doc, has been removed as much as possible.
2006-08-19 21:20:54 +00:00

149 lines
4.3 KiB
Text

<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/gnome_porting.sgml,v 1.20 2006/05/29 18:12:05 mezz Exp $">
<!ENTITY title "FreeBSD GNOME Project: GNOME Desktop-Independent Components">
<!ENTITY % navinclude.gnome "INCLUDE">
]>
<html>
&header;
<p> To see how to utilize these components, please examine the
<a href="example-Makefile.html">example Makefile</a>.
</p>
<!-- Begin USE_GNOME components list -->
<table class="tblbasic" summary="GNOME desktop-independent components">
<tr>
<th>COMPONENT</th>
<th>ASSOCIATED PROGRAM</th>
<th>IMPLIED COMPONENTS</th>
</tr>
<tr>
<td><tt>esound</tt></td>
<td><tt>audio/esound</tt></td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>gnomehack</tt></td>
<td colspan="2"><tt>gnomehack</tt> makes common GNOME
Makefile substitutions that nearly every GNOME port
requires to fit into the proper mtree structure.
</td>
</tr>
<tr>
<td><tt>gnomehier</tt></td>
<td colspan="2"><tt>gnomehier</tt> installs all the
directories needed for both the GNOME 1 and 2 desktops.
Only include this option if your port calls <tt>@dirrm</tt>
on one of the directories listed in the plist for
<tt>gnomehier</tt>.
</td>
</tr>
<tr>
<td><tt>gnomemimedata</tt></td>
<td><tt>misc/gnome-mime-data</tt></td>
<td><tt>gnomehier pkgconfig</tt></td>
</tr>
<tr>
<td><tt>gnomeprefix</tt></td>
<td><tt>gnomeprefix</tt> sets some CONFIGURE_ARGS
to ensure data is placed properly within the GNOME hierarchy.
</td>
<td><tt>gnomehier</tt></td>
</tr>
<tr>
<td><tt>gnometarget</tt></td>
<td><tt>gnometarget</tt> sets
<tt>${CONFIGURE_TARGET}</tt> for ports whose
<tt>configure</tt> script does not figure it out automatically.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>intlhack</tt></td>
<td><tt>intlhack</tt> registers a dependency upon
<tt>textproc/intltool</tt> and patches broken
<tt>intltool-merge.in</tt> implementations.
</td>
<td><tt>intltool</tt></td>
</tr>
<tr>
<td><tt>intltool</tt></td>
<td><tt>intltool</tt> registers a
BUILD_DEPENDS on
<tt>textproc/intltool</tt>.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>lthack</tt></td>
<td><tt>lthack</tt> prevents the installation of .la
files and ensures that <tt>${PTHREAD_LIBS}</tt>
will be passed to the linker.
<b>NOTE:</b> lthack is <b>DEPRECATED</b>,
and <tt>USE_AUTOTOOLS=libtool:15</tt> should be
used instead. See the <a
href="porting.html#libtool">libtool
section</a> of the porting guide for more
details.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>ltverhack</tt></td>
<td><tt>ltverhack</tt> noralizes shared
object versions so that they do not change
needlessly. Using <tt>ltverhack</tt>
keeps shared object versions in line with
what they should be and what they end up
being on other operating systems. In
order to use <tt>ltverhack</tt> the port
must define
<tt>USE_AUTOTOOLS=libtool:15</tt>.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>pkgconfig</tt></td>
<td><tt>pkgconfig</tt> registers a dependency upon
<tt>devel/pkg-config</tt> to make sure it is installed.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>referencehack</tt></td>
<td><tt>referencehack</tt> is designed for
ports that install API reference
documentation. These ports should use
<tt>referencehack</tt> then another port
with a <tt>-reference</tt> suffix should
be created to install this documentation.
See <tt>devel/glib20</tt> and
<tt>devel/glib20-reference</tt> for an
example.</td>
<td><tt>&nbsp;</tt></td>
</tr>
</table>
<!-- End GNOME-related Makefile macros -->
<p>If you still need help with your port, have a look at some of
the <a href="/ports/gnome.html">existing ports</a> for examples.
The <a href="mailto:&email;@FreeBSD.org">freebsd-gnome mailing
list</a> is also there for you.</p>
&footer;
</body>
</html>