Minor edits and updates.

examples/Embedding/Examples/embed_class_long.py

@@ -3,7 +3,7 b''
 
 Please see the documentation in the IPython.Shell module for more details.
 
-The accompanying file example-embed-short.py has quick code fragments for
+The accompanying file embed_class_short.py has quick code fragments for
 embedding which you can cut and paste in your code once you understand how
 things work.
 
@@ -133,5 +133,3 b' print(\'\\nMain program calling bar("spam")\\n\')'
 bar('spam')
 
 print('Main program finished. Bye!')
-
-#********************** End of file <example-embed.py> ***********************

examples/Embedding/Examples/embed_class_short.py

@@ -1,6 +1,6 b''
 """Quick code snippets for embedding IPython into other programs.
 
-See example-embed.py for full details, this file has the bare minimum code for
+See embed_class_long.py for full details, this file has the bare minimum code for
 cut and paste use once you understand how to use the system."""
 
 #---------------------------------------------------------------------------
@@ -43,5 +43,3 b' else:'
     # Define a dummy ipshell() so the same code doesn't crash inside an
     # interactive IPython
     def ipshell(): pass
-
-#******************* End of file <example-embed-short.py> ********************

examples/Embedding/Examples/embed_function.py

@@ -1,5 +1,4 b''
-# This shows how to use the new top-level embed function.  It is a simpler
-# API that manages the creation of the embedded shell.
+"""Embed IPython using the simple embed function rather than the class API."""
 
 from IPython import embed