{
    "mode": "man",
    "parameter": "GPINYIN",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/man/GPINYIN/json",
    "generated": "2026-10-22T13:18:01Z",
    "sections": {
        "Name": {
            "content": "gpinyin - use Hanyu Pinyin Chinese in groff documents\n",
            "subsections": []
        },
        "Synopsis": {
            "content": "gpinyin [file ...]\n\ngpinyin -h\ngpinyin --help\n\ngpinyin -v\ngpinyin --version\n",
            "subsections": []
        },
        "Description": {
            "content": "gpinyin  is  a  preprocessor  for  groff(1)  that facilitates use of Hanyu Pinyin in groff(7)\nfiles.  Pinyin is a method for writing the Mandarin Chinese language with the Latin alphabet.\nMandarin consists of more than four hundred base syllables, each spoken with one of five dif-\nferent tones.  Changing the tone applied to the syllable generally alters the meaning of  the\nword it forms.  In Pinyin, a syllable is written in the Latin alphabet and a numeric tone in-\ndicator can be appended to each syllable.\n\nEach  input-file  is  a  file  name  or the character \"-\" to indicate that the standard input\nstream should be read.  As usual, the argument \"--\" can be used in order to force interpreta-\ntion of all remaining arguments as file names, even if an input-file argument begins  with  a\n\"-\".  -h and --help display a usage message, while -v and --version show version information;\nall exit afterward.\n\nPinyin sections\nPinyin sections in groff files are enclosed by two .pinyin requests with different arguments.\nThe starting request is\n.pinyin start\nor\n.pinyin begin\nand the ending request is\n.pinyin stop\nor\n.pinyin end\n.\n\nSyllables\nIn Pinyin, each syllable is represented by one to six letters drawn from the fifty-two upper-\nand  lowercase  letters  of  the  Unicode basic Latin character set, plus the letter \"U\" with\ndieresis (umlaut) in both cases--in other words, the members of the set \"[a-zA-ZuU]\".\n\nIn groff input, all basic Latin letters are written as themselves.  The \"u with dieresis\" can\nbe written as \"\\[:u]\" in lowercase or \"\\[:U]\" in uppercase.  Within .pinyin sections, gpinyin\nsupports the form \"ue\" for lowercase and the forms \"Ue\" and \"UE\" for uppercase.\n\nTones\nEach syllable has exactly one of five tones.  The fifth tone is  not  explicitly  written  at\nall,  but  each  of the first through fourth tones is indicated with a diacritic above a spe-\ncific vowel within the syllable.\n\nIn a gpinyin source file, these tones are written by adding a numeral in the range 0 to 5 af-\nter the syllable.  The tone numbers 1 to 4 are transformed into accents above vowels  in  the\noutput.  The tone numbers 0 and 5 are synonymous.\n\n[The tone mark table is omitted from this rendering of the man page because the selected out-\nput device \"ascii\" lacks the character repertoire to display it.  Try another output device.]\n\nThe neutral tone number can be omitted from a word-final syllable, but not otherwise.\n",
            "subsections": []
        },
        "Authors": {
            "content": "gpinyin was written by Bernd Warken.\n\nSee also\nUseful documents on the World Wide Web related to Pinyin include\nPinyin to Unicode,\nOn-line Chinese Tools,\nPinyin.info: a guide to the writing of Mandarin Chinese in romanization,\n\"Where do the tone marks go?\",\npinyin.txt from the CJK macro package for TeX,\nand\npinyin.sty from the CJK macro package for TeX.\n\ngroff(1) and grog(1) explain how to view roff documents.\n\ngroff(7) and groffchar(7) are comprehensive references covering the language elements of GNU\ntroff and the available glyph repertoire, respectively.\n\ngroff 1.23.0                              31 March 2024                                gpinyin(1)",
            "subsections": []
        }
    },
    "flags": [],
    "examples": [],
    "see_also": []
}