---
name: "Lire::DocBookParser"
section: "3pm"
platform: "linux"
package: "lire"
version: "2.1.1-8"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Lire::DocBookParser"
---

# Lire::DocBookParser(3pm)

Base DocBook parser.

## NAME

Lire::XMLParser - Base DocBook parser.

## SYNOPSIS

```
    package MyParser;
    use base qw/ Lire::XMLParser /;
```

## DESCRIPTION

This package contains a Lire::XMLParser DocBook parser. It defines the relevant `"_start"`, `"_end"` and `"_char"` methods for the DocBook subset used by Lire. All defined handlers have the form `"dbk_`*name*`_start"`, `"dbk_`*name*`_end"` and `"dbk_`*name*`_char"` (when the element accepts PCDATA content).

Its base functionality is to collect the DocBook markup for later use. It will subclassed most of the time.

## CLIENT METHODS

### dbk\_init()

Subclasses should call this method whenever the state of the DocBook parse should start. This is called from the **parse\_start()** method when the parser is used standalone.

### dbk\_string()

Returns the DocBook XML accumulated by the parser. This is returned from **parse\_end()** method when used standalone.

## XML SPECIFICATIONS METHODS IMPLEMENTATION

### namespaces()

DocBook doesn't use namespace, so this method returns an empty hash reference.

### elements\_spec()

Returns the elements specification for the DocBook subset supported by Lire.

## SEE ALSO

```
 Lire::XMLParser(3pm), Lire::ReportParser::AsciiDocBookFormatter(3pm),
 Lire::ReportParser::HtmlDocBookFormatter(3pm)
```

## AUTHOR

```
  Francis J. Lacoste <flacoste@logreport.org>
```

## VERSION

`$Id:` DocBookParser.pm,v 1.4 2006/07/23 13:16:29 vanbaal Exp $

## COPYRIGHT

Copyright (C) 2004 Stichting LogReport Foundation LogReport@LogReport.org

This file is part of Lire.

Lire is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html.