info > B::Hooks::EndOfScope::XS

man perldoc info pydoc3 ri search

The user wants me to transform a Perl man page HTML into an emoji-rich, visually scannable version. Let me analyze the content: This is a man page for `B::Hooks::EndOfScope::XS` - a Perl module. Let me identify the sections: - NAME (with H1 title already) - VERSION - DESCRIPTION - FUNCTIONS (with sub-section on_scope_end) - SUPPORT - AUTHORS - COPYRIGHT AND LICENCE I need to: 1. Start with 🚀 Quick Reference as the second section (after NAME) 2. Use proper HTML tags 3. Escape < and > where needed (in the SUPPORT section, the `` tags need escaping) 4. Wrap code in

 blocks
5. Preserve all original information
6. Use emojis to enhance scannability
7. Keep the heading hierarchy intact

Let me identify what needs to be in 
:
- The code examples in FUNCTIONS section: `on_scope_end { ... };` and `on_scope_end $code;`

Let me also check for bare < or > characters that need escaping:
- `` - the angle brackets here are part of HTML attributes, but the mailto links have `` that need to be escaped as < >
- Actually, looking more carefully, these are already wrapped in  tags, so the `` showing in the display are part of the HTML markup that should be escaped as `<` and `>` if they're meant to be literal characters in the text

Wait, looking at the original:
```
<https://rt.cpan.org/Public/Dist/Display.html?Name=B-Hooks-EndOfScope>
```

This is already partially escaped. The `` after is `>`. So I need to preserve those escapes.

Looking at the mailto parts:
```
bug-B-Hooks-EndOfScope AT rt.org <mailto:bug-B-Hooks-EndOfScope AT rt.org>
```

Wait, the second `` is shown with actual `` characters in the original text. Looking at the raw HTML:
```
EndOfScope AT rt.org>)
```

I see - the `` around `mailto:...` need to be escaped as `<` and `>` since they are literal text characters, not HTML markup.

Let me build the output now.

For the Quick Reference, I'll generate common use cases from the content:
- Register code to run after scope compilation
- Customize export behavior (via Sub::Exporter)

Let me draft the output:

```html
📛 NAME
B::Hooks::EndOfScope::XS - Execute code after a scope finished compilation - XS implementation

🚀 Quick Reference

Use Case
Command
Description
Register callback
on_scope_end { ... };
Run code after surrounding scope compiles
Pass code reference
on_scope_end $code;
Register a code ref to execute post-compilation
Auto-preferred
use B::Hooks::EndOfScope::XS;
Used automatically when Variable::Magic is available


🏷️ VERSION
version 0.25

📖 DESCRIPTION
This is the implementation of B::Hooks::EndOfScope based on Variable::Magic, which is an XS module dependent on a compiler. It will always be automatically preferred if Variable::Magic is available. ⚡

🛠️ FUNCTIONS

on_scope_end
on_scope_end { ... };

on_scope_end $code;
Registers $code to be executed after the surrounding scope has been compiled. 🎯
This is exported by default. See Sub::Exporter on how to customize it.

🆘 SUPPORT
Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=B-Hooks-EndOfScope> (or bug-B-Hooks-EndOfScope AT rt.org <mailto:bug-B-Hooks-EndOfScope AT rt.org>).

👥 AUTHORS

Florian Ragwitz <rafl AT debian.org>
Peter Rabbitson <ribasushi AT leporine.io>


⚖️ COPYRIGHT AND LICENCE
This software is copyright (c) 2008 by Florian Ragwitz.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.


perl v5.32.1     2021-10-15     B::Hooks::EndOfScope::XS(3pm)
```

Wait, I need to double-check the support section. The original shows:
```
<https://rt.cpan.org/...>
(or bug-B-Hooks-EndOfScope AT rt.org <mailto:bug-B-Hooks-EndOfScope AT rt.org>).
```

So the second mailto part: `<mailto:bug-B-Hooks-EndOfScope AT rt.org>` - this is what the original already has escaped. Let me preserve that. The `EndOfScope AT rt.org` part is a link in the original too. Let me preserve the structure.

Actually, looking at the original carefully:
```
bug-B-Hooks-EndOfScope AT rt.org <mailto:bug-B-Hooks-EndOfScope AT rt.org>)
```

Hmm, this is interesting. The `` tag is wrapping "EndOfScope AT rt.org" as a separate mailto link. That's the original structure I need to preserve.

Let me reconstruct more carefully. The original HTML has:
- `<` before the URL = literal ``

Then for the mailto:
- `bug-B-Hooks-EndOfScope AT rt.org` = link "bug-B-Hooks-EndOfScope AT rt.org"
- ` <mailto:bug-B-Hooks-` = literal `)`

This is a broken/odd structure in the original. I should preserve it as faithfully as possible. Let me preserve the `EndOfScope AT rt.org` link structure.

Let me finalize my output now.

Also, for AUTHORS - the original uses a list-like structure with `o` bullets but I need to convert to proper `
` per rule #10.

Let me also remember not to put emojis inside `
` blocks (rule 8).

Final output check:
- No 
 ✓
- H2 with emoji prefixes ✓
- H3 with emoji for sub-sections ✓
- Code in 
 ✓
- Lists as 
 ✓
- < and > escaped outside allowed tags ✓
- Quick Reference section included ✓
- Preserve all original info ✓

Let me write the final version.

📛 NAME
B::Hooks::EndOfScope::XS - Execute code after a scope finished compilation - XS implementation

🚀 Quick Reference


Use Case
Command
Description


Register code block
on_scope_end { ... };
Execute a block after the surrounding scope is compiled
Register coderef
on_scope_end $code;
Pass an existing code reference for deferred execution
Auto-loaded backend
use B::Hooks::EndOfScope;
Automatically preferred when Variable::Magic is available
Customize export
use Sub::Exporter ...;
Control how on_scope_end is exported



🏷️ VERSION
version 0.25

📖 DESCRIPTION
This is the implementation of B::Hooks::EndOfScope based on Variable::Magic, which is an XS module dependent on a compiler. ⚡ It will always be automatically preferred if Variable::Magic is available.

🛠️ FUNCTIONS

🎯 on_scope_end
on_scope_end { ... };

on_scope_end $code;
Registers $code to be executed after the surrounding scope has been compiled. ✅
This is exported by default. See Sub::Exporter on how to customize it.

🆘 SUPPORT
🐛 Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=B-Hooks-EndOfScope> (or bug-B-Hooks-EndOfScope AT rt.org <mailto:bug-B-Hooks-EndOfScope AT rt.org>).

👥 AUTHORS

✉️ Florian Ragwitz <rafl AT debian.org>
✉️ Peter Rabbitson <ribasushi AT leporine.io>


⚖️ COPYRIGHT AND LICENCE
©️ This software is copyright (c) 2008 by Florian Ragwitz.
🆓 This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.


perl v5.32.1     2021-10-15     B::Hooks::EndOfScope::XS(3pm)