Changes between Initial Version and Version 1 of GNOME


Ignore:
Timestamp:
Sep 26, 2006, 1:24:28 AM (15 years ago)
Author:
rhwood@…
Comment:

Import from DarwinPorts Wiki

Legend:

Unmodified
Added
Removed
Modified
  • GNOME

    v1 v1  
     1= GNOME =
     2GNOME is a project, a foundation, a developer's platform (with a related set of language bindings), and a user's desktop environment. New releases of the platform and desktop are released at the same time.
     3== Version Scheme ==
     4The GNOME Foundation uses the version scheme where odd minor versions indicate that a package or product is a development version, such that GNOME 2.15.x is a development version, considered unstable, while 2.14.x is a release version that is considered stable.
     5== Running GNOME ==
     6The GNOME desktop may be run by issuing the command '''gnome-session &''' from an ''xterm'', or by adding the command '''exec gnome-session''' to your ''~/.xinitrc'' file. If you use [http://www.freedesktop.org/Software/dbus dbus] (version >= 0.60), you may prefer to use the command '''exec dbus-launch gnome-session''' in ''~/.xintrc'' to allow GNOME applications to take advantage of the dbus interprocess communications system.
     7=== Environment ===
     8The environment that GNOME runs in requires that the following variables be set. These are shown with the values for a default MacPorts installation:
     9 XDG_DATA_DIRS::
     10 /opt/local/share (if someone knows why, please tell us)
     11 XDG_DATA_HOME::
     12 /opt/local/share (if someone knows why, please tell us)
     13 XDG_CONFIG_DIRS::
     14 /opt/local/etc/xdg (if someone knows why, please tell us)
     15See the sample .xinitrc files for examples of how to set these variables.
     16
     17=== Sample .xinitrc Files ===
     18The following ''~/.xinitrc'' requires Apple's [[X11]] and dbus:
     19
     20 # make sure X11 is MacPorts and /usr/local aware
     21 PATH=$PATH:/opt/local/bin:/opt/local/sbin:/usr/local/bin
     22 export PATH
     23 
     24 # make the freedesktop menu entries work
     25 export XDG_DATA_DIRS=/opt/local/share
     26 export XDG_DATA_HOME=/opt/local/share
     27 export XDG_CONFIG_DIRS=/opt/local/etc/xdg
     28 
     29 # use Apple's window manager
     30 exec quartz-wm &
     31 
     32 # start GNOME
     33 exec dbus-launch gnome-session
     34
     35This ''~/.xinitrc'' works with any [[X11]] and uses GNOME's builtin window manager, ''Metacity'':
     36
     37 # make sure X11 is MacPorts and /usr/local aware
     38 PATH=$PATH:/opt/local/bin:/opt/local/sbin:/usr/local/bin
     39 export PATH
     40 
     41 # make the freedesktop menu entries work
     42 export XDG_DATA_DIRS=/opt/local/share
     43 export XDG_DATA_HOME=/opt/local/share
     44 export XDG_CONFIG_DIRS=/opt/local/etc/xdg
     45 
     46 # use GNOME's window manager
     47 exec metacity &
     48 
     49 # start GNOME
     50 exec gnome-session
     51
     52Note that the second sample ''~/.xinitrc'' also does not require that dbus be installed. Feel free to mix and match the differences between these two sample files to suit your own needs.
     53
     54=== Settings ===
     55GNOME settings are stored in a number of hidden directories in your home directory:
     56 .fonts.cache-1::
     57 .gconf::
     58 .gconfd::
     59 .gnome::
     60 .gnome2::
     61 .gnome2_private::
     62 .gtkrc-1.2-gnome2::
     63 .nautilus::
     64
     65= On MacPorts =
     66The GNOME ports are mostly a mix from the GNOME 2.12.3 and 2.14.1 release versions, although not all packages in the release have been ported as of yet. Based on what happened when GNOME 2.12.0 was released, we aim to provide a workable GNOME release based on x.y.x where y is even and x is greater than 0.
     67
     68A semi-automated [http://homepage.mac.com/rhwood/macports/gnome.html packaging status] report is updated regularly.<br>
     69Status for GNOME version [http://homepage.mac.com/rhwood/gnome/gnome2.12.html 2.12.3 (no longer updated)] and [http://homepage.mac.com/rhwood/macports/gnome.html 2.14.3 (current)]
     70
     71== Assistance ==
     72=== email ===
     73The [http://opendarwin.org/mailman/listinfo/gnome-darwinports gnome-darwinports mailing list] is available for your assistance, and is the best place to resolve issues running the MacPorts distribution of GNOME. Note that since most of the GNOME ports are maintained by ''gnome-darwinports@opendarwin.org'' this mailing list also gets all bug reports for our GNOME ports.
     74
     75== Meta Ports ==
     76
     77A meta port is a port that is simply a collection of dependencies on other ports. There are a number of GNOME-oriented meta ports in MacPorts:
     78
     79 gnome:: This meta port is currently a shorthand for ''gnome-desktop-suite'' with some variants for additional software.
     80 gnome-desktop-suite:: This meta port contains all the software packages that the GNOME Foundation distributes as part of the GNOME desktop. This meta port also includes the ''gnome-platform-suite''.
     81 gnome-platform-suite:: This meta port contains all the libraries and support programs that GNOME software written in the C language may require to run. This corresponds to the GNOME Developer's Platform from the GNOME Foundation.
     82 gnome-bindings-suite:: This meta port is a collection ''gnome-bindings-language'' meta ports that include the libraries required for GNOME programs in C++, Perl, and Python to run. This contains the GNOME Foundation's officially supported languages with the exception of Java.
     83
     84== [http://www.macports.org/docs/ch01s04.html#port Variants] ==
     85The variants '''+with_gnome''' and '''+without_gnome''' affect how ports build in the DarwinPorts system vis-a-vis GNOME, while '''+use-dp-deps''' and '''+use-sys-deps''' affect how ports handle dependencies.
     86 +with_gnome:: adds support for building the port with GNOME hooks. This variant is made a global variant with the installation of the port ''gnome-desktop-suite.'' (A couple of ports use the variant '''+gnome''' instead.)
     87 +without_gnome:: builds the port without GNOME hooks
     88 +use_darwinports_dependencies:: (sometimes +use-dp-deps) force the use of dependencies from DarwinPorts instead of testing to see if the dependency is already satisfied somewhere else on the system. This is the default behavior for most of the GNOME ports.
     89 +use_system_dependencies:: (sometimes +use-sys-deps) use libraries or programs already available on the system to satisfy dependencies instead of the DarwinPorts version. This behavior is optional and discouraged because Apple may change program behavior unexpectedly and because versioning may get out of whack if multiple package maintenance systems are used (DarwinPorts, Fink, hand-built packages, and packages downloaded from elsewhere).
     90
     91== TODOs ==
     92The following TODOs are specific to GNOME packaging on MacPorts. See also the OpenDarwin [http://bugzilla.opendarwin.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=DarwinPorts&component=dports&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&query_based_on=GNOME&field0-0-0=assigned_to&type0-0-0=substring&value0-0-0=gnome&field0-1-0=noop&type0-1-0=noop&value0-1-0= bug reports] assigned to gnome-darwinports.
     93
     94 * Fix excessive dependencies between GNOME ports --[[User:Rhwood|rhwood]] 16:57, 28 January 2006 (GMT)<br>This has been done for the ports in gnome-platform-suite and gnome-bindings-suite --[[User:Rhwood|rhwood]] 10:56, 17 March 2006 (GMT)
     95 * Fix scrollkeeper handling. See [http://bugzilla.opendarwin.org/show_bug.cgi?id=6912 bug report 6912] for DarwinPorts implementation details and see [http://live.gnome.org/GnomeDocUtilsMigration gnome-doc-utils Migration] for GNOME packaging status. --[[User:Rhwood|rhwood]] 10:00, 12 April 2006 (GMT)
     96 * Move the [http://homepage.mac.com/rhwood/gnome/darwinports.html Packaging Status] page from [http://www.mac.com .Mac] to [http://opendarwin.org OpenDarwin] servers. --[[User:Rhwood|rhwood]] 02:10, 25 January 2006 (GMT)
     97 * Clean the dependency structures by making those ports that can depend upon gnome-platform-suite. This may also have the side effect of causing some GTK/GNOME-based applications to gain optional enhancements. --[[User:Rhwood|rhwood]] 02:10, 25 January 2006 (GMT)
     98 * Create a gnome-platform-extras port containing additional libraries that would enhance GTK/GNOME-based applications without requiring the installation of packages from gnome-desktop-suite. --[[User:Rhwood|rhwood]] 02:10, 25 January 2006 (GMT)
     99 * Create a gnome-desktop-extras port containing additional applications that extend the GNOME desktop. --[[User:Rhwood|rhwood]] 02:10, 25 January 2006 (GMT)
     100 * Create a gnome-office-suite port containing the applications in the GNOME Office. --[[User:Rhwood|rhwood]] 02:10, 25 January 2006 (GMT)
     101 * Create a gnome-office-extras port containing additional office-type applications. --[[User:Rhwood|rhwood]] 02:10, 25 January 2006 (GMT)
     102 * Create a gnome-devel-suite port containing GNOME development tools. --[[User:Rhwood|rhwood]] 02:10, 25 January 2006 (GMT)
     103
     104= Specific Ports =
     105== gdm ==
     106gdm uses PAM (Pluggable Authentication Modules) to authenticate users. PAM is a core part of the Mac OS X security system, and as such there is a manual process that needs to be completed before gdm can be used:
     107
     108In Terminal:
     109# cd /etc/pam.d
     110# sudo cp login gdm
     111
     112This creates a file that allows logging into gdm to behave basically identical to logging into Mac OS X using the standard means. Tweaking the settings of /etc/pam.d/gdm will change the authentication possibilities for gdm.
     113
     114= Additional Resources =
     115 * [http://fink.sourceforge.net/lists/fink-gnome-core.php Fink-gnome-core], the Fink project's GNOME mailing list.
     116
     117[[Category:DarwinPorts]]
     118[[Category:Gnome]]