Difference between revisions of "Getting started with Gramps Trunk"

From Gramps
Jump to: navigation, search
m (Can I help with GRAMPS trunk?: point to User manual)
m (Running parallel versions of trunk and branches: outdated statement)
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
GRAMPS trunk is the newest version of GRAMPS, but it is under development. You can help by trying this version and reporting feedback and bugs. Before embarking on this you should first read this page.
+
Gramps trunk is the newest version of Gramps, but it is under development. You can help by trying this version and reporting feedback and bugs. Before embarking on this you should first read this page.
  
 
{{man warn|Warning:|A word of caution: trunk is currently considered a ''development version'' and not for use on your real data. You can test trunk on a copy of your data though. See below for more details.}}
 
{{man warn|Warning:|A word of caution: trunk is currently considered a ''development version'' and not for use on your real data. You can test trunk on a copy of your data though. See below for more details.}}
  
You should not ''install'' GRAMPS trunk as that will overwrite your regular GRAMPS. However, you can download and compile trunk locally, largely without interfering with your regular GRAMPS. Subtle interactions are easy to resolve for developers.  
+
You should not ''install'' Gramps trunk as that will overwrite your regular Gramps. However, you can download and compile trunk locally, largely without interfering with your regular Gramps. Subtle interactions are easy to resolve for developers.  
  
 
== Precautions ==
 
== Precautions ==
  
GRAMPS trunk should only be used on a copy of your Family Tree data! Here is a step-by-step guide to doing this:
+
Gramps trunk should only be used on a copy of your Family Tree data! Here is a step-by-step guide to doing this:
  
# Start your old version of GRAMPS
+
# Start your old version of Gramps
# Export your data using the GRAMPS Package
+
# Export your data using the Gramps Package
# Quit your old version of GRAMPS
+
# Quit your old version of Gramps
# Start GRAMPS trunk
+
# Start Gramps trunk
 
# Create a new Family Tree
 
# Create a new Family Tree
# Import the GRAMPS package from step 2
+
# Import the Gramps package from step 2
  
== Can I run my older version of GRAMPS with this new version? ==
+
== Can I run my older version of Gramps with this new version? ==
  
 
Yes. See installation notes below.
 
Yes. See installation notes below.
Line 22: Line 22:
 
== I have a suggestion or have found a bug. What do I do? ==
 
== I have a suggestion or have found a bug. What do I do? ==
  
Please make a note of your Feature Request, or your bug here: http://bugs.gramps-project.org/ This is one of the most important things you can do to help the state of GRAMPS.
+
Please make a note of your Feature Request, or your bug here: http://bugs.gramps-project.org/ This is one of the most important things you can do to help the state of Gramps.
  
== Can I help with GRAMPS trunk? ==
+
== Can I help with Gramps trunk? ==
  
 
Yes! You could:
 
Yes! You could:
  
# Help write documentation on how to use GRAMPS trunk. See [[User manual|Gramps X.x User Wiki Manual]]
+
# Help write documentation on how to use Gramps trunk. See [[User manual|Gramps X.x User Wiki Manual]]
# Help translate GRAMPS into another language. See [[Portal:Translators|Internationalization]]
+
# Help translate Gramps into another language. See [[Portal:Translators|Internationalization]]
 
# Test and follow-up on issues in the tracker. See http://bugs.gramps-project.org/
 
# Test and follow-up on issues in the tracker. See http://bugs.gramps-project.org/
# Donate money to GRAMPS. See [[GRAMPS:Site_support|GRAMPS Support]]
+
# Donate money to Gramps. See [[GRAMPS:Site_support|Gramps Support]]
  
== Installing GRAMPS Trunk ==
+
== Installing Gramps Trunk ==
  
Now that you have read all of the precautions, you are ready to begin exploring GRAMPS trunk.  
+
Now that you have read all of the precautions, you are ready to begin exploring Gramps trunk.  
  
 
* '''Windows systems''': follow the directions at ?.
 
* '''Windows systems''': follow the directions at ?.
Line 42: Line 42:
 
