Apply suggestions from code review

Co-authored-by: Stan Ulbrych <[email protected]>

Author: s-ball

Misc/NEWS.d/next/Tools-Demos/2018-12-05-20-46-10.bpo-35335.qtIUBx.rst

@@ -1,3 +1,3 @@
-The script ``Tools/i18n/msgfmt.py`` is now able to  merge more than one single po file into a compiled mo
+:program:`msgfmt.py` is now able to  merge more than one single po file into a compiled mo
 file. When an entry exists in more than on input file, the last file wins.
 It is also possible to directly call ``make`` more than once

Tools/i18n/msgfmt.py

@@ -1,6 +1,5 @@
 #! /usr/bin/env python3
 # Written by Martin v. Löwis <[email protected]>
-# Modified by s-ball <[email protected]>
 
 """Generate binary message catalog from textual translation description.
 
@@ -106,11 +105,11 @@ def generate(messages):
 
 
 def make(filenames, outfile):
-    """This function is now member of the public interface.
+    """
     filenames is a string or an iterable of strings representing input file(s)
     outfile is a string for the name of an input file or None.
 
-    If it is not None, the output file receives a merge of the input files
+    If it is not None, the output file receives a merge of the input files.
     If it is None, then filenames must be a string and the name of the output
     file is obtained by replacing the po extension with mo.
     Both ways are for compatibility reasons with previous behaviour.