Index: docs/develfaq.xml =================================================================== --- docs/develfaq.xml (revision 43000) +++ docs/develfaq.xml (working copy) @@ -15,14 +15,14 @@

Contents

    -
  1. What are development versions of GNOME all about?
    2. -
  2. Should I track development versions?
    3. -
  3. How do I obtain development versions of GNOME stuff?
    4. -
  4. How do I keep everything up-to-date and in sync?
    5. -
  5. What should I do when something does not work?
    6. -
  6. How can I help with the development versions?
    7. -
  7. What is the current state of development GNOME on - &os;
    8. +
  8. What are development versions of GNOME all about?
    9. +
  9. Should I track development versions?
    10. +
  10. How do I obtain development versions of GNOME stuff?
    11. +
  11. How do I keep everything up-to-date and in sync?
    12. +
  12. What should I do when something does not work?
    13. +
  13. How can I help with the development versions?
    14. +
  14. What is the current state of development GNOME on + &os;

Full Text

@@ -30,18 +30,18 @@
  1. -

    What are development versions of GNOME all about?

    +

    What are development versions of GNOME all about?

    -

    The development versions are the packages released by the GNOME - project that will eventually become the stable (release) versions. +

    The development versions are the packages released by the GNOME + project that will eventually become the stable (release) versions. There are three working branches of GNOME development:

    -
      -
    1. STABLE - The applications and libraries in the stable +
        +
      1. STABLE - The applications and libraries in the stable branch are considered "release quality," and are the versions that appear in the &os; ports tree. The current stable version is GNOME &gnomever;.
        2. -
      2. DEVELOPMENT - In between stable releases are development - releases. Traditionally, GNOME development releases have odd minor +
      3. DEVELOPMENT - In between stable releases are development + releases. Traditionally, GNOME development releases have odd minor numbers (e.g. 2.3, &gnomedevelver;, 3.(n*2)-1). Development releases will become stable releases, and move from alpha to beta quality during their lifecycle. The development releases need testing by &os; @@ -52,18 +52,18 @@ "development" here if it is the version that is work in progress by the &os; GNOME team. The current development branch for &os; is GNOME &gnomedevelver;.
      4. GIT - Often newer-than-new, the GIT master versions of GNOME - applications and libraries are alpha quality, or often completely - unbuildable. The &os; GNOME project pays attention to, but + applications and libraries are alpha quality, or often completely + unbuildable. The &os; GNOME project pays attention to, but does not track the alpha quality code.
        5. -
      +
  2. -

    Should I track GNOME development versions?

    +

    Should I track GNOME development versions?

    -

    If you are looking for a stable environment, absolutely not. Please - only track the GNOME &gnomedevelver; branch if you wish to help identify bugs +

    If you are looking for a stable environment, absolutely not. Please + only track the GNOME &gnomedevelver; branch if you wish to help identify bug and improve the &os; GNOME project. You will find little sympathy if a development-quality GNOME application eats your homework.

    @@ -71,21 +71,21 @@
  3. -

    How do I obtain the development versions of GNOME stuff?

    +

    How do I obtain the development versions of GNOME stuff?

    -

    Marcus maintains a +

    Marcus maintains a SVN repository where all the development versions of the GNOME components for &os; are housed. Instructions for how to check out the development ports module and how to merge it into the &os; ports tree reside on the entrance page to his SVN repository. Please read carefully the instructions at - http://www.marcuscom.com:8080/viewvc/viewvc.cgi/marcuscom/. -

    + + http://www.marcuscom.com:8080/viewvc/viewvc.cgi/marcuscom/.

    During the development cycle, FreeBSD-specific caveats and other useful information will be sent to - marcuscom-devel@marcuscom.com. If you are tracking + marcuscom-devel@marcuscom.com. If you are tracking the GNOME development branch, you must subscribe to this list. You should also consider

  4. -

    How do I keep everything up-to-date and in sync?

    +

    How do I keep everything up-to-date and in sync?

    -

    The short answer is that you need to use the marcusmerge +

    The short answer is that you need to use the marcusmerge script to merge the development tree with the &os; ports tree. The marcusmerge script is available @@ -128,16 +128,16 @@ #freebsd-gnome IRC channel on FreeNode (irc.freenode.net).

    -

    If all of this sounds scary, or you need a desktop that - "Just Works," you should stick with the &gnomever; version that +

    If all of this sounds scary, or you need a desktop that + "Just Works," you should stick with the &gnomever; version that is available in the &os; ports tree.

  5. -

    What should I do when something does not work?

    +

    What should I do when something does not work?

    -

    It depends. If you think the problem is truly a bug with the +

    It depends. If you think the problem is truly a bug with the GNOME component, you can report a bug using bug-buddy or the GNOME Bugzilla interface. If you think the problem lies in a &os; port, or @@ -146,7 +146,7 @@ or report the problem on the #freebsd-gnome IRC channel on FreeNode.

    -

    Please forward all relevant bug IDs to +

    Please forward all relevant bug IDs to &email;@FreeBSD.org so we can keep track of known issues. Thanks!

    6. @@ -153,7 +153,7 @@
  6. -

    How can I help with the development versions?

    +

    How can I help with the development versions?

    Now that work on &gnomedevelver; has started, we need people to install it, and test things. If you are compiling @@ -164,10 +164,10 @@

  7. -

    What is the current state of development GNOME on &os;?

    +

    What is the current state of development GNOME on &os;?

    -

    &gnomever; is the latest version that was merged into the &os; ports tree. - Work is currently underway to make &gnomedevelver; stable.

    +

    &gnomever; is the latest version that was merged into the &os; ports tree. + Work is currently underway to make &gnomedevelver; stable.