manual: expand the protocol decoder troubleshooting subsection Expand the discussion that timing information is not required or optional to some decoders, but essential to others (because of the very protocol that gets interpreted). Mention that some oversampling is typically required. Don't suggest that PD exceptions must be bugs, incomplete configuration may be even more typical. Separate the "you can ..." introduction from the first check list item, to increase visibility of the entry. Existing text was not re-flown, to reduce the diff size.
manual: also install images/*.png with the HTML output Extend the CMake rules for the manual. Do install the images/ subdir but omit the *.xcf files. Prepare the CSS file although this seems to be not strictly necessary (gets inlined, but we are prepared if it's external). Only install these additional files when the asciidoctor(1) tool is available, and thus the .html file can get generated (to not install some questionable combination of a .pdf and unrelated .png files, or to not install the resources when none of the manual files got created). This approach was tested with the following command sequence: $ make manual $ make install $ xdg-open ~/share/doc/pulseview/*.html
manual: accept absence of the asciidoctor-pdf exectuable The asciidoctor(1) executable is considered mandatory when building the Pulseview manual. The asciidoctor-pdf(1) executable is not universally available (is missing in Debian), accept its absence, avoid execution failure in that case. This implementation replaces the actual .txt to .pdf conversion with a mere echo(1) message, which may go unnoticed in verbose build output. "make --no-print-directories manual" may be required to remain aware.
manual: introduce CMake logic for asciidoctor execution Introduce new "manual", "manual-html" and "manual-pdf" make(1) targets (the former depending on the latter). None of these targets are part of "make all" by design, users decide whether to convert the manual text. Execution will fail (fatally) in the absence of dependencies or tools.