diff --git a/en/gnome/docs/Makefile b/en/gnome/docs/Makefile index aef224d808..84b2c748a5 100644 --- a/en/gnome/docs/Makefile +++ b/en/gnome/docs/Makefile @@ -1,12 +1,13 @@ # $FreeBSD$ .if exists(../Makefile.conf) .include "../Makefile.conf" .endif .if exists(../Makefile.inc) .include "../Makefile.inc" .endif DOCS= faq.sgml +DOCS+= porting.sgml .include "${WEB_PREFIX}/share/mk/web.site.mk" diff --git a/en/gnome/docs/porting.sgml b/en/gnome/docs/porting.sgml new file mode 100644 index 0000000000..314b1cccd8 --- /dev/null +++ b/en/gnome/docs/porting.sgml @@ -0,0 +1,66 @@ + + + + + %includes; +]> + +&header; + + + + + +
+

General instructions can be found in the FreeBSD Porter's Handbook. +

For ports that require GNOME, you should define the following in your +port's Makefile:

+ +
+USE_GNOME=	yes
+USE_X_PREFIX=	yes
+
+ +

These will take care of the install prefix and requiring all the core GNOME +dependencies. If your port can use GNOME, but it isn't required, you can +define the following in your Makefile:

+ +
+WANT_GNOME=	yes
+
+ +

If the user has defined WITH_GNOME in their /etc/make.conf +then GNOME components will be built. Other useful GNOME-related macros +that can be define in your port's Makefile include:

+ +
    +

  • USE_GLIB (WANT_GLIB) : The application requires (can use) Glib. +Defining USE_GNOME or USE_GTK takes care of this option +automatically.

    • +

  • USE_GTK (WANT_GTK) : The application may not be GNOME-compliant, but +requires GTK+ widgets. This will take care of those dependencies. Note, this +option should not be defined if USE_GNOME is defined.

    • +

  • USE_ESOUND (WANT_ESOUND) : The application requires (can use) +Esound. Normally, Esound support is added by specifying USE_GNOME. +

    • +

  • USE_IMLIB (WANT_IMLIB) : The application requires (can use) the +Imlib image library. This is not needed if USE_GNOME is defined. +

    • +

  • USE_GNOMELIBS (WANT_GNOMELIBS) : The application requires (can use) +GNOME libraries. This does not import as many dependencies as +USE_GNOME and should be used for applications that use GNOME, but +do not need the GNOME Control Center, the GNOME capplet library, or +anything from the GNOME Core.

    • +

  • USE_GNOMECTRL (WANT_GNOMECTRL) : The application requires +(can use) all the GNOME libraries and the GNOME Control Center, but does not +use anything from GNOME Core. This option is usually used for backend APIs. +

    • +
+ +

The more ported applications we have, the better. +

+ +&footer; + +