[cmake-developers] [CMake 0016034]: Completely wrong FindGettext documentation

[Mantis Bug Tracker]

The following issue has been SUBMITTED. 
====================================================================== 
https://cmake.org/Bug/view.php?id=16034 
====================================================================== 
Reported By:                Tatsuyuki Ishi
Assigned To:                
====================================================================== 
Project:                    CMake
Issue ID:                   16034
Category:                   CMake
Reproducibility:            always
Severity:                   major
Priority:                   high
Status:                     new
====================================================================== 
Date Submitted:             2016-03-25 00:42 EDT
Last Modified:              2016-03-25 00:42 EDT
====================================================================== 
Summary:                    Completely wrong FindGettext documentation
Description: 
I found out that FindGettext module's document is not only confusing but
completely wrong.

The documentation says:
# GETTEXT_CREATE_TRANSLATIONS ( outputFile [ALL] file1 ...  fileN )
#
# ::
#
#     This will create a target "translations" which will convert the
#     given input po files into the binary output mo file. If the
#     ALL option is used, the translations will also be created when
#     building the default target.

What it does:
Process given po files, one by one, expected usage is one po per language.
The outputFile parameter is actually for the gettext package name, internal
codes expects package.pot passed.
And also it implicitly creates install target, without any description.

Other functions' documentation are also confusing, I hope you rewrite these.
====================================================================== 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2016-03-25 00:42 Tatsuyuki Ishi New Issue                                    
======================================================================