Source: debmake-doc
Version: 1.17-4
Severity: normal
asciidoc will be deprecated. Although asciidoctor should be a plug-in
replacement, it is written in ruby and I have no idea how long it will
be around.
So I will reformat source for bookworm.
Action plan:
Step 1: Make XML as the source and drop asciidoc dependency
Skip manpage generation issue with static file (probably
generated off-line with asciidoc)
Step 2: Replace numerical entity references with the REAL UTF-8
characters (decide what to do with ' " variants in UTF-8)
Step 3: Convert XML to reST using pandoc and make it sphinx based document
Step 4: Split into smaller files for ease of editing
Step 5: Create manpage with rst2man
Step 6: Create po translation
Minimum is Step 1 and step 2.
-- System Information:
Debian Release: bookworm/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 5.15.0-2-amd64 (SMP w/12 CPU threads)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled
