From dddcb10dd3f0b2bad639e9b9339528783950b95d Mon Sep 17 00:00:00 2001 From: Benny Malengier Date: Fri, 3 Jul 2009 09:23:07 +0000 Subject: [PATCH] docstring update svn: r12758 --- src/gen/lib/attribute.py | 11 ++++++++++- src/gen/lib/event.py | 6 ++++++ 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/src/gen/lib/attribute.py b/src/gen/lib/attribute.py index fa51855d5..31371725a 100644 --- a/src/gen/lib/attribute.py +++ b/src/gen/lib/attribute.py @@ -43,8 +43,17 @@ from gen.lib.attrtype import AttributeType class Attribute(SecondaryObject, PrivacyBase, SourceBase, NoteBase): """ Provide a simple key/value pair for describing properties. + Used to store descriptive information. - Used by the Person and Family objects to store descriptive information. + In GEDCOM only used for Persons: + Individual attributes should describe situations that may be permanent or + temporary (start at some date, end at some date, etc.), may be associated + to a place (a position held, residence, etc.) or may not (eye colour, + height, caste, profession, etc.). They may have sources and notes and + media. + Compare with :class:`~gen.lib.event.Event` + + GRAMPS at the moment does not support this GEDCOM Attribute structure. """ def __init__(self, source=None): diff --git a/src/gen/lib/event.py b/src/gen/lib/event.py index 9dd59b1e0..97dba300d 100644 --- a/src/gen/lib/event.py +++ b/src/gen/lib/event.py @@ -50,6 +50,12 @@ class Event(SourceBase, NoteBase, MediaBase, AttributeBase, The Event record is used to store information about some type of action that occurred at a particular place at a particular time, such as a birth, death, or marriage. + + A possible definition: Events are things that happen at some point in time + (that we may not know precisely, though), at some place, may involve + several people (witnesses, officers, notaries, priests, etc.) and may + of course have sources, notes, media, etc. + Compare this with attribute: :class:`~gen.lib.attribute.Attribute` """ def __init__(self, source=None):