Skip to content

Commit 3051aba

Browse files
TuxTux
committed
Improved static doc generation
1 parent fb95697 commit 3051aba

14 files changed

+652
-179
lines changed

‎ChangeLog

+2-1
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
1-
0.61 - 2024-12-31, H.Merijn Brand
1+
0.61 - 2025-01-13, H.Merijn Brand
22
* Replace "use vars" with "our" (James Raspass: PR #9)
33
* Specify recommended versions based on known CVE's
44
* Update doc for groff-1.24
55
* It's 2024
66
* Tested with perl-5.40.0
7+
* It's 2025
78

89
0.60 - 2023-01-06, H.Merijn Brand
910
* It's 2023

‎Makefile.PL

+4-8
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# -*- perl -*-
22

3-
# Copyright (c) 2009-2024 H.Merijn Brand
3+
# Copyright (c) 2009-2025 H.Merijn Brand
44

55
require 5.008001;
66

@@ -162,12 +162,8 @@ sub postamble {
162162
'doc docs: doc/DBD-CSV.md doc/DBD-CSV.html doc/DBD-CSV.man',
163163
' -@rm -f pod2html.tmp',
164164
'doc/DBD-CSV.md: lib/DBD/CSV.pm',
165-
' pod2markdown < $? > $@',
166-
'doc/DBD-CSV.html: lib/DBD/CSV.pm',
167-
' pod2html < $? 2>&1 | grep -v "^Cannot find" > $@',
168-
'doc/DBD-CSV.3: lib/DBD/CSV.pm',
169-
' pod2man < $? > $@',
170-
'doc/DBD-CSV.man: doc/DBD-CSV.3',
171-
' nroff2man < $? > $@',
165+
' perl doc/make-doc.pl',
166+
'test::',
167+
' perl doc/make-doc.pl',
172168
$min_vsn;
173169
} # postamble

‎README

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Description
99
values).
1010

1111
Copying
12-
Copyright (C) 2009-2024 by H.Merijn Brand
12+
Copyright (C) 2009-2025 by H.Merijn Brand
1313
Copyright (C) 2004-2009 by Jeff Zucker
1414
Copyright (C) 1998-2004 by Jochen Wiedmann
1515

‎doc/Bundle-DBD-CSV.3

