Development/EasyHacks/Translation Of Comments
Easy Hack - Translate Comments from German to English
You find the description of this Easy Hack in the corresponding bug report.
If one directory is finished, please write on this site.
|Directory in libs-core||Who is working on it?||Status|
|avmedia||-||no comments found|
|configmgr||-||no comments found|
|desktop||Albert Thuswaldner||done, see |
|editeng||Albert Thuswaldner||done, see tdf#34196|
|rsc||Lucas Satabin||done, see |
|sfx2||Albert Thuswaldner||done, see tdf#33424|
|sysui||-||No comments found (false positives)|
|udm||-||No comments found (false positives)|
|uui||Albert Thuswaldner||done, see |
|xml2cmp||-||No comments found (false positives)|
|Directories other than libs-core||Who is working on it?||Status|
|sc/source/ui/docshell||Johnny M||done |
|sc/source/ui/xmlsource/||Albert Thuswaldner||no german comments found|
|include/svx/||Johnny M||done |
|svx/source/fmcomp/||Johnny M||done |
|svx/source/inc/||Johnny M||done |
Note: You can use the Gerrit UI to edit the source files. Go to Projects->List->core and click "Create Change". Select the branch "master" and enter a commit message like "Translate German comments". Then click the "Edit" button and add the files you want to translate.
We have a script in
core/bin/ called find-german-comments, that helps you find German comments. Be sure to download the directory
text_cat as well.
Here is an example on how to use it:
~/git/libreoffice/rawbuild/starmath$ ~/git/libreoffice/bin/find-german-comments -v > german-comments.txt processing file 'inc/action.hxx'... processing file 'inc/applicat.hxx'... processing file 'inc/config.hxx'... (...)
german-comments.txt will contain the file names and line numbers where German comments were found. You can run the script in any directory and it'll check the hxx/cxx files under that directory recursively (this can be handy in large modules, as guessing the language of a comment takes some time). If you want only the file names, use the
-f option instead of
Note that it only checks comments that are 4 characters or longer, which might miss some shorter ones. Also, logging and error messages are not detected yet. You can translate them as well.
If you have problems with the script, poke vmiklos.
If you add this to your
.bashrc you can search for German comments anywhere in the codebase using
fgc instead of the path to the tool every time:
If you want to save some time, there is now a text document listing all of the directories containing German comments so that you don't have to parse through the entire core. Because this may be out of date, double check the above table before assigning yourself to a directory to make sure nobody else is working on it or has already completed it. It's a good place to start if you're not sure where to go hunting down the comments.