Commit 2645ee47f908d0f58da6e3152a2b2f8e3915bcd0 - libpod-parser-perl

+13

-0

CHANGES less more

1	1
2	2	Before using this for any _new_ software, please consider using Pod::Simple,
3	3	it is a modern replacement for this module.
	4
	5	21-May-2022 Marek Rouchal <marekr@cpan.org>
	6	-----------------------------------------------------------------------------
	7	Version 1.65
	8	+ fix CPAN#124881 - warning from Pod::PlainText
	9	+ fix CPAN#125860 - fix version where Pod::Parser was removed from core
	10
	11
	12	21-May-2022 Marek Rouchal <marekr@cpan.org>
	13	-----------------------------------------------------------------------------
	14	Version 1.64
	15	+ fix CPAN#112113: link to Pod::Simple not working
	16
4	17
5	18	10-Feb-2015 Marek Rouchal <marekr@cpan.org>
6	19	-----------------------------------------------------------------------------

+55

-54

MANIFEST less more

0		ANNOUNCE -- announcement of end of support for this package
1		CHANGES -- Change history
2		README -- Main information file
3		MANIFEST -- This shipping list
4		TODO -- Tentative "to do" list for future development
5		Makefile.PL -- Perl Makefile template
6
7		lib/Pod/InputObjects.pm -- Input objects for Pod::Parser
8		lib/Pod/Parser.pm -- The Pod::Parser module source
9		lib/Pod/ParseUtils.pm -- The Pod::ParseUtils module source
10		lib/Pod/Select.pm -- The Pod::Select module source
11		lib/Pod/PlainText.pm -- The Pod::PlainText module source
12		lib/Pod/Find.pm -- The Pod::Find module source
13
14		scripts/podselect.PL -- Script to print selected sections of pod docs in raw
15		pod format (a command-line interface to podselect()).
16
17		t/pod/testcmp.pl -- module used to compare output against expected results
18		t/pod/testp2pt.pl -- module used to test Pod::PlainText for a given file
19		t/pod/testpchk.pl -- module used to test Pod::Checker for a given file
20		t/pod/empty.xr -- expected result for selfcheck (empty file)
21		t/pod/emptycmd.t -- test-input file for an empty pod directive
22		t/pod/emptycmd.xr -- expected result from processing emptycmd.t
23		t/pod/contains_pod.t -- test for Pod::Find::contains_pod
24		t/pod/contains_pod.xr -- test file
25		t/pod/find.t -- test for Pod::Find
26		t/pod/for.t -- test-input file for =for directives
27		t/pod/for.xr -- expected result from processing for.t
28		t/pod/headings.t -- test-input file for =head directives
29		t/pod/headings.xr -- expected result from processing headings.t
30		t/pod/include.t -- test-input file for an =included file
31		t/pod/include.xr -- expected result from processing include.t
32		t/pod/included.t -- test-input file for =including another file
33		t/pod/included.xr -- expected result from processing included.t
34		t/pod/lref.t -- test-input file for L<...> sequences
35		t/pod/lref.xr -- expected result from processing lref.t
36		t/pod/multiline_items.t -- test-input file for multiline =items
37		t/pod/multiline_items.xr -- expected result from processing multiline_items.t
38		t/pod/nested_items.t -- test-input file for nested =items
39		t/pod/nested_items.xr -- expected result from processing nested_items.t
40		t/pod/nested_seqs.t -- test-input file for nested interior sequences
41		t/pod/nested_seqs.xr -- expected result from processing nested_seqs.t
42		t/pod/oneline_cmds.t -- test-input file for ==cmds
43		t/pod/oneline_cmds.xr -- expected result from processing oneline_cmds.t
44		t/pod/podselect.t -- test input file for processing podselect.PL
45		t/pod/podselect.xr -- expected result from processing podselect.PL
46		t/pod/selfcheck.t -- run our own POD through podchecker
47		t/pod/special_seqs.t -- test-input file for "special" interior sequences
48		t/pod/special_seqs.xr -- expected result from processing special_seqs.t
49		t/pod/twice.t -- make sure Pod::Parser is re-entrant
50		t/pod/testpods/lib/Pod/Stuff.pm -- test POD for t/pod/find.t
51		t/pod/contains_bad_pod.xr -- expected results
52
53		META.yml Module meta-data (added by MakeMaker)
	0	ANNOUNCE -- announcement of end of support for this package
	1	CHANGES -- Change history
	2	README -- Main information file
	3	MANIFEST -- This shipping list
	4	TODO -- Tentative "to do" list for future development
	5	Makefile.PL -- Perl Makefile template
	6
	7	lib/Pod/InputObjects.pm -- Input objects for Pod::Parser
	8	lib/Pod/Parser.pm -- The Pod::Parser module source
	9	lib/Pod/ParseUtils.pm -- The Pod::ParseUtils module source
	10	lib/Pod/Select.pm -- The Pod::Select module source
	11	lib/Pod/PlainText.pm -- The Pod::PlainText module source
	12	lib/Pod/Find.pm -- The Pod::Find module source
	13
	14	scripts/podselect.PL -- Script to print selected sections of pod docs in raw
	15	pod format (a command-line interface to podselect()).
	16
	17	t/pod/testcmp.pl -- module used to compare output against expected results
	18	t/pod/testp2pt.pl -- module used to test Pod::PlainText for a given file
	19	t/pod/testpchk.pl -- module used to test Pod::Checker for a given file
	20	t/pod/empty.xr -- expected result for selfcheck (empty file)
	21	t/pod/emptycmd.t -- test-input file for an empty pod directive
	22	t/pod/emptycmd.xr -- expected result from processing emptycmd.t
	23	t/pod/contains_pod.t -- test for Pod::Find::contains_pod
	24	t/pod/contains_pod.xr -- test file
	25	t/pod/find.t -- test for Pod::Find
	26	t/pod/for.t -- test-input file for =for directives
	27	t/pod/for.xr -- expected result from processing for.t
	28	t/pod/headings.t -- test-input file for =head directives
	29	t/pod/headings.xr -- expected result from processing headings.t
	30	t/pod/include.t -- test-input file for an =included file
	31	t/pod/include.xr -- expected result from processing include.t
	32	t/pod/included.t -- test-input file for =including another file
	33	t/pod/included.xr -- expected result from processing included.t
	34	t/pod/lref.t -- test-input file for L<...> sequences
	35	t/pod/lref.xr -- expected result from processing lref.t
	36	t/pod/multiline_items.t -- test-input file for multiline =items
	37	t/pod/multiline_items.xr -- expected result from processing multiline_items.t
	38	t/pod/nested_items.t -- test-input file for nested =items
	39	t/pod/nested_items.xr -- expected result from processing nested_items.t
	40	t/pod/nested_seqs.t -- test-input file for nested interior sequences
	41	t/pod/nested_seqs.xr -- expected result from processing nested_seqs.t
	42	t/pod/oneline_cmds.t -- test-input file for ==cmds
	43	t/pod/oneline_cmds.xr -- expected result from processing oneline_cmds.t
	44	t/pod/podselect.t -- test input file for processing podselect.PL
	45	t/pod/podselect.xr -- expected result from processing podselect.PL
	46	t/pod/selfcheck.t -- run our own POD through podchecker
	47	t/pod/special_seqs.t -- test-input file for "special" interior sequences
	48	t/pod/special_seqs.xr -- expected result from processing special_seqs.t
	49	t/pod/twice.t -- make sure Pod::Parser is re-entrant
	50	t/pod/testpods/lib/Pod/Stuff.pm -- test POD for t/pod/find.t
	51	t/pod/contains_bad_pod.xr -- expected results
	52
	53	META.yml Module meta-data (added by MakeMaker)
	54	META.json Module JSON meta-data (added by MakeMaker)

