Skip to content

paragraphs are not preserved in docstring boxes in TeX output #918

Description

@medovina

In docstring boxes in TeX output, all paragraphs are combined into a single paragraph, making the text difficult to read.

For example, section 3.3 Traversal of the Verso documentation contains a docstring box describing the Verso.Doc.Traverse type class. In the generated HTML, its description looks like this:

Genre-specific traversal.

The traversal pass is where cross-references are resolved. The traversal pass repeatedly applies a genre-specific stateful computation until a fixed point is reached, both with respect to the state and the document. Traversal may update the state or rewrite parts of the document.

The methods part, block, and inline provide effects to be carried out...

But in the TeX output all of these paragraphs are combined, so the resulting PDF looks like this:

Genre-specific traversal.The traversal pass is where cross-references are re-
solved. The traversal pass repeatedly applies a genre-specific stateful compu-
tation until a fixed point is reached, both with respect to the state and the doc-
ument. Traversal may update the state or rewrite parts of the document.The
methods part, block, and inline provide effects to be carried out...

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