The easiest method of getting the beta/trunk version is to download it from http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/ using the link at the bottom of the page called '''[http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/?view=tar Download GNU tarball]'''. This is easy to download, it is the freshest code, and you will have to do a little more work.  
 
The easiest method of getting the beta/trunk version is to download it from http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/ using the link at the bottom of the page called '''[http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/?view=tar Download GNU tarball]'''. This is easy to download, it is the freshest code, and you will have to do a little more work.  
  
See [[Getting_started_with_GRAMPS_development#Run_GRAMPS_from_the_source|running Gramps from source]] for details to make the code work.
+
See [[Getting_started_with_Gramps_development#Run_Gramps_from_the_source|running Gramps from source]] for details to make the code work.
  
 
== Running parallel versions of trunk and branches ==
 
== Running parallel versions of trunk and branches ==
  
As stated in '''Installing GRAMPS trunk''', you can only have a dedicated gramps.mo file on /usr/share/local/xx/.. . If you want to have both the trunk and branches version with separate translations, consider using some '''[http://en.wikipedia.org/wiki/Comparison_of_platform_virtual_machines Virtual Machines]'''.
+
As stated in '''Installing Gramps trunk''', you can only have a dedicated gramps.mo file on /usr/share/local/xx/.. . If you want to have both the trunk and branches version with separate translations, consider using some '''[http://en.wikipedia.org/wiki/Comparison_of_platform_virtual_machines Virtual Machines]'''.
 
+
At the moment I experiment with this setup:
+
* Ubuntu 7.10: running VirtualBox
+
** VM1: Linux Mint : on this machine I build and installed trunk. This means running ./autogen script, make AND do a make install (as root)
+
** VM2: Fedora 8 : on this machine I build and installed branches. This means running ./autogen script, make AND do a make install (as root)
+
  
 
== See also ==
 
== See also ==

Revision as of 15:17, 24 January 2013

Gramps trunk is the newest version of Gramps, but it is under development. You can help by trying this version and reporting feedback and bugs. Before embarking on this you should first read this page.

Gnome-important.png
Warning:

A word of caution: trunk is currently considered a development version and not for use on your real data. You can test trunk on a copy of your data though. See below for more details.

You should not install Gramps trunk as that will overwrite your regular Gramps. However, you can download and compile trunk locally, largely without interfering with your regular Gramps. Subtle interactions are easy to resolve for developers.

Precautions

Gramps trunk should only be used on a copy of your Family Tree data! Here is a step-by-step guide to doing this:

  1. Start your old version of Gramps
  2. Export your data using the Gramps Package
  3. Quit your old version of Gramps
  4. Start Gramps trunk
  5. Create a new Family Tree
  6. Import the Gramps package from step 2

Can I run my older version of Gramps with this new version?

Yes. See installation notes below.

I have a suggestion or have found a bug. What do I do?

Please make a note of your Feature Request, or your bug here: http://bugs.gramps-project.org/ This is one of the most important things you can do to help the state of Gramps.

Can I help with Gramps trunk?

Yes! You could:

  1. Help write documentation on how to use Gramps trunk. See Gramps X.x User Wiki Manual
  2. Help translate Gramps into another language. See Internationalization
  3. Test and follow-up on issues in the tracker. See http://bugs.gramps-project.org/
  4. Donate money to Gramps. See Gramps Support

Installing Gramps Trunk

Now that you have read all of the precautions, you are ready to begin exploring Gramps trunk.

  • Windows systems: follow the directions at ?.
  • Unix-like systems: follow the rest of this page.

The easiest method of getting the beta/trunk version is to download it from http://gramps.svn.sourceforge.net/viewvc/gramps/trunk/ using the link at the bottom of the page called Download GNU tarball. This is easy to download, it is the freshest code, and you will have to do a little more work.

See running Gramps from source for details to make the code work.

Running parallel versions of trunk and branches

As stated in Installing Gramps trunk, you can only have a dedicated gramps.mo file on /usr/share/local/xx/.. . If you want to have both the trunk and branches version with separate translations, consider using some Virtual Machines.

See also