Vassilii Khachaturov 68c0615bc4 7197: merge the fix from master
All date tests pass cleanly on gramps40 branch.
Merged the following commits.

	commit a90139cb9acb1c376026cff5ddbbb3d1468b6004
	Author: Vassilii Khachaturov <vassilii@tarunz.org>
	Date:   Fri Nov 15 15:04:03 2013 +0200

		7197, 7100: missing recalc_sort_value in ny code

		Fix bug #7197

	commit baae6ac615997d42eaf813e1b463674e5f197556
	Author: Vassilii Khachaturov <vassilii@tarunz.org>
	Date:   Thu Nov 14 22:45:42 2013 +0200

		7197: readjust sanity date wrt newyear/slash

		Attempt to fix the failing
		 DateHandlerTest.test_invalid_month_with_ny
		(see 7197:32625). Tests still fail, investigation shows
		there's a problem in Date.set setting Julian+Mar25 date even if the
		date validation check is disabled by inserting a return before
		the validation block, i.e., before this line
				if modifier != Date.MOD_TEXTONLY:
		which seems to be the root cause of the remaining failing tests.
		which seems to be the root cause of the remaining failing tests.

		To investigate, add the return and try
		LC_ALL=en_GB.utf8 LANG=en_GB.utf8 GRAMPS_RESOURCES=$PWD \
		 python -m unittest -v \
		 gramps.gen.lib.test.date_test.MatchDateTest.test_match

	commit 41477211129e5a2fee7256838ade13efd2c226d0
	Author: Vassilii Khachaturov <vassilii@tarunz.org>
	Date:   Wed Nov 13 22:34:24 2013 +0200

		7197: refactor code

		extract Date._adjust_newyear out of Date.set

	commit b3ab87bc5a0188b05c3e725d123f8db2ba5a1a33
	Author: Vassilii Khachaturov <vassilii@tarunz.org>
	Date:   Wed Nov 13 22:02:21 2013 +0200

		7197: refactor code

		replace all copies of logging with a single point at the exception
		rethrow point

	commit c4daa151a5875a07ff739e3d75efe81c7aa5bc5d
	Author: Vassilii Khachaturov <vassilii@tarunz.org>
	Date:   Wed Nov 13 17:39:47 2013 +0200

		7197: date sanity check breaks on Julian+Mar25

		Date.convert_calendar resets the new year setting to 0,
		so the sanity check fails. Commit the initial fix that
		unblocks the failing test.
2013-11-15 15:51:56 +02:00
2013-10-20 16:47:38 +00:00
2013-11-15 15:51:56 +02:00
2013-11-15 15:35:58 +02:00
2013-08-06 22:25:52 +00:00
FAQ
2013-03-11 22:54:20 +00:00
2013-04-06 09:40:49 +00:00
2013-11-08 09:25:13 -08:00
2013-04-06 16:56:57 +00:00
2013-05-21 09:15:43 +00:00
2013-10-07 08:21:57 +00:00

$Id$

Please read the COPYING file first.

If building from source, also read the INSTALL file (at least through the
"SUPER-SHORT VERSION") before going further.

Requirements
--------------------------------
The following packages *MUST* be installed in order for Gramps to work:
   Python 2.7 or greater, Python 3.2 or greater (or both python versions)
   GTK 3.0 or greater
   pygobject 3.3.2 or greater
   cairo, pango, pangocairo with introspection bindings (the gi packages)
   librsvg2 (svg icon view)
   xdg-utils
   bsddb3 is required for Python 3.2 (not python 2.7)

The following package is needed for full translation of the interface
to your language:
   language-pack-gnome-xx 
                    Translation of GTK elements to your language, with
                    xx your language code; e.g. for Dutch you need
                    language-pack-gnome-nl. The translation of the
                    Gramps strings is included with the gramps source.


The following packages are *STRONGLY RECOMMENDED* to be installed:

   osmgpsmap        Used to show maps in the geography view. 
                    It may be osmgpsmap, osm-gps-map, or python-osmgpsmap,
                    but the Python bindings for this must also be present.
                    Without this the GeoView will not be active, see
                    http://gramps-project.org/wiki/index.php?title=Gramps_4.0_Wiki_Manual_-_Main_Window#Geography_Category
                    !! PACKAGERS: unfortunately, at the moment (March 2013),
                    the patches which gramps 4.0 needs osm-gps-map to have
                    are not yet released (as a new osm-gps-map version). The
                    osm-gps-map sources must be dated 6 February 2013 (or
                    later) to have the necessary patches.  You may obtain
                    it from: http://nzjrs.github.com/osm-gps-map/ or else
                    http://sourceforge.net/projects/gramps/files/Dependencies
                    (The necessary version seems to be 0.8 -- or later.)

   GraphViz         Enable creation of graphs using GraphViz engine.
                    Without this, three reports cannot be run.
                    Obtain it from: http://www.graphviz.org

   PyICU            Improves localised sorting in Gramps. In particular, this
                    applies to sorting in the various views and in the
                    Narrative Web output. It is particularly helpful for
                    non-Latin characters, for non-English locales and on MS
                    Windows and Mac OS X platforms. If it is not available,
                    sorting is done through built-in libraries. PyICU is
                    fairly widely available through the package managers of
                    distributions. See http://pyicu.osafoundation.org/
                    (These are Python bindings for the ICU package.)

The following packages are optional

   gtkspell         Enable spell checking in the notes. Gtkspell depends on 
                    enchant. A version of gtkspell with gobject introspection
                    is needed, so minimally version 3.0.0

   rcs              The GNU Revision Control System (RCS) can be used to manage
                    multiple revisions of your family trees. See info at
                    http://www.gramps-project.org/wiki/index.php?title=Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#Archiving_a_Family_Tree
                    Only rcs is needed, NO python bindings are required

   PIL              Python Image Library is needed to crop
                    images and also to convert non-JPG images to
                    JPG so as to include them in LaTeX output.
                    (For Python3 a different source may be needed.)

   GExiv2           Enables Gramps to manage Exif metadata embedded in your
                    media. Gramps needs version 0.5 or greater.
                    See http://www.gramps-project.org/wiki/index.php?title=GEPS_029:_GTK3-GObject_introspection_Conversion#GExiv2_for_Image_metadata

   ttf-freefont     More font support in the reports

   gir-webkit       GObject introspection data of WebKit is required for the
                    hidden view 'Htmlview', which allows websites to be
                    opened in Gramps. Users can unhide the view in the
                    plugin manager.  A html renderer must be installed to
                    use the view.
                    !! PACKAGERS, Test if on your distribution
                    webkit and Gramps is stable. If you obtain crashes, patch 
                    src/plugins/view/htmlrenderer.py and
                    src/plugins/view/geoview.gpr.py, so as to remove:
                       from gi.repository import WebKit as webkit

   goocanvas2:
                    Required for the (user-downloadable) Graphview plugin

No longer needed in 4.0:
   pygoocanvas, pygtk, pyexiv2
No longer needed in 3.3:
   python-enchant Enchant
No longer needed in 3.2:
   python glade bindings
No longer needed in 3.1:
   yelp             Gnome help browser. At the moment no help is shipped


Documentation
---------------------------------
The User Manual is now maintained on the gramps website,
http://www.gramps-project.org/wiki/index.php?title=User_manual

--------------------------------
The Gramps Project
http://gramps-project.org
Description
Source code for Gramps Genealogical program
Readme 527 MiB
Languages
Python 96.1%
CSS 2.6%
Roff 0.7%
HTML 0.3%
Genero Forms 0.1%
Other 0.2%