Not found locally for Dpkg::Arch. Try Google search
The user wants me to transform this Perl man page for Dpkg::Arch into an emoji-rich, visually scannable HTML version. Let me follow all the rules carefully. Let me identify the sections: - NAME - DESCRIPTION - FUNCTIONS (contains a list of functions) - CHANGES (has subsections with versions) - SEE ALSO The function reference section should use `name(args) — description` blocks. Let me follow the original format.
Wait, looking at the original, the function signatures appear inline as part of the text, like:
```
$arch = get_raw_build_arch()
Get the raw build Debian architecture...
```
These are indented with spaces (man page style). I should preserve this structure. The function signature lines look like code, and the descriptions are regular text.
Let me convert this properly:
- Function signature line → wrapped in ``
- Description → regular text following
But then I need a separate paragraph or just keep them flowing. Let me think about this. The original uses indentation to separate each function. I think the cleanest approach is to keep each function as:
- Code block for the signature
- Paragraph for the description
But that creates a lot of `` blocks. Looking at rule #6, "Code includes anything with: $variable, ->method, use Module;, function(), flags like -f --long". Yes, the `$arch = get_raw_build_arch()` is code.
Let me wrap each function signature in a `` block.
Now for the changes section, the "Version 1.03 (dpkg 1.19.1)" etc. are sub-headings (h3) within the CHANGES section.
Let me also think about the CHANGES section - those version lines like "Version 1.03 (dpkg 1.19.1)" should be h3 headings per rule #3.
Let me draft the output now.
For Quick Reference, I'll create a useful table:
| Use Case | Command | Description |
| Get build arch | `my $arch = get_build_arch();` | Current build architecture |
| Get host arch | `my $arch = get_host_arch();` | Current host architecture |
| Map to multiarch | `my $m = debarch_to_multiarch('amd64');` | Convert Debian arch to multiarch tuple |
| Check architecture match | `debarch_is('amd64', 'any');` | Match arch against wildcard |
| GNU triplet mapping | `my $g = debarch_to_gnutriplet('amd64');` | Convert to GNU triplet |
| Parse arch list | `my @a = debarch_list_parse('amd64 !armhf');` | Parse dependency arch restrictions |
Now let me write it out.
Emoji choices:
- NAME: 📛
- Quick Reference: 🚀
- DESCRIPTION: 📖
- FUNCTIONS: ⚙️
- CHANGES: 📝
- SEE ALSO: 🔗
For the function reference list (per rule #12), I'll use `name(args) — description ` WITHOUT per-item emoji. But wait, the original FUNCTIONS section has the function signatures as indented code blocks, not as a list. Let me think about whether to use a list format or preserve the original format.
Looking again at the original structure, each function in the FUNCTIONS section has:
1. A signature line (indented)
2. A description (indented further or as paragraphs)
I think the cleanest is to keep this as it is - use `` for each signature and paragraph for descriptions. This preserves the structure better than converting to a list. The rule about function reference lists using `` is more about when the input has a list-like format.
Actually, looking at the rule again: "For function, method, and class reference sections (pydoc modules, ruby ri classes, perldoc function lists): use name(args) — description format WITHOUT per-item emoji."
This is a Perl module (perldoc), so it would apply here. Let me convert the function list to use `` with `- ` items. The function signatures become `
` inline within list items.
Let me redo this:
- Each function as `$arch = get_raw_build_arch() — Get the raw build Debian architecture... `
That's cleaner and more scannable. Let me go with this approach.
Now let me also handle the "positive" option mentions - those have a `positive` in quotes which is just a string. Keep them as-is.
Let me draft the full output:
```html
📛 NAME
Dpkg::Arch - handle architectures
🚀 Quick Reference
Use Case Command Description
Get build architecture my $arch = get_build_arch();Current build arch (respects DEB_BUILD_ARCH)
Get host architecture my $arch = get_host_arch();Current host arch (respects DEB_HOST_ARCH)
Map to multiarch tuple my $m = debarch_to_multiarch('amd64');Convert Debian arch to multiarch tuple
Map to GNU triplet my $g = debarch_to_gnutriplet('amd64');Convert Debian arch to GNU triplet
Match arch against wildcard debarch_is('amd64', 'any');Check if arch matches wildcard pattern
Parse dependency arch list my @a = debarch_list_parse('amd64 !armhf');Parse arch restrictions from dependencies
Validate architecture name debarch_is_illegal('amd64');Returns true if name is invalid
📖 DESCRIPTION
The Dpkg::Arch module provides functions to handle Debian architectures, wildcards, and mapping from and to GNU triplets.
No symbols are exported by default. The :all tag can be used to import all symbols. The :getters, :parsers, :mappers and :operators tags can be used to import specific symbol subsets.
⚙️ FUNCTIONS
$arch = get_raw_build_arch() — Get the raw build Debian architecture, without taking into account variables from the environment.
$arch = get_build_arch() — Get the build Debian architecture, using DEB_BUILD_ARCH from the environment if available.
$arch = get_raw_host_arch() — Get the raw host Debian architecture, without taking into account variables from the environment.
$arch = get_host_arch() — Get the host Debian architecture, using DEB_HOST_ARCH from the environment if available.
@arch_list = get_valid_arches() — Get an array with all currently known Debian architectures.
$multiarch = gnutriplet_to_multiarch($gnutriplet) — Map a GNU triplet into a Debian multiarch triplet.
$multiarch = debarch_to_multiarch($arch) — Map a Debian architecture into a Debian multiarch triplet.
$gnutriplet = debarch_to_gnutriplet($arch) — Map a Debian architecture into a GNU triplet.
$arch = gnutriplet_to_debarch($gnutriplet) — Map a GNU triplet into a Debian architecture.
$bool = debarch_eq($arch_a, $arch_b) — Evaluate the equality of a Debian architecture, by comparing with another Debian architecture. No wildcard matching is performed.
$bool = debarch_is($arch, $arch_wildcard) — Evaluate the identity of a Debian architecture, by matching with an architecture wildcard.
$bool = debarch_is_wildcard($arch) — Evaluate whether a Debian architecture is an architecture wildcard.
$bool = debarch_is_illegal($arch, %options) — Validate an architecture name. If the "positive" option is set to a true value, only positive architectures will be accepted, otherwise negated architectures are allowed.
$bool = debarch_is_concerned($arch, @arches) — Evaluate whether a Debian architecture applies to the list of architecture restrictions, as usually found in dependencies inside square brackets.
@array = debarch_list_parse($arch_list, %options) — Parse an architecture list. If the "positive" option is set to a true value, only positive architectures will be accepted, otherwise negated architectures are allowed.
📝 CHANGES
Version 1.03 (dpkg 1.19.1)
New argument: Accept a "positive" option in debarch_is_illegal() and debarch_list_parse().
Version 1.02 (dpkg 1.18.19)
New import tags: :all, :getters, :parsers, :mappers, :operators.
Version 1.01 (dpkg 1.18.5)
New functions: debarch_is_illegal(), debarch_list_parse().
Version 1.00 (dpkg 1.18.2)
Mark the module as public.
🔗 SEE ALSO
```
Wait, let me check the XSS rules. Are there any bare < or > characters? Looking through the content - I see `[` and `]` for square brackets, which are fine. No bare < or > outside allowed tags. Good.
Let me check the description - "as usually found in dependencies inside square brackets" - those are regular brackets, not angle brackets. Good.
Let me also check that I'm not using disallowed emoji-as-bullets. I'm only using emoji in headings. Good.
Let me review once more:
- Rule 1: No h1 ✓
- Rule 2: h2 for sections ✓
- Rule 3: h3 for sub-sections ✓ (versions in CHANGES)
- Rule 4: Comments in code - N/A here
- Rule 5-8: Code blocks - I used `` inline within `- ` items. The function signatures use `
` inline, which is fine per rule #12. But wait - the function signatures like `$arch = get_raw_build_arch()` have $ signs which rule #6 says is code. But rule #12 specifically says to use `` inline within `- ` for function references, so this takes precedence.
- Rule 10: Lists use proper HTML ✓
- Rule 11: No emoji as bullets ✓
- Rule 12: Function references use `
name(args) — description ` without per-item emoji ✓
- Rule 13-14: No bare < or > ✓
- Rule 15: Output only HTML ✓
- Rule 17: Preserve ✓
- Rule 18: Add descriptive emoji to option descriptions - I added emoji to headings
- Rule 21: Quick Reference section as second section ✓
- Rule 22: No Exit Codes section since document doesn't list exit codes ✓
Wait, I need to double check rule #12. It says "WITHOUT per-item emoji" but my list items don't have per-item emoji. The list itself has emoji-free items, with an emoji on the section heading. That matches.
Let me also think about whether my Quick Reference table cells have proper formatting. The cells use `` not `` per rule #21. Good.
One more consideration - the original mentions "as usually found in dependencies inside square brackets" - this is just regular text, but I should make sure I'm not using any HTML angle brackets there. Let me verify... "square brackets" - those are `[` and `]` which are fine.
Looks good. Let me finalize.
Actually wait, I should also check that the Quick Reference table doesn't have any issues. Let me verify the table structure. It's wrapped in with and and . Those are all allowed tags. Good.
Let me also add a tiny bit more polish - maybe a brief intro line before the Quick Reference table? Or just keep it clean. I'll keep it clean.
Final output coming up.
📛 NAME
Dpkg::Arch - handle architectures
🚀 Quick Reference
Use Case Command Description
Get build architecture my $arch = get_build_arch();Current build arch (respects DEB_BUILD_ARCH env var)
Get host architecture my $arch = get_host_arch();Current host arch (respects DEB_HOST_ARCH env var)
Map to multiarch tuple my $m = debarch_to_multiarch('amd64');Convert Debian arch → multiarch tuple
Map to GNU triplet my $g = debarch_to_gnutriplet('amd64');Convert Debian arch → GNU triplet
Match arch against wildcard debarch_is('amd64', 'any');Test arch against a wildcard pattern
Parse dependency arch list my @a = debarch_list_parse('amd64 !armhf');Parse arch restrictions from a dependency field
Validate architecture name debarch_is_illegal('amd64');Returns true if the name is invalid
📖 DESCRIPTION
The Dpkg::Arch module provides functions to handle Debian architectures, wildcards, and mapping from and to GNU triplets.
No symbols are exported by default. The :all tag can be used to import all symbols. The :getters, :parsers, :mappers and :operators tags can be used to import specific symbol subsets.
⚙️ FUNCTIONS
$arch = get_raw_build_arch() — Get the raw build Debian architecture, without taking into account variables from the environment.
$arch = get_build_arch() — Get the build Debian architecture, using DEB_BUILD_ARCH from the environment if available.
$arch = get_raw_host_arch() — Get the raw host Debian architecture, without taking into account variables from the environment.
$arch = get_host_arch() — Get the host Debian architecture, using DEB_HOST_ARCH from the environment if available.
@arch_list = get_valid_arches() — Get an array with all currently known Debian architectures.
$multiarch = gnutriplet_to_multiarch($gnutriplet) — Map a GNU triplet into a Debian multiarch triplet.
$multiarch = debarch_to_multiarch($arch) — Map a Debian architecture into a Debian multiarch triplet.
$gnutriplet = debarch_to_gnutriplet($arch) — Map a Debian architecture into a GNU triplet.
$arch = gnutriplet_to_debarch($gnutriplet) — Map a GNU triplet into a Debian architecture.
$bool = debarch_eq($arch_a, $arch_b) — Evaluate the equality of a Debian architecture, by comparing with another Debian architecture. No wildcard matching is performed.
$bool = debarch_is($arch, $arch_wildcard) — Evaluate the identity of a Debian architecture, by matching with an architecture wildcard.
$bool = debarch_is_wildcard($arch) — Evaluate whether a Debian architecture is an architecture wildcard.
$bool = debarch_is_illegal($arch, %options) — Validate an architecture name. If the "positive" option is set to a true value, only positive architectures will be accepted, otherwise negated architectures are allowed.
$bool = debarch_is_concerned($arch, @arches) — Evaluate whether a Debian architecture applies to the list of architecture restrictions, as usually found in dependencies inside square brackets.
@array = debarch_list_parse($arch_list, %options) — Parse an architecture list. If the "positive" option is set to a true value, only positive architectures will be accepted, otherwise negated architectures are allowed.
📝 CHANGES
🆕 Version 1.03 (dpkg 1.19.1)
New argument: Accept a "positive" option in debarch_is_illegal() and debarch_list_parse().
🏷️ Version 1.02 (dpkg 1.18.19)
New import tags: :all, :getters, :parsers, :mappers, :operators.
➕ Version 1.01 (dpkg 1.18.5)
New functions: debarch_is_illegal(), debarch_list_parse().
🎉 Version 1.00 (dpkg 1.18.2)
Mark the module as public.
🔗 SEE ALSO
Generated by phpman v4.10.0-7-g98e9fd5 Author: Che Dong Under GNU General Public License
2026-09-09 11:32 @2600:1f28:365:80b0:60b0:dfa5:fbc9:9f8f
CrawledBy CCBot/2.0 (https://commoncrawl.org/faq/)

