https://bugs.documentfoundation.org/show_bug.cgi?id=164954

            Bug ID: 164954
           Summary: Translate German variable and constant names
           Product: LibreOffice
           Version: Inherited From OOo
          Hardware: All
                OS: All
            Status: UNCONFIRMED
          Severity: normal
          Priority: medium
         Component: LibreOffice
          Assignee: [email protected]
          Reporter: [email protected]

Background:
In the past, LibreOffice source code had many comments written in German, and
to help developers around the world who do not know German to understand the
code, those comments were translated to English, in tdf#39468:

Bug 39468 - translate German comments, removing redundant ones
https://bugs.documentfoundation.org/show_bug.cgi?id=39468

Description:
The task here is to find and translate variables and constant with German names
to English. This renaming is a kind of refactoring, and should be done in a way
that does not affect the code behavior. Therefore, you should also change any
occurrence of the variable in the code. For this purpose, you may use IDE
capabilities or tools like 'grep'.

These IDs are also used for bookmark references in the help contents. You have
to also rename them inside help contents to make sure that the help bookmarks
remain valid.

Examples:
This is an example change, which can show you what to do:

sc: translate German name in variable
https://gerrit.libreoffice.org/c/core/+/180902

If you look into sc/inc/helpids.h, you may find many other instances that need
translation. The task here is not limited to this file, but this specific file
is a good starting point.

It is important to know that the above IDs are also referred in help contents,
as described here:

Help File XML format Basics > Defining Index, Contents, and Context Sensitivity
> "hid" Branch
https://wiki.documentfoundation.org/Documentation/Understanding,_Authoring_and_Editing_Openoffice.org_Help/2#%22hid%22_Branch

Therefore, you should also do grepping inside help contents. For example:

$ git grep SC_HID_FUNC_WAHL
sc/inc/helpids.h:inline constexpr OUString HID_FUNC_WAHL =
u"SC_HID_FUNC_WAHL"_ustr;

$ cd helpcontent2/
$ git grep SC_HID_FUNC_WAHL
source/text/scalc/01/04060109.xhp:<bookmark branch="hid/SC_HID_FUNC_WAHL"
id="bm_id3153947" localize="false"/>

You should also change the ID(s) in helpcontent2/ folder accordingly.

Notes:
Please do not change unrelated files, like language files related to German
support. The focus here is the C++ code.

-- 
You are receiving this mail because:
You are the assignee for the bug.

Reply via email to