{
    "content": [
        {
            "type": "text",
            "text": "# tfmtodit (man)\n\n## NAME\n\ntfmtodit - create font files for use with groff -Tdvi\n\n## SYNOPSIS\n\ntfmtodit [-s] [-g gffile] [-k skewchar] tfmfile mapfile font\n\n## DESCRIPTION\n\ntfmtodit  creates a font file for use with groff -Tdvi.  tfmfile is the name of the TeX font\nmetric file for the font.  mapfile is a file giving the groff names for  characters  in  the\nfont; this file should consist of a sequence of lines of the form:\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS** (3 subsections)\n- **DESCRIPTION**\n- **OPTIONS** (4 subsections)\n- **FILES**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "tfmtodit",
        "section": "",
        "mode": "man",
        "summary": "tfmtodit - create font files for use with groff -Tdvi",
        "synopsis": "tfmtodit [-s] [-g gffile] [-k skewchar] tfmfile mapfile font",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "-v",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "-s",
                "long": null,
                "arg": null,
                "description": "font file."
            },
            {
                "flag": "-k",
                "long": null,
                "arg": null,
                "description": "in decimal, or with a leading 0 in octal, or with a leading 0x in hexadecimal. The effect of this option is to ignore any kerns whose second component is the specified character."
            },
            {
                "flag": "-g",
                "long": null,
                "arg": null,
                "description": "gffile is a gf file produced by Metafont containing special and numspecial commands giving additional font metric information."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "groff",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/groff/1/json"
            },
            {
                "name": "grodvi",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/grodvi/1/json"
            },
            {
                "name": "grofffont",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/grofffont/5/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": [
                    {
                        "name": "tfmtodit --help",
                        "lines": 1
                    },
                    {
                        "name": "tfmtodit -v",
                        "lines": 1
                    },
                    {
                        "name": "tfmtodit --version",
                        "lines": 1
                    }
                ]
            },
            {
                "name": "DESCRIPTION",
                "lines": 42,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 2,
                "subsections": [
                    {
                        "name": "-v",
                        "lines": 1,
                        "flag": "-v"
                    },
                    {
                        "name": "-s",
                        "lines": 2,
                        "flag": "-s"
                    },
                    {
                        "name": "-k",
                        "lines": 4,
                        "flag": "-k"
                    },
                    {
                        "name": "-g",
                        "lines": 3,
                        "flag": "-g"
                    }
                ]
            },
            {
                "name": "FILES",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "tfmtodit - create font files for use with groff -Tdvi\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "tfmtodit [-s] [-g gffile] [-k skewchar] tfmfile mapfile font\n",
                "subsections": [
                    {
                        "name": "tfmtodit --help",
                        "content": ""
                    },
                    {
                        "name": "tfmtodit -v",
                        "content": ""
                    },
                    {
                        "name": "tfmtodit --version",
                        "content": ""
                    }
                ]
            },
            "DESCRIPTION": {
                "content": "tfmtodit  creates a font file for use with groff -Tdvi.  tfmfile is the name of the TeX font\nmetric file for the font.  mapfile is a file giving the groff names for  characters  in  the\nfont; this file should consist of a sequence of lines of the form:\n\nn c1 c2 ...\n\nwhere n is a decimal integer giving the position of the character in the font, and c1, c2,...\nare the groff names of the character.  If a character has no groff names but  exists  in  the\ntfm  file,  then  it will be put in the groff font file as an unnamed character.  font is the\nname of the groff font file.  The groff font file is written to font.\n\nThe -s option should be given if the font is special (a  font  is  special  if  troff  should\nsearch it whenever a character is not found in the current font.)  If the font is special, it\nshould be listed in the fonts command in the DESC file; if it is not  special,  there  is  no\nneed to list it, since troff can automatically mount it when it's first used.\n\nTo  do  a good job of math typesetting, groff requires font metric information not present in\nthe tfm file.  The reason for this is that TeX has separate math italic fonts  whereas  groff\nuses  normal italic fonts for math.  The additional information required by groff is given by\nthe two arguments to the mathfit macro in the Metafont  programs  for  the  Computer  Modern\nfonts.   In  a  text font (a font for which mathfitting is false), Metafont normally ignores\nthese two arguments.  Metafont can be made to put this information in the gf file by  loading\nthe following definition after cmbase when creating cm.base:\n\ndef ignoremathfit(expr leftadjustment,rightadjustment) =\nspecial \"adjustment\";\nnumspecial leftadjustment*16/designsize;\nnumspecial rightadjustment*16/designsize;\nenddef;\n\nFor the EC font family, load the following definition after exbase (it is probably easiest to\npatch exbase.mf locally):\n\ndef ignoremathfit(expr leftadjustment,rightadjustment) =\norispecial \"adjustment\";\norinumspecial leftadjustment*16/designsize;\norinumspecial rightadjustment*16/designsize;\nenddef;\n\nThe gf file created using this modified cm.base or exbase should be specified with the -g op‐\ntion.  The -g option should not be given for a font for which mathfitting is true.\n",
                "subsections": []
            },
            "OPTIONS": {
                "content": "Whitespace is permitted between a command-line option and its argument.\n",
                "subsections": [
                    {
                        "name": "-v",
                        "content": "",
                        "flag": "-v"
                    },
                    {
                        "name": "-s",
                        "content": "font file.\n",
                        "flag": "-s"
                    },
                    {
                        "name": "-k",
                        "content": "in  decimal,  or  with a leading 0 in octal, or with a leading 0x in hexadecimal.  The\neffect of this option is to ignore any kerns whose second component is  the  specified\ncharacter.\n",
                        "flag": "-k"
                    },
                    {
                        "name": "-g",
                        "content": "gffile  is  a gf file produced by Metafont containing special and numspecial commands\ngiving additional font metric information.\n",
                        "flag": "-g"
                    }
                ]
            },
            "FILES": {
                "content": "/usr/share/groff/1.22.4/font/devdvi/DESC\nDevice description file.\n\n/usr/share/groff/1.22.4/font/devdvi/F\nFont description file for font F.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "groff(1), grodvi(1), grofffont(5)\n\n\n\ngroff 1.22.4                                23 March 2022                                TFMTODIT(1)",
                "subsections": []
            }
        }
    }
}