+44

-0

META.json less more

	0	{
	1	"abstract" : "Modules for parsing/translating POD format documents",
	2	"author" : [
	3	"Brad Appleton <bradapp@enteract.com>, Marek Rouchal <marekr@cpan.org>"
	4	],
	5	"dynamic_config" : 1,
	6	"generated_by" : "ExtUtils::MakeMaker version 7.46, CPAN::Meta::Converter version 2.150010",
	7	"license" : [
	8	"unknown"
	9	],
	10	"meta-spec" : {
	11	"url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
	12	"version" : "2"
	13	},
	14	"name" : "Pod-Parser",
	15	"no_index" : {
	16	"directory" : [
	17	"t",
	18	"inc"
	19	]
	20	},
	21	"prereqs" : {
	22	"build" : {
	23	"requires" : {
	24	"ExtUtils::MakeMaker" : "0"
	25	}
	26	},
	27	"configure" : {
	28	"requires" : {
	29	"ExtUtils::MakeMaker" : "0"
	30	}
	31	},
	32	"runtime" : {
	33	"requires" : {
	34	"Cwd" : "0",
	35	"File::Basename" : "0",
	36	"Test::More" : "0.6"
	37	}
	38	}
	39	},
	40	"release_status" : "stable",
	41	"version" : "1.65",
	42	"x_serialization_backend" : "JSON::PP version 2.27400_02"
	43	}

+22

-21

META.yml less more

0		--- #YAML:1.0
1		name: Pod-Parser
2		version: 1.63
3		abstract: Modules for parsing/translating POD format documents
	0	---
	1	abstract: 'Modules for parsing/translating POD format documents'
4	2	author:
5		- Brad Appleton <bradapp@enteract.com>, Marek Rouchal <marekr@cpan.org>
6		license: unknown
7		distribution_type: module
	3	- 'Brad Appleton <bradapp@enteract.com>, Marek Rouchal <marekr@cpan.org>'
	4	build_requires:
	5	ExtUtils::MakeMaker: '0'
8	6	configure_requires:
9		ExtUtils::MakeMaker: 0
10		build_requires:
11		ExtUtils::MakeMaker: 0
	7	ExtUtils::MakeMaker: '0'
	8	dynamic_config: 1
	9	generated_by: 'ExtUtils::MakeMaker version 7.46, CPAN::Meta::Converter version 2.150010'
	10	license: unknown
	11	meta-spec:
	12	url: http://module-build.sourceforge.net/META-spec-v1.4.html
	13	version: '1.4'
	14	name: Pod-Parser
	15	no_index:
	16	directory:
	17	- t
	18	- inc
12	19	requires:
13		Cwd: 0
14		File::Basename: 0
15		Test::More: 0.6
16		no_index:
17		directory:
18		- t
19		- inc
20		generated_by: ExtUtils::MakeMaker version 6.57_05
21		meta-spec:
22		url: http://module-build.sourceforge.net/META-spec-v1.4.html
23		version: 1.4
	20	Cwd: '0'
	21	File::Basename: '0'
	22	Test::More: '0.6'
	23	version: '1.65'
	24	x_serialization_backend: 'CPAN::Meta::YAML version 0.018'

+1

-1

Makefile.PL less more

68	68	WriteMakefile(
69	69	NAME => $DISTMOD,
70	70	DISTNAME => $DISTNAME,
71		VERSION => '1.63',
	71	VERSION => '1.65',
72	72	INSTALLDIRS => ($] >= 5.006 ? 'perl' : 'site'),
73	73	PL_FILES => { map { (script("$_.PL") => script($_)) } @SCRIPTS },
74	74	EXE_FILES => [ @EXE_FILES ],

+3

-3

lib/Pod/Find.pm less more

13	13	use strict;
14	14
15	15	use vars qw($VERSION);
16		$VERSION = '1.63'; ## Current version of this package
	16	$VERSION = '1.65'; ## Current version of this package
17	17	require 5.005; ## requires this Perl version or later
18	18	use Carp;
19	19

44	44
45	45	=head1 DESCRIPTION
46	46
47		B<NOTE: This module is considered legacy; modern Perl releases (5.18 and
48		higher) are going to remove Pod-Parser from core and use L<Pod-Simple>
	47	B<NOTE: This module is considered legacy; modern Perl releases (5.31.1 and
	48	higher) are going to remove Pod-Parser from core and use L<Pod::Simple>
49	49	for all things POD.>
50	50
51	51	B<Pod::Find> provides a set of functions to locate POD files. Note that

+3

-3

lib/Pod/InputObjects.pm less more

11	11	use strict;
12	12
13	13	use vars qw($VERSION);
14		$VERSION = '1.63'; ## Current version of this package
	14	$VERSION = '1.65'; ## Current version of this package
15	15	require 5.005; ## requires this Perl version or later
16	16
17	17	#############################################################################

34	34
35	35	=head1 DESCRIPTION
36	36
37		B<NOTE: This module is considered legacy; modern Perl releases (5.18 and
38		higher) are going to remove Pod-Parser from core and use L<Pod-Simple>
	37	B<NOTE: This module is considered legacy; modern Perl releases (5.31.1 and
	38	higher) are going to remove Pod-Parser from core and use L<Pod::Simple>
39	39	for all things POD.>
40	40
41	41	This module defines some basic input objects used by B<Pod::Parser> when

