texlive[59225] Master/tlpkg/TeXLive: pod-isms

[commits+karl at tug.org]

Revision: 59225
          http://tug.org/svn/texlive?view=revision&revision=59225
Author:   karl
Date:     2021-05-16 19:41:12 +0200 (Sun, 16 May 2021)
Log Message:
-----------
pod-isms

Modified Paths:
--------------
    trunk/Master/tlpkg/TeXLive/TLConfig.pm
    trunk/Master/tlpkg/TeXLive/TLPDB.pm
    trunk/Master/tlpkg/TeXLive/TLTREE.pm
    trunk/Master/tlpkg/TeXLive/TLWinGoo.pm
    trunk/Master/tlpkg/TeXLive/TeXCatalogue.pm

Modified: trunk/Master/tlpkg/TeXLive/TLConfig.pm
===================================================================
--- trunk/Master/tlpkg/TeXLive/TLConfig.pm	2021-05-16 16:50:31 UTC (rev 59224)
+++ trunk/Master/tlpkg/TeXLive/TLConfig.pm	2021-05-16 17:41:12 UTC (rev 59225)
@@ -288,13 +288,13 @@
 The L<TeXLive::TLConfig> module contains definitions of variables 
 configuring all of TeX Live.
 
-=over 4
+=head2 EXPORTED VARIABLES
 
-=head1 EXPORTED VARIABLES
-
 All of the following variables are pulled into the callers namespace,
 i.e., are declared with C<EXPORT> (and C<EXPORT_OK>).
 
+=over 4
+
 =item C<@TeXLive::TLConfig::MetaCategories>
 
 The list of meta categories, i.e., those categories whose packages only

Modified: trunk/Master/tlpkg/TeXLive/TLPDB.pm
===================================================================
--- trunk/Master/tlpkg/TeXLive/TLPDB.pm	2021-05-16 16:50:31 UTC (rev 59224)
+++ trunk/Master/tlpkg/TeXLive/TLPDB.pm	2021-05-16 17:41:12 UTC (rev 59225)
@@ -14,7 +14,7 @@
 
 =head1 NAME
 
-C<TeXLive::TLPDB> -- TeX Live Package Database module
+C<TeXLive::TLPDB> -- TeX Live Package Database (C<texlive.tlpdb>) module
 
 =head1 SYNOPSIS
 

Modified: trunk/Master/tlpkg/TeXLive/TLTREE.pm
===================================================================
--- trunk/Master/tlpkg/TeXLive/TLTREE.pm	2021-05-16 16:50:31 UTC (rev 59224)
+++ trunk/Master/tlpkg/TeXLive/TLTREE.pm	2021-05-16 17:41:12 UTC (rev 59225)
@@ -10,6 +10,24 @@
 my $_modulerevision = ($svnrev =~ m/: ([0-9]+) /) ? $1 : "unknown";
 sub module_revision { return $_modulerevision; }
 
+=pod
+
+=head1 NAME
+
+C<TeXLive::TLTREE> -- TeX Live tree of all files
+
+=head1 SYNOPSIS
+
+  use TeXLive::TLTREE;
+  TeXLive::TLTREE->new ();
+  ...
+
+=head1 DESCRIPTION
+
+DOCUMENTATION MISSING, SORRY!!!
+
+=cut
+
 use TeXLive::TLUtils;
 
 sub new {
@@ -534,19 +552,6 @@
 
 1;
 
-=head1 NAME
-
-C<TeXLive::TREE> -- TeX Live tree of all files
-
-=head1 SYNOPSIS
-
-  use TeXLive::TREE;
-  TeXLive::TREE->new ();
-
-=head1 DESCRIPTION
-
-Sorry, haven't written documentation for this one yet.
-
 =head1 SEE ALSO
 
 The modules L<TeXLive::TLPSRC>, L<TeXLive::TLPOBJ>, L<TeXLive::TLPDB>,

Modified: trunk/Master/tlpkg/TeXLive/TLWinGoo.pm
===================================================================
--- trunk/Master/tlpkg/TeXLive/TLWinGoo.pm	2021-05-16 16:50:31 UTC (rev 59224)
+++ trunk/Master/tlpkg/TeXLive/TLWinGoo.pm	2021-05-16 17:41:12 UTC (rev 59225)
@@ -78,7 +78,7 @@
 
 All exported functions return forward slashes.
 
-=head2 DESCRIPTION
+=head1 DESCRIPTION
 
 =over 4
 
@@ -1318,6 +1318,12 @@
 
 =pod
 
+=back
+
+=head2 ADMIN
+
+=over 4
+
 =item C<TeXLive::TLWinGoo::maybe_make_ro($dir)>
 
 Write-protects a directory $dir recursively, using ACLs, but only if
@@ -1325,6 +1331,8 @@
 NTFS-formatted local fixed disk, and only on Windows Vista and
 later.  It writes a log message what it does and why.
 
+=back
+
 =cut
 
 sub maybe_make_ro {

Modified: trunk/Master/tlpkg/TeXLive/TeXCatalogue.pm
===================================================================
--- trunk/Master/tlpkg/TeXLive/TeXCatalogue.pm	2021-05-16 16:50:31 UTC (rev 59224)
+++ trunk/Master/tlpkg/TeXLive/TeXCatalogue.pm	2021-05-16 17:41:12 UTC (rev 59225)
@@ -21,12 +21,8 @@
 
 =head1 NAME
 
-TeXLive::TeXCatalogue - TeX Live access to the TeX Catalogue fromCTAN
+C<TeXLive::TeXCatalogue> - TeX Live access to the TeX Catalogue from CTAN
 
-=head1 SYNOPSIS
-
-missing
-
 =head1 DESCRIPTION
 
 The L<TeXLive::TeXCatalogue> module provides access to the data stored