gettext: refresh page

[KristopherLeads]

Updating gettext to include disambiguation options

• The page(s) are in the correct platform directories: common, linux, osx, windows, sunos, android, etc.
• The page(s) have at most 8 examples.
• The page description(s) have links to documentation or a homepage.
• The page(s) follow the content guidelines.
• The page(s) follow the style guide.
• The PR title conforms to the recommended templates.
• Version of the command being documented (if known): 0.25

[CLAassistant]

All committers have signed the CLA.

[KristopherLeads]

For anyone reading this thread in the future, this command has a bit of complexity in terms of where it's looking for the localisation content, and people often get hung up on the file structure. If you have a localised file, you must ensure it lives in the following directory structure:

<LOCALEDIR>/<LANG>/LC_MESSAGES/<domain>.mo

This file is made using the msgfmt tool to convert from a .po to an .mo. Note that it's not good enough to just have it in the director - it needs to be in a subdirectory of LC_MESSAGES for gettext to be able to find it. GNU C does this because there's other variables at play, like LC_TIME for date/time formatting and LC_MONETARY for currency. LC_MESSAGES is specifically for software message strings.

If you're running into localisation issues with gettext, make sure you're in the right directory! A common error is to locate the file like this:

<LOCALEDIR>/<LANG>/<domain>.mo

To correct this, just use the move command:

mv <LOCALEDIR>/<LANG>/<domain>.mo <LOCALEDIR>/<LANG>/LC_MESSAGES/<domain>.mo

E.g.:

mv locale/es/asd.mo locale/es/LC_MESSAGES/asd.mo

[Managor]

Once you apply these, please voice your opinion on what information is missing from the page. I want you to push back when you think my opinion is wrong.

[KristopherLeads]

The only thing I think that's missing here that wouldn't be more confusing to include (thinking --context here) would be:

-n - suppress trailing newline
-V/--version - version of gettext

I'll include in the .md

[Managor]

This feels like it's complete now. Let me know if there's any information that you feel is missing.

[KristopherLeads]

This feels like it's complete now. Let me know if there's any information that you feel is missing.

Ok, I think this is complete now!

[Managor]

@KristopherLeads send a new PR when you have the time to expand this page.