Parse::Man::DOM(3pm)

📦 version 0.03, in debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

✨ NAME ✨

okay so bestie, meet Parse::Man::DOM — it parses nroff-formatted manpages and hands you back a whole DOM tree 💅 this is the Parse::Man::DOM(3pm) page, and yes she is that girl.

🌸 SYNOPSIS 🌸

use Parse::Man::DOM;

my $parser = Parse::Man::DOM->new;

my $document = $parser->from_file( "my_manpage.1" );

print "The manpage name is", $document->meta( "name" ), "\n";

💖 DESCRIPTION 💖

So this is a subclass of Parse::Man, and what it does is give you back an object tree that represents the parsed content of the input file. The result you get is an object of the Parse::Man::DOM::Document class, and that baby has other objects nested all up inside it. it's giving nesting dolls but make it manpages 🪆✨

🎀 Parse::Man::DOM::Document

This one represents the document as a whole. main character energy fr.

meta

$meta = $document->meta( $key )

Returns a Parse::Man::DOM::Metadata object for the named item of metadata. the keys you can ask for:

  • name — the page name given to the .TH directive.
  • section — the section number given to the .TH directive.

paras

@paras = $document->paras

Returns a list of Parse::Man::DOM::Heading or Parse::Man::DOM::Para or subclass objects, containing the actual page content. the real content, the whole vibe 💖

🦋 Parse::Man::DOM::Metadata

Represents a single item of metadata about the page. one lil factoid, no cap.

name

$name = $metadata->name

The string name of the metadata

value

$value = $metadata->value

The string value of the metadata

🌈 Parse::Man::DOM::Heading

Represents the contents of a .SH or .SS heading.

level

$level = $heading->level

The heading level number; 1 for .SH, 2 for .SS

text

$text = $heading->text

The plain text string of the heading title

💜 Parse::Man::DOM::Para

Represents a paragraph of formatted text content. Will be one of the following subclasses. (so like, it's the mom of the para squad 👑)

filling

$filling = $para->filling

Returns true if filling (.fi) is in effect, or false if no-filling (.nf) is in effect.

body

$chunklist = $para->body

Returns a Parse::Man::DOM::Chunklist to represent the actual content of the paragraph.

indent

$indent = $para->indent

Returns the indentation size in column count, if defined.

🫶 Parse::Man::DOM::Para::Plain

Represent a plain (.P or .PP) paragraph.

type

$type = $para->type

Returns "plain".

🍓 Parse::Man::DOM::Para::Term

Represents a term paragraph (.TP).

type

$type = $para->type

Returns "term".

term

$chunklist = $para->term

Returns a Parse::Man::DOM::Chunklist for the defined term name.

definition

$chunklist = $para->definition

Returns a Parse::Man::DOM::Chunklist for the defined term definition.

🧚 Parse::Man::DOM::Para::Indent

Represents an indented paragraph (.IP).

type

$type = $para->type

Returns "indent".

marker

$marker = $para->marker

Returns the indentation marker text, if defined.

🌟 Parse::Man::DOM::Para::Example

Represents an example paragraph (.EX / .EE).

type

$type = $para->type

Returns "example".

💫 Parse::Man::DOM::Chunklist

Contains a list of Parse::Man::DOM::Chunk objects to represent paragraph content. a lil squad of chunks, obsessed.

chunks

@chunks = $chunklist->chunks

Returns a list of Parse::Man::DOM::Chunk objects.

🎀 Parse::Man::DOM::Chunk

Represents a chunk of text with a particular format applied. slay, formatting.

text

$text = $chunk->text

The plain string value of the text for this chunk.

font

$font = $chunk->font

The font name in effect for this chunk. One of "R", "B", "I" or "SM".

size

$size = $chunk->size

The size of this chunk, relative to the paragraph base of 0.

👑 AUTHOR 👑

Paul Evans <leonerd@leonerd.org.uk>

okay bestie that's the whole page, no notes 💖 this was perl v5.36.0, dated 2023-10-24, and it lives at Parse::Man::DOM(3pm) — go read some manpages and parse them, periodt 🦋✨

📦 where this page comes from