{ "content": [ { "type": "text", "text": "# recode(1) (man)\n\n**Summary:** recode - converts files between character sets\n\n**Synopsis:** recode [OPTION]... [ [CHARSET] | REQUEST [FILE]... ]\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -l | --list | — | list one or all known charsets and aliases |\n| -k | --known | — | restrict charsets according to known PAIRS list |\n| -h | --header | — | write table NAME on stdout using LN, then exit |\n| -F | --freeze-tables | — | write out a C module holding all tables |\n| -T | --find-subsets | — | report all charsets being subset of others |\n| -C | --copyright | — | display Copyright and copying conditions --help display this help and exit |\n| — | --version | — | output version information and exit |\n| -v | --verbose | — | explain sequence of steps and report progress |\n| -q | --silent | — | inhibit messages about irreversible recodings |\n| -f | --force | — | force recodings even when not reversible |\n| -t | --touch | — | touch the recoded files after replacement |\n| -i | --sequence | — | use intermediate files for sequencing passes --sequence=memory use memory buffers for sequencing passes |\n| -p | --sequence | — | use pipe machinery for sequencing passes |\n| -s | --strict | — | use strict mappings, even loose characters |\n| -d | --diacritics | — | convert only diacritics or alike for HTML/LaTeX |\n| -S | --source | — | limit recoding to strings and comments as for LN |\n| -c | --colons | — | use colons instead of double quotes for diaeresis |\n| -g | --graphics | — | approximate IBMPC rulers by ASCII graphics |\n| -x | --ignore | — | ignore CHARSET while choosing a recoding path Option -l with no FORMAT nor CHARSET list available charsets and surfaces. |\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (5 lines) — 22 subsections\n - Listings: (1 lines)\n - -l --list (2 lines)\n - -k --known (2 lines)\n - -h --header[ (2 lines)\n - -F --freeze-tables (2 lines)\n - -T --find-subsets (2 lines)\n - -C --copyright (4 lines)\n - --version (2 lines)\n - Operation modes: (1 lines)\n - -v --verbose (2 lines)\n - -q --quiet --silent (2 lines)\n - -f --force (2 lines)\n - -t --touch (2 lines)\n - -i --sequence (5 lines)\n - -p --sequence (2 lines)\n - Fine tuning: (1 lines)\n - -s --strict (2 lines)\n - -d --diacritics (2 lines)\n - -S --source (2 lines)\n - -c --colons (2 lines)\n - -g --graphics (2 lines)\n - -x --ignore (20 lines)\n- **AUTHOR** (2 lines)\n- **REPORTING BUGS** (2 lines)\n- **COPYRIGHT** (4 lines)\n- **SEE ALSO** (10 lines)\n\n## Full Content\n\n### NAME\n\nrecode - converts files between character sets\n\n### SYNOPSIS\n\nrecode [OPTION]... [ [CHARSET] | REQUEST [FILE]... ]\n\n### DESCRIPTION\n\nFree `recode' converts files between various character sets and surfaces.\n\nIf a long option shows an argument as mandatory, then it is mandatory for the equivalent\nshort option also. Similarly for optional arguments.\n\n#### Listings:\n\n#### -l --list\n\nlist one or all known charsets and aliases\n\n#### -k --known\n\nrestrict charsets according to known PAIRS list\n\n#### -h --header[\n\nwrite table NAME on stdout using LN, then exit\n\n#### -F --freeze-tables\n\nwrite out a C module holding all tables\n\n#### -T --find-subsets\n\nreport all charsets being subset of others\n\n#### -C --copyright\n\ndisplay Copyright and copying conditions\n\n--help display this help and exit\n\n#### --version\n\noutput version information and exit\n\n#### Operation modes:\n\n#### -v --verbose\n\nexplain sequence of steps and report progress\n\n#### -q --quiet --silent\n\ninhibit messages about irreversible recodings\n\n#### -f --force\n\nforce recodings even when not reversible\n\n#### -t --touch\n\ntouch the recoded files after replacement\n\n#### -i --sequence\n\nuse intermediate files for sequencing passes\n\n--sequence=memory\nuse memory buffers for sequencing passes\n\n#### -p --sequence\n\nuse pipe machinery for sequencing passes\n\n#### Fine tuning:\n\n#### -s --strict\n\nuse strict mappings, even loose characters\n\n#### -d --diacritics\n\nconvert only diacritics or alike for HTML/LaTeX\n\n#### -S --source\n\nlimit recoding to strings and comments as for LN\n\n#### -c --colons\n\nuse colons instead of double quotes for diaeresis\n\n#### -g --graphics\n\napproximate IBMPC rulers by ASCII graphics\n\n#### -x --ignore\n\nignore CHARSET while choosing a recoding path\n\nOption -l with no FORMAT nor CHARSET list available charsets and surfaces. FORMAT is `deci‐\nmal', `octal', `hexadecimal' or `full' (or one of `dohf'). Unless DEFAULTCHARSET is set in\nenvironment, CHARSET defaults to the locale dependent encoding, determined by LCALL,\nLCCTYPE, LANG. With -k, possible before charsets are listed for the given after CHARSET,\nboth being tabular charsets, with PAIRS of the form `BEF1:AFT1,BEF2:AFT2,...' and BEFs and\nAFTs being codes are given as decimal numbers. LN is some language, it may be `c', `perl' or\n`po'; `c' is the default.\n\nREQUEST is SUBREQUEST[,SUBREQUEST]...; SUBREQUEST is ENCODING[..ENCODING]... ENCODING is\n[CHARSET][/[SURFACE]]...; REQUEST often looks like BEFORE..AFTER, with BEFORE and AFTER being\ncharsets. An omitted CHARSET implies the usual charset; an omitted [/SURFACE]... means the\nimplied surfaces for CHARSET; a / with an empty surface name means no surfaces at all. See\nthe manual.\n\nIf none of -i and -p are given, presume -p if no FILE, else -i. Each FILE is recoded over\nitself, destroying the original. If no FILE is specified, then act as a filter and recode\nstdin to stdout.\n\n### AUTHOR\n\nWritten by Franc,ois Pinard .\n\n### REPORTING BUGS\n\nReport bugs to .\n\n### COPYRIGHT\n\nCopyright © 1990, 92, 93, 94, 96, 97, 99 Free Software Foundation, Inc.\nThis is free software; see the source for copying conditions. There is NO warranty; not even\nfor MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n\n### SEE ALSO\n\nThe full documentation for recode is maintained as a Texinfo manual. If the info and recode\nprograms are properly installed at your site, the command\n\ninfo recode\n\nshould give you access to the complete manual.\n\n\n\nFree recode 3.6 January 2001 RECODE(1)\n\n" } ], "structuredContent": { "command": "recode", "section": "1", "mode": "man", "summary": "recode - converts files between character sets", "synopsis": "recode [OPTION]... [ [CHARSET] | REQUEST [FILE]... ]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "-l", "long": "--list", "arg": null, "description": "list one or all known charsets and aliases" }, { "flag": "-k", "long": "--known", "arg": null, "description": "restrict charsets according to known PAIRS list" }, { "flag": "-h", "long": "--header", "arg": null, "description": "write table NAME on stdout using LN, then exit" }, { "flag": "-F", "long": "--freeze-tables", "arg": null, "description": "write out a C module holding all tables" }, { "flag": "-T", "long": "--find-subsets", "arg": null, "description": "report all charsets being subset of others" }, { "flag": "-C", "long": "--copyright", "arg": null, "description": "display Copyright and copying conditions --help display this help and exit" }, { "flag": "", "long": "--version", "arg": null, "description": "output version information and exit" }, { "flag": "-v", "long": "--verbose", "arg": null, "description": "explain sequence of steps and report progress" }, { "flag": "-q", "long": "--silent", "arg": null, "description": "inhibit messages about irreversible recodings" }, { "flag": "-f", "long": "--force", "arg": null, "description": "force recodings even when not reversible" }, { "flag": "-t", "long": "--touch", "arg": null, "description": "touch the recoded files after replacement" }, { "flag": "-i", "long": "--sequence", "arg": null, "description": "use intermediate files for sequencing passes --sequence=memory use memory buffers for sequencing passes" }, { "flag": "-p", "long": "--sequence", "arg": null, "description": "use pipe machinery for sequencing passes" }, { "flag": "-s", "long": "--strict", "arg": null, "description": "use strict mappings, even loose characters" }, { "flag": "-d", "long": "--diacritics", "arg": null, "description": "convert only diacritics or alike for HTML/LaTeX" }, { "flag": "-S", "long": "--source", "arg": null, "description": "limit recoding to strings and comments as for LN" }, { "flag": "-c", "long": "--colons", "arg": null, "description": "use colons instead of double quotes for diaeresis" }, { "flag": "-g", "long": "--graphics", "arg": null, "description": "approximate IBMPC rulers by ASCII graphics" }, { "flag": "-x", "long": "--ignore", "arg": null, "description": "ignore CHARSET while choosing a recoding path Option -l with no FORMAT nor CHARSET list available charsets and surfaces. FORMAT is `deci‐ mal', `octal', `hexadecimal' or `full' (or one of `dohf'). Unless DEFAULTCHARSET is set in environment, CHARSET defaults to the locale dependent encoding, determined by LCALL, LCCTYPE, LANG. With -k, possible before charsets are listed for the given after CHARSET, both being tabular charsets, with PAIRS of the form `BEF1:AFT1,BEF2:AFT2,...' and BEFs and AFTs being codes are given as decimal numbers. LN is some language, it may be `c', `perl' or `po'; `c' is the default. REQUEST is SUBREQUEST[,SUBREQUEST]...; SUBREQUEST is ENCODING[..ENCODING]... ENCODING is [CHARSET][/[SURFACE]]...; REQUEST often looks like BEFORE..AFTER, with BEFORE and AFTER being charsets. An omitted CHARSET implies the usual charset; an omitted [/SURFACE]... means the implied surfaces for CHARSET; a / with an empty surface name means no surfaces at all. See the manual. If none of -i and -p are given, presume -p if no FILE, else -i. Each FILE is recoded over itself, destroying the original. If no FILE is specified, then act as a filter and recode stdin to stdout." } ], "examples": [], "see_also": [], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 5, "subsections": [ { "name": "Listings:", "lines": 1 }, { "name": "-l --list", "lines": 2, "flag": "-l", "long": "--list" }, { "name": "-k --known", "lines": 2, "flag": "-k", "long": "--known" }, { "name": "-h --header[", "lines": 2, "flag": "-h" }, { "name": "-F --freeze-tables", "lines": 2, "flag": "-F", "long": "--freeze-tables" }, { "name": "-T --find-subsets", "lines": 2, "flag": "-T", "long": "--find-subsets" }, { "name": "-C --copyright", "lines": 4, "flag": "-C", "long": "--copyright" }, { "name": "--version", "lines": 2, "long": "--version" }, { "name": "Operation modes:", "lines": 1 }, { "name": "-v --verbose", "lines": 2, "flag": "-v", "long": "--verbose" }, { "name": "-q --quiet --silent", "lines": 2, "flag": "-q", "long": "--silent" }, { "name": "-f --force", "lines": 2, "flag": "-f", "long": "--force" }, { "name": "-t --touch", "lines": 2, "flag": "-t", "long": "--touch" }, { "name": "-i --sequence", "lines": 5, "flag": "-i", "long": "--sequence" }, { "name": "-p --sequence", "lines": 2, "flag": "-p", "long": "--sequence" }, { "name": "Fine tuning:", "lines": 1 }, { "name": "-s --strict", "lines": 2, "flag": "-s", "long": "--strict" }, { "name": "-d --diacritics", "lines": 2, "flag": "-d", "long": "--diacritics" }, { "name": "-S --source", "lines": 2, "flag": "-S", "long": "--source" }, { "name": "-c --colons", "lines": 2, "flag": "-c", "long": "--colons" }, { "name": "-g --graphics", "lines": 2, "flag": "-g", "long": "--graphics" }, { "name": "-x --ignore", "lines": 20, "flag": "-x", "long": "--ignore" } ] }, { "name": "AUTHOR", "lines": 2, "subsections": [] }, { "name": "REPORTING BUGS", "lines": 2, "subsections": [] }, { "name": "COPYRIGHT", "lines": 4, "subsections": [] }, { "name": "SEE ALSO", "lines": 10, "subsections": [] } ] } }