Revert "Update description and other documentation"

Author: tbrowder

Changes

@@ -1,15 +1,6 @@
 Revision history for Pod-TreeWalker
 
 {{$NEXT}}
-    - Enabled creation of a separate document for the Listener
-      role from existing pod in file 
-        'lib/Pod/TreeWalker/Listener.rakumod'.
-    - Updated copyright date in file
-        'lib/Pod/TreeWalker/Listener.rakumod'.
-    - Added a short example of actual use along with other
-        README.md tweaks.
-    - Added missing dep 'Test::Coverage' to META6.json
-    - Adjusted Test::Coverage numbers in xt/
 
 0.0.5  2025-05-06T11:02:12+02:00
     - Changed trait 'is built' to 'is required' on the Listener

Listener.md

@@ -23,7 +23,6 @@
     "TREE"
   ],
   "test-depends": [
-    "Test::Coverage"
   ],
   "version": "0.0.5"
 }

META6.json

@@ -11,38 +11,35 @@ SYNOPSIS
 ```raku
 use Pod::TreeWalker;
 
-my $L = My::Listener.new;
-my $o = Pod::TreeWalker.new: :listener($L);
-my @events = $o.walk-pod($=pod);
+my $to-html = Pod::To::HTML.new(...);
+Pod::TreeWalker.new( :listener($to-html) ).walk-pod($=pod);
 ```
 
 DESCRIPTION
 ===========
 
 This class provides an API for walking a pod tree (as provided by `$=pod`). Each node in the tree will trigger one or more events. These events cause methods to be called on a listener object that you provide. This lets you do something with a Pod document without having to know much about the underlying tree structure of Pod.
 
-Note: Use distribution `Pod::Load` for an easy way to access the Pod from a file or a string.
-
 METHODS
 =======
 
 new
 ---
 
 ```raku
-my $walker = Pod::TreeWalker.new: :listener($object);
+my $walker = Pod::TreeWalker.new( :listener($object) )
 ```
 
-The constructor requires a single named argument `:listener`. This object must implement the `Pod::TreeWalker::Listener` API as demonstrated in file './t/lib/TestListener.rakumod'. See more details in **Listener.md**.
+The constructor requires a single named argument `:listener`. This object must implement the [Pod::TreeWalker::Listener](./t/lib/TestListener.rakumod) API as demonstrated in file './t/lib/TestListener.rakumod'.
 
 walk-pod
 --------
 
 ```raku
-my @events = $walker.walk-pod($pod);
+$walker.walk-pod($pod);
 ```
 
-This method walks through a pod tree starting with the top node in `$pod`. You can provide either an array of pod nodes (as stored in `$=pod`) or a single top-level node (such as `$=pod[0]`). The `@events` list provides the details of each pod node encountered.
+This method walks through a pod tree starting with the top node in `$pod`. You can provide either an array of pod nodes (as stored in `$=pod`) or a single top-level node (such as `$=pod[0]`).
 
 text-content-of
 ---------------

README.md

@@ -15,6 +15,3 @@ filename = doc/Pod-TreeWalker.rakudoc
 provider = github-actions/linux.yml
 provider = github-actions/macos.yml
 provider = github-actions/windows.yml
-
-[RunAfterBuild]
-cmd = raku --doc=Markdown lib/Pod/TreeWalker/Listener.rakumod > Listener.md

dist.ini

@@ -10,9 +10,8 @@ Pod::TreeWalker - Walk a Pod tree and generate an event for each node
 
 use Pod::TreeWalker;
 
-my $L = My::Listener.new;
-my $o = Pod::TreeWalker.new: :listener($L);
-my @events = $o.walk-pod($=pod);
+my $to-html = Pod::To::HTML.new(...);
+Pod::TreeWalker.new( :listener($to-html) ).walk-pod($=pod);
 
 =end code
 
@@ -24,36 +23,31 @@ cause methods to be called on a listener object that you provide. This lets
 you do something with a Pod document without having to know much about the
 underlying tree structure of Pod.
 
-Note: Use distribution C<Pod::Load> for an easy way to access the Pod
-from a file or a string.
-
 =head1 METHODS
 
 =head2 new
 
 =begin code :lang<raku>
 
-my $walker = Pod::TreeWalker.new: :listener($object);
+my $walker = Pod::TreeWalker.new( :listener($object) )
 
 =end code
 
 The constructor requires a single named argument C<:listener>. This object must
-implement the C<Pod::TreeWalker::Listener> API
+implement the L<Pod::TreeWalker::Listener|./t/lib/TestListener.rakumod> API
 as demonstrated in file './t/lib/TestListener.rakumod'.
-See more details in B<Listener.md>.
 
 =head2 walk-pod
 
 =begin code :lang<raku>
 
-my @events = $walker.walk-pod($pod);
+$walker.walk-pod($pod);
 
 =end code
 
 This method walks through a pod tree starting with the top node in
 C<$pod>. You can provide either an array of pod nodes (as stored in C<$=pod>)
 or a single top-level node (such as C<$=pod[0]>).
-The C<@events> list provides the details of each pod node encountered.
 
 =head2 text-content-of
 

doc/Pod-TreeWalker.rakudoc

@@ -142,7 +142,7 @@ Dave Rolsky
 
 Copyright 2015 - 2018 Dave Rolsky
 
-Copyright 2019 - 2025 Raku Community
+Copyright 2019 - 2022 Raku Community
 
 This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.
 

lib/Pod/TreeWalker/Listener.rakumod

@@ -2,9 +2,9 @@ use Test::Coverage;
 
 plan 2;
 
-coverage-at-least 80;
+coverage-at-least 81;
 
-uncovered-at-most 15;
+uncovered-at-most 14;
 
 source-with-coverage;