{
    "content": [
        {
            "type": "text",
            "text": "# cp (perldoc)\n\n## Sections\n\n- **Found in /usr/share/perl/5.34/pod/perlfaq2.pod**\n- **Found in /usr/share/perl/5.34/pod/perlfaq3.pod**\n- **Found in /usr/share/perl/5.34/pod/perlfaq7.pod**\n- **Found in /usr/share/perl/5.34/pod/perlfaq8.pod**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "cp",
        "section": "-q",
        "mode": "perldoc",
        "summary": null,
        "synopsis": null,
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "Found in /usr/share/perl/5.34/pod/perlfaq2.pod",
                "lines": 50,
                "subsections": []
            },
            {
                "name": "Found in /usr/share/perl/5.34/pod/perlfaq3.pod",
                "lines": 12,
                "subsections": []
            },
            {
                "name": "Found in /usr/share/perl/5.34/pod/perlfaq7.pod",
                "lines": 23,
                "subsections": []
            },
            {
                "name": "Found in /usr/share/perl/5.34/pod/perlfaq8.pod",
                "lines": 57,
                "subsections": []
            }
        ],
        "sections": {
            "Found in /usr/share/perl/5.34/pod/perlfaq2.pod": {
                "content": "What modules and extensions are available for Perl? What is CPAN?\nCPAN stands for Comprehensive Perl Archive Network, a multi-gigabyte\narchive replicated on hundreds of machines all over the world. CPAN\ncontains tens of thousands of modules and extensions, source code and\ndocumentation, designed for *everything* from commercial database\ninterfaces to keyboard/screen control and running large web sites.\n\nYou can search CPAN on <http://metacpan.org>.\n\nThe master web site for CPAN is <http://www.cpan.org/>,\n<http://www.cpan.org/SITES.html> lists all mirrors.\n\nSee the CPAN FAQ at <http://www.cpan.org/misc/cpan-faq.html> for answers\nto the most frequently asked questions about CPAN.\n\nThe Task::Kensho module has a list of recommended modules which you\nshould review as a good starting point.\n\nWhat is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?\nPerl.com <http://www.perl.com/> used to be part of the O'Reilly Network,\na subsidiary of O'Reilly Media. Although it retains most of the original\ncontent from its O'Reilly Network, it is now hosted by The Perl\nFoundation <http://www.perlfoundation.org/>.\n\nThe Perl Foundation is an advocacy organization for the Perl language\nwhich maintains the web site <http://www.perl.org/> as a general\nadvocacy site for the Perl language. It uses the domain to provide\ngeneral support services to the Perl community, including the hosting of\nmailing lists, web sites, and other services. There are also many other\nsub-domains for special topics like learning Perl and jobs in Perl, such\nas:\n\n*   <http://www.perl.org/>\n\n*   <http://learn.perl.org/>\n\n*   <http://jobs.perl.org/>\n\n*   <http://lists.perl.org/>\n\nPerl Mongers <http://www.pm.org/> uses the pm.org domain for services\nrelated to local Perl user groups, including the hosting of mailing\nlists and web sites. See the Perl Mongers web site <http://www.pm.org/>\nfor more information about joining, starting, or requesting services for\na Perl user group.\n\nCPAN, or the Comprehensive Perl Archive Network <http://www.cpan.org/>,\nis a replicated, worldwide repository of Perl software. See What is\nCPAN?.\n",
                "subsections": []
            },
            "Found in /usr/share/perl/5.34/pod/perlfaq3.pod": {
                "content": "Where can I get perl-mode or cperl-mode for emacs?\nSince Emacs version 19 patchlevel 22 or so, there have been both a\nperl-mode.el and support for the Perl debugger built in. These should\ncome with the standard Emacs 19 distribution.\n\nNote that the perl-mode of emacs will have fits with \"main'foo\" (single\nquote), and mess up the indentation and highlighting. You are probably\nusing \"main::foo\" in new Perl code anyway, so this shouldn't be an\nissue.\n\nFor CPerlMode, see <http://www.emacswiki.org/cgi-bin/wiki/CPerlMode>\n",
                "subsections": []
            },
            "Found in /usr/share/perl/5.34/pod/perlfaq7.pod": {
                "content": "How do I adopt or take over a module already on CPAN?\nAsk the current maintainer to make you a co-maintainer or transfer the\nmodule to you.\n\nIf you can not reach the author for some reason contact the PAUSE admins\nat modules@perl.org who may be able to help, but each case is treated\nseparately.\n\n*   Get a login for the Perl Authors Upload Server (PAUSE) if you don't\nalready have one: <http://pause.perl.org>\n\n*   Write to modules@perl.org explaining what you did to contact the\ncurrent maintainer. The PAUSE admins will also try to reach the\nmaintainer.\n\n*   Post a public message in a heavily trafficked site announcing your\nintention to take over the module.\n\n*   Wait a bit. The PAUSE admins don't want to act too quickly in case\nthe current maintainer is on holiday. If there's no response to\nprivate communication or the public post, a PAUSE admin can transfer\nit to you.\n",
                "subsections": []
            },
            "Found in /usr/share/perl/5.34/pod/perlfaq8.pod": {
                "content": "How do I set CPU limits?\n(contributed by Xho)\n\nUse the BSD::Resource module from CPAN. As an example:\n\nuse BSD::Resource;\nsetrlimit(RLIMITCPU,10,20) or die $!;\n\nThis sets the soft and hard limits to 10 and 20 seconds, respectively.\nAfter 10 seconds of time spent running on the CPU (not \"wall\" time), the\nprocess will be sent a signal (XCPU on some systems) which, if not\ntrapped, will cause the process to terminate. If that signal is trapped,\nthen after 10 more seconds (20 seconds in total) the process will be\nkilled with a non-trappable signal.\n\nSee the BSD::Resource and your systems documentation for the gory\ndetails.\n\nHow do I install a module from CPAN?\n(contributed by brian d foy)\n\nThe easiest way is to have a module also named CPAN do it for you by\nusing the \"cpan\" command that comes with Perl. You can give it a list of\nmodules to install:\n\n$ cpan IO::Interactive Getopt::Whatever\n\nIf you prefer \"CPANPLUS\", it's just as easy:\n\n$ cpanp i IO::Interactive Getopt::Whatever\n\nIf you want to install a distribution from the current directory, you\ncan tell \"CPAN.pm\" to install \".\" (the full stop):\n\n$ cpan .\n\nSee the documentation for either of those commands to see what else you\ncan do.\n\nIf you want to try to install a distribution by yourself, resolving all\ndependencies on your own, you follow one of two possible build paths.\n\nFor distributions that use *Makefile.PL*:\n\n$ perl Makefile.PL\n$ make test install\n\nFor distributions that use *Build.PL*:\n\n$ perl Build.PL\n$ ./Build test\n$ ./Build install\n\nSome distributions may need to link to libraries or other third-party\ncode and their build and installation sequences may be more complicated.\nCheck any *README* or *INSTALL* files that you may find.\n",
                "subsections": []
            }
        }
    }
}