Skip to content

Codeblocks with configuration comments not rendered properly #6

@jericson

Description

@jericson

For some reason, configuration examples that start with # (i.e., comments) don't get rendered properly. See for example man5/config:

Image

C code seems to work fine. Same with the table in man3/OPENSSL_s390xcap. I used the following code to find spot check for problems:

find . -name \*.pod | xargs grep '^\W*#' | grep -v '#include' | grep -v '#define' | grep -v '#if' | grep -v '#endif'| grep -v '<<' | grep -v '#else'

When I make the docs locally, I don't see the problems in the generated HTML files. For instance, when I open openssl/doc/html/man5/config.html, I see this:

Image

My guess is the problem has something to do with syntax highlighting, but I haven't looked closely at how POD is processed into HTML here.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions