{
    "content": [
        {
            "type": "text",
            "text": "# Data::Grove (perldoc)\n\n## NAME\n\nData::Grove -- support for deeply nested structures\n\n## SYNOPSIS\n\nuse Data::Grove;\n$object = MyPackage->new;\npackage MyPackage;\n@ISA = qw{Data::Grove};\n\n## DESCRIPTION\n\n\"Data::Grove\" provides support for deeply nested tree or graph structures. \"Data::Grove\" is\nintended primarily for Perl module authors writing modules with many types or classes of objects\nthat need to be manipulated and extended in a consistent and flexible way.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **METHODS** (1 subsections)\n- **AUTHOR**\n- **SEE ALSO** (1 subsections)\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "Data::Grove",
        "section": "",
        "mode": "perldoc",
        "summary": "Data::Grove -- support for deeply nested structures",
        "synopsis": "use Data::Grove;\n$object = MyPackage->new;\npackage MyPackage;\n@ISA = qw{Data::Grove};",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 7,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 28,
                "subsections": []
            },
            {
                "name": "METHODS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "new",
                        "lines": 6
                    }
                ]
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 1,
                "subsections": [
                    {
                        "name": "perl",
                        "lines": 1
                    }
                ]
            }
        ],
        "sections": {
            "NAME": {
                "content": "Data::Grove -- support for deeply nested structures\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "use Data::Grove;\n\n$object = MyPackage->new;\n\npackage MyPackage;\n@ISA = qw{Data::Grove};\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "\"Data::Grove\" provides support for deeply nested tree or graph structures. \"Data::Grove\" is\nintended primarily for Perl module authors writing modules with many types or classes of objects\nthat need to be manipulated and extended in a consistent and flexible way.\n\n\"Data::Grove\" is best used by creating a core set of ``data'' classes and then incrementally\nadding functionality to the core data classes by using ``extension'' modules. One reason for\nthis design is so that the data classes can be swapped out and the extension modules can work\nwith new data sources. For example, these other data sources could be disk-based, network-based\nor built on top of a relational database.\n\nTwo extension modules that come with \"Data::Grove\" are \"Data::Grove::Parent\" and\n\"Data::Grove::Visitor\". \"Data::Grove::Parent\" adds a `\"Parent\"' property to grove objects and\nimplements a `\"root\"' method to grove objects to return the root node of the tree from anywhere\nin the tree and a `\"rootpath\"' method to return a list of nodes between the root node and\n``this'' node. \"Data::Grove::Visitor\" adds callback methods `\"accept\"' and `\"acceptname\"' that\ncall your handler or receiver module back by object type name or the object's name.\n\n\"Data::Grove\" objects do not contain parent references, Perl garbage collection will delete them\nwhen no longer referenced and sub-structures can be shared among several structures.\n\"Data::Grove::Parent\" is used to create temporary objects with parent pointers.\n\nProperties of data classes are accessed directly using Perl's hash functions (i.e.\n`\"$object->{Property}\"'). Extension modules may also define properties that they support or use,\nfor example Data::Grove::Parent adds `\"Parent\"' and `\"Raw\"' properties and Visitor depends on\n`\"Name\"' and `\"Content\"' properties.\n\nSee the module \"XML::Grove\" for an example implementation of \"Data::Grove\".\n",
                "subsections": []
            },
            "METHODS": {
                "content": "",
                "subsections": [
                    {
                        "name": "new",
                        "content": "Return a new object blessed into the SubClass, with the given properties. PROPERTIES may\neither be a list of key/value pairs, a single hash containing key/value pairs, or an\nexisting \"Data::Grove\" object. If an existing \"Data::Grove\" is passed to `\"new()\"', a\nshallow copy of that object will be returned. A shallow copy means that you are returned a\nnew object, but all of the objects underneath still refer to the original objects.\n"
                    }
                ]
            },
            "AUTHOR": {
                "content": "Ken MacLeod, ken@bitsko.slc.ut.us\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "",
                "subsections": [
                    {
                        "name": "perl",
                        "content": ""
                    }
                ]
            }
        }
    }
}