Removed weird examples and added syntax cues

screeps-game-api/src/objects/macros.rs

@@ -88,21 +88,23 @@ macro_rules! impl_room_object_properties {
 }
 
 
-// Macro for mass implementing `StructureProperties`, `PartialEq` and `Eq` for a type. 
-// 
-// This macro accepts a comma-separated list of types on which to implement the unsafe `StructureProperties` trait on
-// a screeps object. 
-// From that implementation, the type gets the `id` method which is used to implement `PartialEq` and `Eq`.
-// 
-// # Example
-// ```
-// macro_rules!(OwnedStructure, Structure, StructureContainer)
-// ```
-// 
-// # Safety
-// The macro assumes that it is implementing the trait to a valid `Reference` 
-// (See `reference_wrapper` macro) which will support all `StructureProperties` methods.
-// 
+/// Macro for mass implementing `StructureProperties`, `PartialEq` and `Eq` for a type. 
+/// 
+/// Macro syntax:
+/// impl_structure_properties!{
+///     $struct1,
+///     $struct2,
+///     ...
+/// }
+/// 
+/// This macro accepts a comma-separated list of types on which to implement the unsafe `StructureProperties` trait on
+/// a screeps object. 
+/// From that implementation, the type gets the `id` method which is used to implement `PartialEq` and `Eq`.
+/// 
+/// # Safety
+/// The macro assumes that it is implementing the trait to a valid `Reference` 
+/// (See `reference_wrapper` macro) which will support all `StructureProperties` methods.
+/// 
 macro_rules! impl_structure_properties {
     ( $( $struct_name:ty ),+ ) => {$(
         unsafe impl StructureProperties for $struct_name {}