search

Starlink / perl-Pod-SST

Convert perl pod to Starlink SST prologues
0 stars 0 forks source link

Paragraphs misparsed. #2

Open MalcolmCurrie opened 5 years ago

MalcolmCurrie commented 5 years ago

Some recipe-parameter descriptions have paragraphs or bullet lists (uses =item *) of allowed values. pod2sst loses the blank line between paragraphs and items, and also indents the start of the new paragraph or item left, aligning with the parameter name.

After processing with prolat this issue results in the first sentence of the each new paragraph appearing in a \sstsubsection{}, and thus in the final document appears in bold as a new parameter heading, followed by a blank line breaking the paragraph. See SUN/260's listing of REDUCE_SCIENCE_NARROWLINE for examples.

Shouldn 't \sstsubsection{} only be created when there some pod markup such as =item?

grahambell commented 5 years ago

It looks like Pod::SST doesn't handle nested lists or listen for the start_over_bullet / end_over_bullet methods which would tell it when a bullet-point list is starting or ending.

I'll take a look at updating it later. (It looks like the Pod::Simple::Text module in the Pod::Simple distribution (which Pod::SST uses) would be a good place to see what methods we should be listening for.)

grahambell commented 5 years ago

I've attempted to improve handling of this particular case of nesting in commit 527e1d8786e7284b5ec93b33f94a0e912578a2bf.