From 5fbc8e174f15af56336651d8c4cea93a48d4ebd9 Mon Sep 17 00:00:00 2001 From: "Karl O. Pinc kop@karlpinc.com" Date: Sat, 16 May 2026 12:10:40 +0000 Subject: [PATCH] Improve AGGRESSIONS docs Based on Ian's review of 2026-05-15 --- doc/src/tables/aggressions.m4 | 8 ++++---- doc/src/tables/events.m4 | 4 +++- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/doc/src/tables/aggressions.m4 b/doc/src/tables/aggressions.m4 index 76c106c..e337214 100644 --- a/doc/src/tables/aggressions.m4 +++ b/doc/src/tables/aggressions.m4 @@ -53,7 +53,7 @@ The related |EVENTS| row must be an aggression event; it must have an |EVENTS|.\ |EVENTS.Behavior| value of ``sdb_aggression``. This related |EVENTS| row supplies the time of the aggression and relates to the follow, and the |ROLES| role related to the event -supplies information on the individual arriving and departing. +supplies information on the individuals involved in the aggression. The system will generate a warning if a participant in the aggression is not present at the time of the aggression. @@ -75,7 +75,7 @@ table. .. sidebar:: The |AGGRESSIONS.AggressorBehavior| and - |AGGRESSIONS.RecipientBehavior| columns are extracted from the + |AGGRESSIONS.RecipientBehavior| columns are summaries of the |AGGRESSIONS.FullAccount| column, which is itself sometimes extracted from other sources. Care must be taken to ensure consistently between these columns and @@ -160,8 +160,8 @@ MultiRecipients .. _AGGRESSIONS.BadObs: -BadObs (BAD OBserversion) -````````````````````````` +BadObs (BAD OBservation) +```````````````````````` .. |AGGRESSIONS.BadObs_summary| replace:: A |boolean|, whether or not the record of the observation was complete. diff --git a/doc/src/tables/events.m4 b/doc/src/tables/events.m4 index 327750c..781c0dc 100644 --- a/doc/src/tables/events.m4 +++ b/doc/src/tables/events.m4 @@ -85,7 +85,9 @@ The following table lists these rules and implications: equal the value of the |EVENTS|.\ |EVENTS.Stop| column. For aggression events, the |EVENTS|.\ |EVENTS.Certainty| column - records the certainty of the identity of the recipient. + records the certainty of the identity of the recipient, that is to + say, the certainty of the individual with the role of + ``sdb_actee``. .. _EVENTS_arrival_code: -- 2.34.1