automate doc and while allow to extend it on event

srml/assets/src/lib.rs

@@ -83,7 +83,6 @@ decl_module! {
 }
 
 decl_event!(
-	/// An event in this module.
 	pub enum Event<T> where <T as system::Trait>::AccountId, <T as Trait>::Balance {
 		/// Some assets were issued.
 		Issued(AssetId, AccountId, Balance),

srml/council/src/motions.rs

@@ -48,7 +48,6 @@ pub enum Origin {
 }
 
 decl_event!(
-	/// Event for this module.
 	pub enum Event<T> where <T as system::Trait>::Hash, <T as system::Trait>::AccountId {
 		/// A motion (given hash) has been proposed (by given account) with a threshold (given u32).
 		Proposed(AccountId, ProposalIndex, Hash, u32),

srml/council/src/voting.rs

@@ -126,7 +126,6 @@ decl_storage! {
 }
 
 decl_event!(
-	/// An event in this module.
 	pub enum Event<T> where <T as system::Trait>::Hash {
 		/// A voting tally has happened for a referendum cancellation vote.
 		/// Last three are yes, no, abstain counts.

srml/example/src/lib.rs

@@ -73,7 +73,7 @@ decl_storage! {
 }
 
 decl_event!(
-	/// An event in this module. Events are simple means of reporting specific conditions and
+	/// Events are simple means of reporting specific conditions and
 	/// circumstances that have happened that users, Dapps and/or chain explorers would find
 	/// interesting and otherwise difficult to detect.
 	pub enum Event<T> where B = <T as balances::Trait>::Balance {

srml/grandpa/src/lib.rs

@@ -177,7 +177,6 @@ impl<N: Decode, SessionKey: Decode> Decode for StoredPendingChange<N, SessionKey
 }
 
 decl_event!(
-	/// GRANDPA events.
 	pub enum Event<T> where <T as Trait>::SessionKey {
 		/// New authority set has been applied.
 		NewAuthorities(Vec<(SessionKey, u64)>),

srml/session/src/lib.rs

@@ -85,7 +85,6 @@ decl_module! {
 }
 
 decl_event!(
-	/// An event in this module.
 	pub enum Event<T> where <T as system::Trait>::BlockNumber {
 		/// New session has happened. Note that the argument is the session index, not the block
 		/// number as the type might suggest.

srml/staking/src/lib.rs

@@ -489,7 +489,6 @@ decl_module! {
 }
 
 decl_event!(
-	/// An event in this module.
 	pub enum Event<T> where Balance = BalanceOf<T>, <T as system::Trait>::AccountId {
 		/// All validators have been rewarded by the given balance.
 		Reward(Balance),

srml/sudo/src/lib.rs

@@ -59,7 +59,6 @@ decl_module! {
 }
 
 decl_event!(
-	/// An event in this module.
 	pub enum Event<T> where AccountId = <T as system::Trait>::AccountId {
 		/// A sudo just took place.
 		Sudid(bool),

srml/support/src/event.rs

@@ -144,6 +144,8 @@ macro_rules! decl_event {
 		// Workaround for https://github.com/rust-lang/rust/issues/26925 . Remove when sorted.
 		#[derive(Clone, PartialEq, Eq, $crate::codec::Encode, $crate::codec::Decode)]
 		#[cfg_attr(feature = "std", derive(Debug))]
+		/// Events for this module.
+		///
 		$(#[$attr])*
 		pub enum Event {
 			$(
@@ -277,9 +279,12 @@ macro_rules! __decl_generic_event {
 		/// [`RawEvent`]: enum.RawEvent.html
 		/// [`Trait`]: trait.Trait.html
 		pub type Event<$event_generic_param $(, $instance $( = $event_default_instance)? )?> = RawEvent<$( $generic_type ),* $(, $instance)? >;
+
 		// Workaround for https://github.com/rust-lang/rust/issues/26925 . Remove when sorted.
 		#[derive(Clone, PartialEq, Eq, $crate::codec::Encode, $crate::codec::Decode)]
 		#[cfg_attr(feature = "std", derive(Debug))]
+		/// Events for this module.
+		///
 		$(#[$attr])*
 		pub enum RawEvent<$( $generic_param ),* $(, $instance)? > {
 			$(

srml/system/src/lib.rs

@@ -125,7 +125,6 @@ pub struct EventRecord<E: Parameter + Member> {
 }
 
 decl_event!(
-	/// Event for the system module.
 	pub enum Event {
 		/// An extrinsic completed successfully.
 		ExtrinsicSuccess,

srml/treasury/src/lib.rs

@@ -170,7 +170,6 @@ decl_storage! {
 }
 
 decl_event!(
-	/// An event in this module.
 	pub enum Event<T>
 	where
 		Balance = BalanceOf<T>,