Skip to contentSkip to conversation

docbook45 is gone

DISCUSSION Adam Borowski 3 participants 3 messages Sep 3, 2019 Btrfs file system

lore
Share & tools
lore
#0 lore raw

Hi!
I'm afraid that asciidoctor 2.0 dropped support for docbook45. The explanation given is here:
https://github.com/asciidoctor/asciidoctor/issues/3005

This makes btrfs-progs fail to build unless docs are off, with:
asciidoctor: FAILED: missing converter for backend 'docbook45'. Processing aborted.

Naively bumping the backend to docbook5 makes the output fail to pass validation.

I don't know a thing about docbook nor asciidoc, thus I can't fix this myself. kdave: you did the conversion, could you save us now?

Meow!

Signature · 4 lines
⢀⣴⠾⠻⢶⣦⠀ 
⣾⠁⢠⠒⠀⣿⡁ Ivan was a worldly man: born in St. Petersburg, raised in
⢿⡄⠘⠷⠚⠋⠀ Petrograd, lived most of his life in Leningrad, then returned
⠈⠳⣄⠀⠀⠀⠀ to the city of his birth to die.
#1 lore raw
Quoted 5 lines · Adam Borowski

Hi!
I'm afraid that asciidoctor 2.0 dropped support for docbook45. The explanation given is here:
https://github.com/asciidoctor/asciidoctor/issues/3005

Quoted 8 lines

This makes btrfs-progs fail to build unless docs are off, with:
asciidoctor: FAILED: missing converter for backend 'docbook45'. Processing aborted.

Naively bumping the backend to docbook5 makes the output fail to pass validation.

I don't know a thing about docbook nor asciidoc, thus I can't fix this myself. kdave: you did the conversion, could you save us now?

There is a migration guide to DocBook v5.0:
https://docbook.org/docs/howto/howto.html

The changes look mostly search&replace-able, which is why there is also an xsl to directly perform this conversion.

Hope this helps.

-h

#2 lore raw
In reply to Adam Borowski
Quoted 9 lines · Adam Borowski

I'm afraid that asciidoctor 2.0 dropped support for docbook45. The explanation given is here:
https://github.com/asciidoctor/asciidoctor/issues/3005

This makes btrfs-progs fail to build unless docs are off, with:
asciidoctor: FAILED: missing converter for backend 'docbook45'. Processing aborted.

Naively bumping the backend to docbook5 makes the output fail to pass validation.

As a workaround you can do

XMLTO_EXTRA += --skip-validation

it builds and the result looks correct from the few samples I tried. Proper conversion to docbook5 will need to happen anyway, I'll open an issue for 5.3 target. Thanks for the report.