+3

-3

lib/Pod/ParseUtils.pm less more

10	10	use strict;
11	11
12	12	use vars qw($VERSION);
13		$VERSION = '1.63'; ## Current version of this package
	13	$VERSION = '1.65'; ## Current version of this package
14	14	require 5.005; ## requires this Perl version or later
15	15
16	16	=head1 NAME

26	26
27	27	=head1 DESCRIPTION
28	28
29		B<NOTE: This module is considered legacy; modern Perl releases (5.18 and
30		higher) are going to remove Pod-Parser from core and use L<Pod-Simple>
	29	B<NOTE: This module is considered legacy; modern Perl releases (5.31.1 and
	30	higher) are going to remove Pod-Parser from core and use L<Pod::Simple>
31	31	for all things POD.>
32	32
33	33	B<Pod::ParseUtils> contains a few object-oriented helper packages for

+3

-3

lib/Pod/Parser.pm less more

11	11
12	12	## These "variables" are used as local "glob aliases" for performance
13	13	use vars qw($VERSION @ISA %myData %myOpts @input_stack);
14		$VERSION = '1.63'; ## Current version of this package
	14	$VERSION = '1.65'; ## Current version of this package
15	15	require 5.005; ## requires this Perl version or later
16	16
17	17	#############################################################################

80	80
81	81	=head1 DESCRIPTION
82	82
83		B<NOTE: This module is considered legacy; modern Perl releases (5.18 and
84		higher) are going to remove Pod-Parser from core and use L<Pod-Simple>
	83	B<NOTE: This module is considered legacy; modern Perl releases (5.31.1 and
	84	higher) are going to remove Pod-Parser from core and use L<Pod::Simple>
85	85	for all things POD.>
86	86
87	87	B<Pod::Parser> is a base class for creating POD filters and translators.

+3

-3

lib/Pod/PlainText.pm less more

491	491	$output =~ s/[\r\n]*$/\n/;
492	492	$self->output ($output);
493	493	$$self{MARGIN} = $margin;
494		$self->output ($self->reformat ($_)) if /\S/;
	494	$self->output ($self->reformat ($_)) if defined && /\S/;
495	495	} else {
496	496	$_ = $self->reformat ($_);
497	497	s/^ /:/ if ($$self{alt} && $indent > 0);

620	620
621	621	=head1 DESCRIPTION
622	622
623		B<NOTE: This module is considered legacy; modern Perl releases (5.18 and
624		higher) are going to remove Pod-Parser from core and use L<Pod-Simple>
	623	B<NOTE: This module is considered legacy; modern Perl releases (5.31.1 and
	624	higher) are going to remove Pod-Parser from core and use L<Pod::Simple>
625	625	for all things POD.>
626	626
627	627	Pod::PlainText is a module that can convert documentation in the POD format (the

+3

-3

lib/Pod/Select.pm less more

10	10	use strict;
11	11
12	12	use vars qw($VERSION @ISA @EXPORT $MAX_HEADING_LEVEL %myData @section_headings @selected_sections);
13		$VERSION = '1.63'; ## Current version of this package
	13	$VERSION = '1.65'; ## Current version of this package
14	14	require 5.005; ## requires this Perl version or later
15	15
16	16	#############################################################################

70	70
71	71	=head1 DESCRIPTION
72	72
73		B<NOTE: This module is considered legacy; modern Perl releases (5.18 and
74		higher) are going to remove Pod-Parser from core and use L<Pod-Simple>
	73	B<NOTE: This module is considered legacy; modern Perl releases (5.31.1 and
	74	higher) are going to remove Pod-Parser from core and use L<Pod::Simple>
75	75	for all things POD.>
76	76
77	77	B<podselect()> is a function which will extract specified sections of

+6

-0

t/pod/multiline_items.t less more

25	25	a
26	26	test.
27	27
	28	=item Example with only verbatim content
	29
	30	{
	31	"json": "stuff"
	32	}
	33
28	34	=back
29	35
30	36	=cut

+9

-5

t/pod/multiline_items.xr less more

0		Test multiline item lists
1		This is a test to ensure that multiline =item paragraphs get indented
2		appropriately.
	0	Test multiline item lists
	1	This is a test to ensure that multiline =item paragraphs get indented
	2	appropriately.
	3
	4	This is a test.
	5	Example with only verbatim content
	6	{
	7	"json": "stuff"
	8	}
3	9
4		This is a test.
5