+105
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
.\" -*- mode: troff; coding: utf-8 -*-
2+
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3+
.\"
4+
.\" Standard preamble:
5+
.\" ========================================================================
6+
.de Sp \" Vertical space (when we can't use .PP)
7+
.if t .sp .5v
8+
.if n .sp
9+
..
10+
.de Vb \" Begin verbatim text
11+
.ft CW
12+
.nf
13+
.ne \\$1
14+
..
15+
.de Ve \" End verbatim text
16+
.ft R
17+
.fi
18+
..
19+
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20+
.ie n \{\
21+
. ds C` ""
22+
. ds C' ""
23+
'br\}
24+
.el\{\
25+
. ds C`
26+
. ds C'
27+
'br\}
28+
.\"
29+
.\" Escape single quotes in literal strings from groff's Unicode transform.
30+
.ie \n(.g .ds Aq \(aq
31+
.el .ds Aq '
32+
.\"
33+
.\" If the F register is >0, we'll generate index entries on stderr for
34+
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35+
.\" entries marked with X<> in POD. Of course, you'll have to process the
36+
.\" output yourself in some meaningful fashion.
37+
.\"
38+
.\" Avoid warning from groff about undefined register 'F'.
39+
.de IX
40+
..
41+
.nr rF 0
42+
.if \n(.g .if rF .nr rF 1
43+
.if (\n(rF:(\n(.g==0)) \{\
44+
. if \nF \{\
45+
. de IX
46+
. tm Index:\\$1\t\\n%\t"\\$2"
47+
..
48+
. if !\nF==2 \{\
49+
. nr % 0
50+
. nr F 2
51+
. \}
52+
. \}
53+
.\}
54+
.rr rF
55+
.\"
56+
.\" Required to disable full justification in groff 1.23.0.
57+
.if n .ds AD l
58+
.\" ========================================================================
59+
.\"
60+
.IX Title "Bundle::DBD::CSV 3"
61+
.TH Bundle::DBD::CSV 3 2025-01-13 "perl v5.40.0" "User Contributed Perl Documentation"
62+
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
63+
.\" way too many mistakes in technical documents.
64+
.if n .ad l
65+
.nh
66+
.SH NAME
67+
Bundle::DBD::CSV \- A bundle to install the DBD::CSV driver
68+
.SH SYNOPSIS
69+
.IX Header "SYNOPSIS"
70+
.Vb 1
71+
\& perl \-MCPAN \-e \*(Aqinstall Bundle::DBD::CSV\*(Aq
72+
.Ve
73+
.SH CONTENTS
74+
.IX Header "CONTENTS"
75+
DBI 1.645
76+
.PP
77+
Text::CSV_XS 1.59
78+
.PP
79+
SQL::Statement 1.414
80+
.PP
81+
DBD::File 0.44
82+
.PP
83+
DBD::CSV 0.61
84+
.SH DESCRIPTION
85+
.IX Header "DESCRIPTION"
86+
This bundle includes all that\*(Aqs needed to access so\-called CSV (Comma
87+
Separated Values) files via a pseudo SQL engine (SQL::Statement) and DBI.
88+
.SH AUTHOR
89+
.IX Header "AUTHOR"
90+
This module is currently maintained by
91+
.PP
92+
.Vb 1
93+
\& H.Merijn Brand <[email protected]>
94+
.Ve
95+
.SH "COPYRIGHT AND LICENSE"
96+
.IX Header "COPYRIGHT AND LICENSE"
97+
Copyright (C) 2009\-2025 by H.Merijn Brand
98+
Copyright (C) 2004\-2009 by Jeff Zucker
99+
Copyright (C) 1998\-2004 by Jochen Wiedmann
100+
.PP
101+
All rights reserved.
102+
.PP
103+
You may distribute this module under the terms of either the GNU
104+
General Public License or the Artistic License, as specified in
105+
the Perl README file.

‎doc/Bundle-DBD-CSV.html

+64
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
<?xml version="1.0" ?>
2+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3+
<html xmlns="http://www.w3.org/1999/xhtml">
4+
<head>
5+
<title>Bundle::DBD::CSV - A bundle to install the DBD::CSV driver</title>
6+
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
7+
<link rev="made" href="mailto:[email protected]" />
8+
</head>
9+
10+
<body>
11+
12+
13+
14+
<ul id="index">
15+
<li><a href="#NAME">NAME</a></li>
16+
<li><a href="#SYNOPSIS">SYNOPSIS</a></li>
17+
<li><a href="#CONTENTS">CONTENTS</a></li>
18+
<li><a href="#DESCRIPTION">DESCRIPTION</a></li>
19+
<li><a href="#AUTHOR">AUTHOR</a></li>
20+
<li><a href="#COPYRIGHT-AND-LICENSE">COPYRIGHT AND LICENSE</a></li>
21+
</ul>
22+
23+
<h1 id="NAME">NAME</h1>
24+
25+
<p>Bundle::DBD::CSV - A bundle to install the DBD::CSV driver</p>
26+
27+
<h1 id="SYNOPSIS">SYNOPSIS</h1>
28+
29+
<pre><code>perl -MCPAN -e &#39;install Bundle::DBD::CSV&#39;</code></pre>
30+
31+
<h1 id="CONTENTS">CONTENTS</h1>
32+
33+
<p>DBI 1.645</p>
34+
35+
<p>Text::CSV_XS 1.59</p>
36+
37+
<p>SQL::Statement 1.414</p>
38+
39+
<p>DBD::File 0.44</p>
40+
41+
<p>DBD::CSV 0.61</p>
42+
43+
<h1 id="DESCRIPTION">DESCRIPTION</h1>
44+
45+
<p>This bundle includes all that&#39;s needed to access so-called CSV (Comma Separated Values) files via a pseudo SQL engine (SQL::Statement) and DBI.</p>
46+
47+
<h1 id="AUTHOR">AUTHOR</h1>
48+
49+
<p>This module is currently maintained by</p>
50+
51+
<pre><code>H.Merijn Brand &lt;[email protected]&gt;</code></pre>
52+
53+
<h1 id="COPYRIGHT-AND-LICENSE">COPYRIGHT AND LICENSE</h1>
54+
55+
<p>Copyright (C) 2009-2025 by H.Merijn Brand Copyright (C) 2004-2009 by Jeff Zucker Copyright (C) 1998-2004 by Jochen Wiedmann</p>
56+
57+
<p>All rights reserved.</p>
58+
59+
<p>You may distribute this module under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl README file.</p>
60+
61+
62+
</body>
63+
64+
</html>

‎doc/Bundle-DBD-CSV.man

+40
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
Bundle::DBD::CSV(3) User Contributed Perl Documentation Bundle::DBD::CSV(3)
2+
3+
NAME
4+
Bundle::DBD::CSV - A bundle to install the DBD::CSV driver
5+
6+
SYNOPSIS
7+
perl -MCPAN -e 'install Bundle::DBD::CSV'
8+
9+
CONTENTS
10+
DBI 1.645
11+
12+
Text::CSV_XS 1.59
13+
14+
SQL::Statement 1.414
15+
16+
DBD::File 0.44
17+
18+
DBD::CSV 0.61
19+
20+
DESCRIPTION
21+
This bundle includes all that's needed to access so-called CSV (Comma
22+
Separated Values) files via a pseudo SQL engine (SQL::Statement) and
23+
DBI.
24+
25+
AUTHOR
26+
This module is currently maintained by
27+
28+
H.Merijn Brand <[email protected]>
29+
30+
COPYRIGHT AND LICENSE
31+
Copyright (C) 2009-2025 by H.Merijn Brand Copyright (C) 2004-2009 by
32+
Jeff Zucker Copyright (C) 1998-2004 by Jochen Wiedmann
33+
34+
All rights reserved.
35+
36+
You may distribute this module under the terms of either the GNU
37+
General Public License or the Artistic License, as specified in the
38+
Perl README file.
39+
40+
perl v5.40.0 2025-01-13 Bundle::DBD::CSV(3)

‎doc/Bundle-DBD-CSV.md

+42
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# NAME
2+
3+
Bundle::DBD::CSV - A bundle to install the DBD::CSV driver
4+
5+
# SYNOPSIS
6+
7+
perl -MCPAN -e 'install Bundle::DBD::CSV'
8+
9+
# CONTENTS
10+
11+
DBI 1.645
12+
13+
Text::CSV\_XS 1.59
14+
15+
SQL::Statement 1.414
16+
17+
DBD::File 0.44
18+
19+
DBD::CSV 0.61
20+
21+
# DESCRIPTION
22+
23+
This bundle includes all that's needed to access so-called CSV (Comma
24+
Separated Values) files via a pseudo SQL engine (SQL::Statement) and DBI.
25+
26+
# AUTHOR
27+
28+
This module is currently maintained by
29+
30+
H.Merijn Brand <[email protected]>
31+
32+
# COPYRIGHT AND LICENSE
33+
34+
Copyright (C) 2009-2025 by H.Merijn Brand
35+
Copyright (C) 2004-2009 by Jeff Zucker
36+
Copyright (C) 1998-2004 by Jochen Wiedmann
37+
38+
All rights reserved.
39+
40+
You may distribute this module under the terms of either the GNU
41+
General Public License or the Artistic License, as specified in
42+
the Perl README file.

0 commit comments

Comments
 (0)