{ "content": [ { "type": "text", "text": "# msgmerge (man)\n\n## NAME\n\nmsgmerge - merge message catalog and template\n\n## SYNOPSIS\n\nmsgmerge [OPTION] def.po ref.pot\n\n## DESCRIPTION\n\nMerges two Uniforum style .po files together. The def.po file is an existing PO file with\ntranslations which will be taken over to the newly created file as long as they still match;\ncomments will be preserved, but extracted comments and file positions will be discarded. The\nref.pot file is the last created PO file with up-to-date source references but old transla‐\ntions, or a PO Template file (generally created by xgettext); any translations or comments in\nthe file will be discarded, however dot comments and file positions will be preserved. Where\nan exact match cannot be found, fuzzy matching is used to produce better results.\n\n## TLDR\n\n> Update an existing translation file from a new template.\n\n- Update a translation file:\n `msgmerge {{-U|--update}} {{path/to/file.po}} {{path/to/messages.pot}}`\n- Display help:\n `msgmerge {{-h|--help}}`\n\n*Source: tldr-pages*\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION** (35 subsections)\n- **AUTHOR**\n- **REPORTING BUGS**\n- **COPYRIGHT**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "msgmerge", "section": "", "mode": "man", "summary": "msgmerge - merge message catalog and template", "synopsis": "msgmerge [OPTION] def.po ref.pot", "tldr_summary": "Update an existing translation file from a new template.", "tldr_examples": [ { "description": "Update a translation file", "command": "msgmerge {{-U|--update}} {{path/to/file.po}} {{path/to/messages.pot}}" }, { "description": "Display help", "command": "msgmerge {{-h|--help}}" } ], "tldr_source": "official", "flags": [ { "flag": "-D", "long": "--directory", "arg": null, "description": "add DIRECTORY to list for input files search" }, { "flag": "-C", "long": "--compendium", "arg": null, "description": "additional library of message translations, may be specified more than once" }, { "flag": "-U", "long": "--update", "arg": null, "description": "update def.po, do nothing if def.po already up to date" }, { "flag": "-o", "long": "--output-file", "arg": null, "description": "write output to specified file The results are written to standard output if no output file is specified or if it is -. Output file location in update mode: The result is written back to def.po. --backup=CONTROL make a backup of def.po --suffix=SUFFIX override the usual backup suffix The version control method may be selected via the --backup option or through the VER‐ SIONCONTROL environment variable. Here are the values: none, off never make backups (even if --backup is given) numbered, t make numbered backups existing, nil numbered if numbered backups exist, simple otherwise simple, never always make simple backups The backup suffix is '~', unless set with --suffix or the SIMPLEBACKUPSUFFIX environment variable." }, { "flag": "-m", "long": "--multi-domain", "arg": null, "description": "apply ref.pot to each of the domains in def.po" }, { "flag": "", "long": "--for-msgfmt", "arg": null, "description": "produce output for 'msgfmt', not for a translator" }, { "flag": "-N", "long": "--no-fuzzy-matching", "arg": null, "description": "do not use fuzzy matching" }, { "flag": "", "long": "--previous", "arg": null, "description": "keep previous msgids of translated messages" }, { "flag": "-P", "long": "--properties-input", "arg": null, "description": "input files are in Java .properties syntax" }, { "flag": "", "long": "--stringtable-input", "arg": null, "description": "input files are in NeXTstep/GNUstep .strings syntax" }, { "flag": "", "long": "--color", "arg": null, "description": "use colors and other text attributes always --color=WHEN use colors and other text attributes if WHEN. WHEN may be 'always', 'never', 'auto', or 'html'. --style=STYLEFILE specify CSS style rule file for --color" }, { "flag": "-e", "long": "--no-escape", "arg": null, "description": "do not use C escapes in output (default)" }, { "flag": "-E", "long": "--escape", "arg": null, "description": "use C escapes in output, no extended chars" }, { "flag": "", "long": "--force-po", "arg": null, "description": "write PO file even if empty" }, { "flag": "-i", "long": "--indent", "arg": null, "description": "indented output style" }, { "flag": "", "long": "--no-location", "arg": null, "description": "suppress '#: filename:line' lines" }, { "flag": "-n", "long": "--add-location", "arg": null, "description": "preserve '#: filename:line' lines (default)" }, { "flag": "", "long": "--strict", "arg": null, "description": "strict Uniforum output style" }, { "flag": "-p", "long": "--properties-output", "arg": null, "description": "write out a Java .properties file" }, { "flag": "", "long": "--stringtable-output", "arg": null, "description": "write out a NeXTstep/GNUstep .strings file" }, { "flag": "-w", "long": "--width", "arg": null, "description": "set output page width" }, { "flag": "", "long": "--no-wrap", "arg": null, "description": "do not break long message lines, longer than the output page width, into several lines" }, { "flag": "-s", "long": "--sort-output", "arg": null, "description": "generate sorted output" }, { "flag": "-F", "long": "--sort-by-file", "arg": null, "description": "sort output by file location" }, { "flag": "-h", "long": "--help", "arg": null, "description": "display this help and exit" }, { "flag": "-V", "long": "--version", "arg": null, "description": "output version information and exit" }, { "flag": "-v", "long": "--verbose", "arg": null, "description": "increase verbosity level" }, { "flag": "-q", "long": "--silent", "arg": null, "description": "suppress progress indicators" } ], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 10, "subsections": [ { "name": "Input file location:", "lines": 5 }, { "name": "-D --directory", "lines": 2, "flag": "-D", "long": "--directory" }, { "name": "-C --compendium", "lines": 2, "flag": "-C", "long": "--compendium" }, { "name": "Operation mode:", "lines": 1 }, { "name": "-U --update", "lines": 2, "flag": "-U", "long": "--update" }, { "name": "Output file location:", "lines": 1 }, { "name": "-o --output-file", "lines": 30, "flag": "-o", "long": "--output-file" }, { "name": "Operation modifiers:", "lines": 1 }, { "name": "-m --multi-domain", "lines": 2, "flag": "-m", "long": "--multi-domain" }, { "name": "--for-msgfmt", "lines": 2, "long": "--for-msgfmt" }, { "name": "-N --no-fuzzy-matching", "lines": 2, "flag": "-N", "long": "--no-fuzzy-matching" }, { "name": "--previous", "lines": 2, "long": "--previous" }, { "name": "Input file syntax:", "lines": 1 }, { "name": "-P --properties-input", "lines": 2, "flag": "-P", "long": "--properties-input" }, { "name": "--stringtable-input", "lines": 2, "long": "--stringtable-input" }, { "name": "Output details:", "lines": 3 }, { "name": "--color", "lines": 9, "long": "--color" }, { "name": "-e --no-escape", "lines": 2, "flag": "-e", "long": "--no-escape" }, { "name": "-E --escape", "lines": 2, "flag": "-E", "long": "--escape" }, { "name": "--force-po", "lines": 2, "long": "--force-po" }, { "name": "-i --indent", "lines": 2, "flag": "-i", "long": "--indent" }, { "name": "--no-location", "lines": 2, "long": "--no-location" }, { "name": "-n --add-location", "lines": 2, "flag": "-n", "long": "--add-location" }, { "name": "--strict", "lines": 2, "long": "--strict" }, { "name": "-p --properties-output", "lines": 2, "flag": "-p", "long": "--properties-output" }, { "name": "--stringtable-output", "lines": 2, "long": "--stringtable-output" }, { "name": "-w --width", "lines": 2, "flag": "-w", "long": "--width" }, { "name": "--no-wrap", "lines": 2, "long": "--no-wrap" }, { "name": "-s --sort-output", "lines": 2, "flag": "-s", "long": "--sort-output" }, { "name": "-F --sort-by-file", "lines": 2, "flag": "-F", "long": "--sort-by-file" }, { "name": "Informative output:", "lines": 1 }, { "name": "-h --help", "lines": 2, "flag": "-h", "long": "--help" }, { "name": "-V --version", "lines": 2, "flag": "-V", "long": "--version" }, { "name": "-v --verbose", "lines": 2, "flag": "-v", "long": "--verbose" }, { "name": "-q --quiet --silent", "lines": 2, "flag": "-q", "long": "--silent" } ] }, { "name": "AUTHOR", "lines": 2, "subsections": [] }, { "name": "REPORTING BUGS", "lines": 3, "subsections": [] }, { "name": "COPYRIGHT", "lines": 5, "subsections": [] }, { "name": "SEE ALSO", "lines": 10, "subsections": [] } ], "sections": { "NAME": { "content": "msgmerge - merge message catalog and template\n", "subsections": [] }, "SYNOPSIS": { "content": "msgmerge [OPTION] def.po ref.pot\n", "subsections": [] }, "DESCRIPTION": { "content": "Merges two Uniforum style .po files together. The def.po file is an existing PO file with\ntranslations which will be taken over to the newly created file as long as they still match;\ncomments will be preserved, but extracted comments and file positions will be discarded. The\nref.pot file is the last created PO file with up-to-date source references but old transla‐\ntions, or a PO Template file (generally created by xgettext); any translations or comments in\nthe file will be discarded, however dot comments and file positions will be preserved. Where\nan exact match cannot be found, fuzzy matching is used to produce better results.\n\nMandatory arguments to long options are mandatory for short options too.\n", "subsections": [ { "name": "Input file location:", "content": "def.po translations referring to old sources\n\nref.pot\nreferences to new sources\n" }, { "name": "-D --directory", "content": "add DIRECTORY to list for input files search\n", "flag": "-D", "long": "--directory" }, { "name": "-C --compendium", "content": "additional library of message translations, may be specified more than once\n", "flag": "-C", "long": "--compendium" }, { "name": "Operation mode:", "content": "" }, { "name": "-U --update", "content": "update def.po, do nothing if def.po already up to date\n", "flag": "-U", "long": "--update" }, { "name": "Output file location:", "content": "" }, { "name": "-o --output-file", "content": "write output to specified file\n\nThe results are written to standard output if no output file is specified or if it is -.\n\nOutput file location in update mode: The result is written back to def.po.\n\n--backup=CONTROL\nmake a backup of def.po\n\n--suffix=SUFFIX\noverride the usual backup suffix\n\nThe version control method may be selected via the --backup option or through the VER‐\nSIONCONTROL environment variable. Here are the values:\n\nnone, off\nnever make backups (even if --backup is given)\n\nnumbered, t\nmake numbered backups\n\nexisting, nil\nnumbered if numbered backups exist, simple otherwise\n\nsimple, never\nalways make simple backups\n\nThe backup suffix is '~', unless set with --suffix or the SIMPLEBACKUPSUFFIX environment\nvariable.\n", "flag": "-o", "long": "--output-file" }, { "name": "Operation modifiers:", "content": "" }, { "name": "-m --multi-domain", "content": "apply ref.pot to each of the domains in def.po\n", "flag": "-m", "long": "--multi-domain" }, { "name": "--for-msgfmt", "content": "produce output for 'msgfmt', not for a translator\n", "long": "--for-msgfmt" }, { "name": "-N --no-fuzzy-matching", "content": "do not use fuzzy matching\n", "flag": "-N", "long": "--no-fuzzy-matching" }, { "name": "--previous", "content": "keep previous msgids of translated messages\n", "long": "--previous" }, { "name": "Input file syntax:", "content": "" }, { "name": "-P --properties-input", "content": "input files are in Java .properties syntax\n", "flag": "-P", "long": "--properties-input" }, { "name": "--stringtable-input", "content": "input files are in NeXTstep/GNUstep .strings syntax\n", "long": "--stringtable-input" }, { "name": "Output details:", "content": "--lang=CATALOGNAME\nset 'Language' field in the header entry\n" }, { "name": "--color", "content": "use colors and other text attributes always\n\n--color=WHEN\nuse colors and other text attributes if WHEN. WHEN may be 'always', 'never', 'auto',\nor 'html'.\n\n--style=STYLEFILE\nspecify CSS style rule file for --color\n", "long": "--color" }, { "name": "-e --no-escape", "content": "do not use C escapes in output (default)\n", "flag": "-e", "long": "--no-escape" }, { "name": "-E --escape", "content": "use C escapes in output, no extended chars\n", "flag": "-E", "long": "--escape" }, { "name": "--force-po", "content": "write PO file even if empty\n", "long": "--force-po" }, { "name": "-i --indent", "content": "indented output style\n", "flag": "-i", "long": "--indent" }, { "name": "--no-location", "content": "suppress '#: filename:line' lines\n", "long": "--no-location" }, { "name": "-n --add-location", "content": "preserve '#: filename:line' lines (default)\n", "flag": "-n", "long": "--add-location" }, { "name": "--strict", "content": "strict Uniforum output style\n", "long": "--strict" }, { "name": "-p --properties-output", "content": "write out a Java .properties file\n", "flag": "-p", "long": "--properties-output" }, { "name": "--stringtable-output", "content": "write out a NeXTstep/GNUstep .strings file\n", "long": "--stringtable-output" }, { "name": "-w --width", "content": "set output page width\n", "flag": "-w", "long": "--width" }, { "name": "--no-wrap", "content": "do not break long message lines, longer than the output page width, into several lines\n", "long": "--no-wrap" }, { "name": "-s --sort-output", "content": "generate sorted output\n", "flag": "-s", "long": "--sort-output" }, { "name": "-F --sort-by-file", "content": "sort output by file location\n", "flag": "-F", "long": "--sort-by-file" }, { "name": "Informative output:", "content": "" }, { "name": "-h --help", "content": "display this help and exit\n", "flag": "-h", "long": "--help" }, { "name": "-V --version", "content": "output version information and exit\n", "flag": "-V", "long": "--version" }, { "name": "-v --verbose", "content": "increase verbosity level\n", "flag": "-v", "long": "--verbose" }, { "name": "-q --quiet --silent", "content": "suppress progress indicators\n", "flag": "-q", "long": "--silent" } ] }, "AUTHOR": { "content": "Written by Peter Miller.\n", "subsections": [] }, "REPORTING BUGS": { "content": "Report bugs in the bug tracker at or by email to\n.\n", "subsections": [] }, "COPYRIGHT": { "content": "Copyright © 1995-2020 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or\nlater \nThis is free software: you are free to change and redistribute it. There is NO WARRANTY, to\nthe extent permitted by law.\n", "subsections": [] }, "SEE ALSO": { "content": "The full documentation for msgmerge is maintained as a Texinfo manual. If the info and msg‐‐\nmerge programs are properly installed at your site, the command\n\ninfo msgmerge\n\nshould give you access to the complete manual.\n\n\n\nGNU gettext-tools 0.21 March 2022 MSGMERGE(1)", "subsections": [] } } } }