{
    "content": [
        {
            "type": "text",
            "text": "# update-catalog(8) (man)\n\n**Summary:** update-catalog - create or update entry in SGML catalog file\n\n**Synopsis:** update-catalog [options] --add centralizedcatalog ordinarycatalog\nupdate-catalog [options] --remove centralizedcatalog ordinarycatalog\nupdate-catalog [options] --update-super\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| — | --remove | — | Removes the entry for the ordinarycatalog from the centralizedcatalog. |\n| — | --update-super | — | Regenerates the SGML super catalog from the contents of the /etc/sgml directory. See section SUPER CATALOG for details o |\n| — | --quiet | — | Prevents the usual diagnostic output. --test Prevents the update of the catalog and writes the resulting SGML catalog to |\n| — | --version | — | Displays the version information and exits. --help Display the usage information and exits. |\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (6 lines)\n- **DESCRIPTION** (6 lines)\n- **OPTIONS** (2 lines) — 4 subsections\n  - --remove (2 lines)\n  - --update-super (3 lines)\n  - --quiet (5 lines)\n  - --version (4 lines)\n- **SUPER CATALOG** (9 lines)\n- **AUTHOR** (2 lines)\n- **COPYRIGHT** (8 lines)\n\n## Full Content\n\n### NAME\n\nupdate-catalog - create or update entry in SGML catalog file\n\n### SYNOPSIS\n\nupdate-catalog [options] --add centralizedcatalog ordinarycatalog\n\nupdate-catalog [options] --remove centralizedcatalog ordinarycatalog\n\nupdate-catalog [options] --update-super\n\n### DESCRIPTION\n\nupdate-catalog  inserts,  updates or removes entries in the SGML centralized catalogs located\nin /etc/sgml.  To change the SGML super catalog located in /etc/sgml/catalog modify  the  di‐\nrectory  contents of /etc/sgml to contain new files or symbolic links having a .cat extension\nor remove (or move) existing centralized catalogs and regenerate the super catalog using  the\n--update-super option.  See section SUPER CATALOG for details on the generation process.\n\n### OPTIONS\n\n--add  Adds an entry for the ordinarycatalog in the centralizedcatalog.\n\n#### --remove\n\nRemoves the entry for the ordinarycatalog from the centralizedcatalog.\n\n#### --update-super\n\nRegenerates  the SGML super catalog from the contents of the /etc/sgml directory.  See\nsection SUPER CATALOG for details on the super catalog generation.\n\n#### --quiet\n\nPrevents the usual diagnostic output.\n\n--test Prevents the update of the catalog and writes the resulting SGML catalog  to  standard\noutput.\n\n#### --version\n\nDisplays the version information and exits.\n\n--help Display the usage information and exits.\n\n### SUPER CATALOG\n\nThe  super-catalog located in /etc/sgml/catalog cannot be directly modified.  It is generated\nby the  update-catalog  --update-super  command.   The  generation  considers  files  in  the\n/etc/sgml  directory  that have a .cat extension.  For instance files ending in .old or .dis‐\nabled are not considered.  Before adding a catalog to the super catalog it is parsed and ver‐\nified in order to not corrupt the super catalog.  All referenced catalogs are verified to ac‐\ntually exist.  If the check fails, a message is printed and the complete catalog is  ignored.\nThis check ensures that a catalog from a package, which is removed but not purged, is removed\nfrom the super catalog.\n\n### AUTHOR\n\nArdo van Rangelrooij <ardo@debian.org>\n\n### COPYRIGHT\n\nCopyright © 2001-2004 Ardo van Rangelrooij Copyright © 2012 Helmut Grohne\n\nThis is free software; see the GNU General Public Licence version 2 or later for copying con‐\nditions.  There is no warranty.\n\n\n\nDebian Project                                June 2004                            UPDATE-CATALOG(8)\n\n"
        }
    ],
    "structuredContent": {
        "command": "update-catalog",
        "section": "8",
        "mode": "man",
        "summary": "update-catalog - create or update entry in SGML catalog file",
        "synopsis": "update-catalog [options] --add centralizedcatalog ordinarycatalog\nupdate-catalog [options] --remove centralizedcatalog ordinarycatalog\nupdate-catalog [options] --update-super",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "",
                "long": "--remove",
                "arg": null,
                "description": "Removes the entry for the ordinarycatalog from the centralizedcatalog."
            },
            {
                "flag": "",
                "long": "--update-super",
                "arg": null,
                "description": "Regenerates the SGML super catalog from the contents of the /etc/sgml directory. See section SUPER CATALOG for details on the super catalog generation."
            },
            {
                "flag": "",
                "long": "--quiet",
                "arg": null,
                "description": "Prevents the usual diagnostic output. --test Prevents the update of the catalog and writes the resulting SGML catalog to standard output."
            },
            {
                "flag": "",
                "long": "--version",
                "arg": null,
                "description": "Displays the version information and exits. --help Display the usage information and exits."
            }
        ],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 2,
                "subsections": [
                    {
                        "name": "--remove",
                        "lines": 2,
                        "long": "--remove"
                    },
                    {
                        "name": "--update-super",
                        "lines": 3,
                        "long": "--update-super"
                    },
                    {
                        "name": "--quiet",
                        "lines": 5,
                        "long": "--quiet"
                    },
                    {
                        "name": "--version",
                        "lines": 4,
                        "long": "--version"
                    }
                ]
            },
            {
                "name": "SUPER CATALOG",
                "lines": 9,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 8,
                "subsections": []
            }
        ]
    }
}