Add PHP DocBlocks to /footer.php. #477

footer.php

@@ -1,8 +1,11 @@
 <?php
 /**
- * The template for displaying the footer.
+ * The template for displaying the footer
  *
- * Contains the closing of the id=main div and all content after
+ * Contains the closing of the id=main and id=page divs and all content after.
+ *
+ * @package Largo
+ * @since 0.1
  */
 ?>
 	</div> <!-- #main -->
@@ -14,28 +17,53 @@
 		get_template_part( 'partials/footer', 'before-footer-widget-area' );
 	}
 
+    /**
+     * Fires before the Largo footer content.
+     *
+     * @since 0.4
+     */
 	do_action( 'largo_before_footer' );
 ?>
 
 <div class="footer-bg clearfix">
 	<footer id="site-footer">
 
 		<?php
+		    /**
+		     * Fires before the Largo footer widgets appear.
+		     *
+		     * @since 0.4
+		     */
 			do_action( 'largo_before_footer_widgets' );
 
 			get_template_part( 'partials/footer', 'widget-area' );
 
+		    /**
+		     * Fires before the Largo footer boilerplate content.
+		     *
+		     * @since 0.4
+		     */
 			do_action( 'largo_before_footer_boilerplate' );
 
 			get_template_part( 'partials/footer', 'boilerplate' );
 
+		    /**
+		     * Fires just before the Largo footer content ends.
+		     *
+		     * @since 0.4
+		     */
 			do_action( 'largo_before_footer_close' );
 		?>
 
 	</footer>
 </div>
 
 <?php
+	/**
+	 * Fires after the Largo footer content.
+	 *
+	 * @since 0.4
+	 */
 	do_action( 'largo_after_footer' );
 
 	get_template_part( 'partials/footer', 'sticky' );