]> git.deb.at Git - rhonda/impostor.git/commitdiff
Make API remarks show up in the documentation
authorminiduikboot <mini@duikbo.at>
Fri, 10 Nov 2023 14:40:06 +0000 (15:40 +0100)
committerminiduikboot <mini@duikbo.at>
Fri, 10 Nov 2023 14:41:48 +0000 (15:41 +0100)
Some xmldoc processors don't process stuff that is not inside a remarks
tag, so we add them here.

src/Impostor.Api/Events/Game/Player/IPlayerCheckMurderEvent.cs
src/Impostor.Api/Events/Game/Player/IPlayerMurderEvent.cs
src/Impostor.Api/Games/IGame.cs

index 878d5a54898a2bbca2a38ba2b7ab62769492bfbe..a1192ac73af29a1609bf9400523249a7dc13fc2b 100644 (file)
@@ -4,24 +4,28 @@ using Impostor.Api.Net.Inner.Objects;
 namespace Impostor.Api.Events.Player
 {
     /// <summary>
-    ///     Event that allows changing or canceling an upcoming player murder.
+    /// Event that allows changing or canceling an upcoming player murder.
     /// </summary>
+    /// <remarks>
     /// Note that this event only triggers if the Host of the Game did not disable server authority.
     ///
     /// If you want to get an event after the murder took place, listen to <see cref="IPlayerMurderEvent"/>.
+    /// </remarks>
     public interface IPlayerCheckMurderEvent : IPlayerEvent, IEventCancelable
     {
         /// <summary>
-        ///     Gets the player who got murdered.
+        /// Gets the player who will be murdered.
         /// </summary>
         IInnerPlayerControl Victim { get; }
 
         /// <summary>
-        ///     Gets or sets the result of this event.
+        /// Gets or sets the result of this event.
         /// </summary>
+        /// <remarks>
         /// Its initial value is what would have happened in the normal game flow.
         /// - If set to Succeeded, the Victim will die.
         /// - If set to FailedProtected, the Victim will be protected with a shield animation and the attacker will have a cooldown set.
+        /// </remarks>
         MurderResultFlags Result { get; set; }
     }
 }
index b90ea3eeb6d728c965a2e2a42c385c7098b4569b..7c49e7b411e3b491d477edc61abdfe133b20b54c 100644 (file)
@@ -4,12 +4,14 @@ using Impostor.Api.Net.Inner.Objects;
 namespace Impostor.Api.Events.Player
 {
     /// <summary>
-    ///     Event that is called when a player is killed by another player.
+    /// Event that is called when a player is killed by another player.
     /// </summary>
+    /// <remarks>
     /// This event works regardless of server authority is enabled or not.
     ///
     /// If you want to cancel this kill, listen to <see cref="IPlayerCheckMurderEvent"/>
     /// If you want to know about players that were voted out, listed to <see cref="IPlayerExileEvent"/>
+    /// </remarks>
     public interface IPlayerMurderEvent : IPlayerEvent
     {
         /// <summary>
@@ -20,7 +22,9 @@ namespace Impostor.Api.Events.Player
         /// <summary>
         ///     Gets the result of the event.
         /// </summary>
+        /// <remarks>
         /// Note that if FailedError or FailedProtected is set, the kill did not take place
+        /// </remarks>
         MurderResultFlags Result { get; }
     }
 }
index 8f5d29b63349aa09d16245a5e864367433616119..05d6015bba168d2219077a2a626229a379b3af53 100644 (file)
@@ -40,9 +40,11 @@ namespace Impostor.Api.Games
         int HostId { get; }
 
         /// <summary>
-        ///     Gets a value indicating whether the Host of the game has requested host authority.
+        /// Gets a value indicating whether the Host of the game has requested host authority.
         /// </summary>
+        /// <remarks>
         /// Vanilla Among Us does not request this, but certain client-side mods will.
+        /// </remarks>
         bool IsHostAuthoritive { get; }
 
         IClientPlayer? GetClientPlayer(int clientId);