diff --git a/src/wp-includes/theme-compat/embed-404.php b/src/wp-includes/theme-compat/embed-404.php
index 9516727664..ee766750c1 100644
--- a/src/wp-includes/theme-compat/embed-404.php
+++ b/src/wp-includes/theme-compat/embed-404.php
@@ -1,10 +1,9 @@
 <?php
 /**
- * Contains the post embed content template part.
+ * Contains the post embed content template part
  *
- * When a post is embedded in an iframe, this file is used to
- * create the content template part output if the active theme does not include
- * a content-embed.php template.
+ * When a post is embedded in an iframe, this file is used to create the content template part
+ * output if the active theme does not include an embed-404.php template.
  *
  * @package WordPress
  * @subpackage Theme_Compat
diff --git a/src/wp-includes/theme-compat/embed-content.php b/src/wp-includes/theme-compat/embed-content.php
index 63a55280c4..05498eb903 100644
--- a/src/wp-includes/theme-compat/embed-content.php
+++ b/src/wp-includes/theme-compat/embed-content.php
@@ -1,10 +1,9 @@
 <?php
 /**
- * Contains the post embed content template part.
+ * Contains the post embed content template part
  *
- * When a post is embedded in an iframe, this file is used to
- * create the content template part output if the active theme does not include
- * a content-embed.php template.
+ * When a post is embedded in an iframe, this file is used to create the content template part
+ * output if the active theme does not include an embed-content.php template.
  *
  * @package WordPress
  * @subpackage Theme_Compat
diff --git a/src/wp-includes/theme-compat/embed.php b/src/wp-includes/theme-compat/embed.php
index e0ab5ca598..e1194ccbab 100644
--- a/src/wp-includes/theme-compat/embed.php
+++ b/src/wp-includes/theme-compat/embed.php
@@ -1,9 +1,9 @@
 <?php
 /**
- * Contains the post embed template.
+ * Contains the post embed base template
  *
- * When a post is embedded in an iframe, this file is used to
- * create the output.
+ * When a post is embedded in an iframe, this file is used to create the output
+ * if the active theme does not include an embed.php template.
  *
  * @package WordPress
  * @subpackage oEmbed