''This is a [[{{Third-party Plugins|Third-party plugin]]. Currently, it is mostly feature complete but could do with some more extensive testing.addon}}

[[ImageThe "Descendant Books" addon consists of two book type addons:DescendantBook.png* {{man label|thumbDescendant Book}} and * {{man label|rightDetailed Descendant Book}}Both reports are based directly off the [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_6#Descendant_Report|400pxDescendant Report]] and [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_6#Detailed_Descendant_Report|Sample Detailed Descendant Book DialogReport]]'s, the main difference beinginstead of just producing a report based on the Center Person, it allows for the use of a builtin Query or Custom query. This idea is to produce as many descendant reports as is required to satisfy inclusion of all individuals within the given query.

The If for instance "Descendant BooksEntire Database" plugin consists of two book type pluginsis chosen as the query to use. Descendant Book Then the entire database is traversed and Detailed Descendant Book.Both reports are based directly a unique list of Descendant Report ancestors is determined and Detailed Descendant Report, the main difference beinginstead of just producing then a descendant report based of the Center Person, it allows for the use each of a built in Query orCustom query. This idea is to produce as many descendant reports as these ancestors is required to satisfy inclusion of allindividuals within the given queryproduced.

If for instance "Entire Database" As there is chosen as a potential to produce more than one report the query best place to useinclude these reports is under [[Gramps_Glossary#books_report|Books report]]. Then the entire database If more than one report is traversed andproduced a unique list table of ancestors contents is determined and then a descendant report for each of these ancestors is producedgenerated to show how many reports there are.

As there is a potential to produce more than one report the best place to include these reports is underBooks. If more than one only report is produced a , no table of contents is are generated to show how many reports there are.=== Usage ===* ''Descendant Book'' - menu {{man menu|Reports > Text Reports > Descendant Book}}* ''Detailed Descendant Book'' - menu {{man menu|Reports > Text Reports > Detailed Descendant Book}}

'''CAVEAT''': Whilst the report should work against Gramps 3.3. out of the box it hasn't been extensively tested.Most of testing/development is against Gramps trunk (3.4). === Common uses ===

==== Entire Database ====

==== Ancestors of <person> ====

possible ancestors of this person, and then manually generate a descendant report for each of these ancesotrsancestors.

Some of these differences I would hope end up in Trunk/Core, as such there are bug/feature requets requests loggedfor

=== Descendant Report traceback referencing NoneType person ===See bug report http://www.gramps-project.org/bugs/view.php?id=5252 [[ImageFile:DetailedDescendantBook-TextReports-addon-ReportOptions-tab-defaults-50.png|thumb|right|400px450px|Sample Detailed Descendant Book Dialog- Text Reports - Addon - Report Options - tab - defaults]]

=== Detailed Descendant Report - Report Reference Section ===If an individual appears in more than one report, then a new section is printed under that person indicating . It indicates allthe reports in which this person appears . === Index of Names (Detailed Descendant Report) ===The index of Names is the list of all Names that appear in the Detailed Descendant Report printed in alphabetical order. Next to each name there are all references to find the person inthe single reports. The user can decide whether or not print this index. === Index of Dates (Detailed Descendant Report) ===The index of Dates is the list of all events' dates in the Detailed Descendant Report printed in cronological order with the descriptions. The user can decide whether or not print this index. === Index of Places (Detailed Descendant Report) ===The index of Places is the list of all events' dates and description in the Detailed Descendant Report printed in cronological order. The user can decide whether or not print this index. == Installation ==

2) Addition of page numbers to Table of Contents (PDF*Gramps 5.x Version: via the Addon manager*Gramps 4.x Version: via the Addon managerDownload and [[Plugins4.1#Manually_installed_Addons|manually install]]:*Gramps 3.4 Version : http:/ODF only)/mattman.iflaf.com/familytree/gramps/DescendantBooks-1.0.1.tar.gz

3==Issues==* '''Reports don't run very well under gramps 4.x branch''' - Matt Keenan* {{bug|8912}} Gramps crashes when DescendantBooks report runs;Feature request* {{bug|8905}} detailed descendant report - added index of names, dates, places;TODO# Addition of a title page# Addition of page numbers to Table of Contents (PDF/ODF only) # If 2 can be done, then why not have put page numbers listed in Report Referencesreferences as well.