<div dir="ltr">Great! I'll leave that commit there for reference, but as you say it would be even nicer (but more coding) to avoid needing to explicitly mark the starts and ends of lists.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Am Sa., 15. Juni 2019 um 17:54 Uhr schrieb Smith, Barry F. <<a href="mailto:bsmith@mcs.anl.gov">bsmith@mcs.anl.gov</a>>:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><br>
  Patrick (and Bill)<br>
<br>
     Good timing. Bill is actually updating Sowing now and could perhaps fix this glitch. Currently we use a . for a single entry in the list and I'd hate to have to change them all the -. Likely it is possible to fix the formatting for the . case to have the same indent as the + . - cases.<br>
<br>
   Barry<br>
<br>
> On Jun 15, 2019, at 10:15 AM, Patrick Sanan via petsc-dev <<a href="mailto:petsc-dev@mcs.anl.gov" target="_blank">petsc-dev@mcs.anl.gov</a>> wrote:<br>
> <br>
> Lists on the man pages don't seem to be able to have a single entry, because sowing requires you to start lists with "+" and end them with "-", requiring at least two entries.<br>
> <br>
> This leads to ugly-looking indentation for man pages for functions with a single input or output parameter, e.g. <a href="https://www.mcs.anl.gov/petsc/petsc-dev/docs/manualpages/DMSTAG/DMStagVecGetArrayDOF.html" rel="noreferrer" target="_blank">https://www.mcs.anl.gov/petsc/petsc-dev/docs/manualpages/DMSTAG/DMStagVecGetArrayDOF.html</a><br>
> <br>
> I think that this can be remedied with a small change to sowing (doctext), to interpret a lone '-' as opening a list (and then closing it after one entry): <a href="https://bitbucket.org/psanan/sowing/commits/780ea53824388e8c6089ae2d6210332c63935edb" rel="noreferrer" target="_blank">https://bitbucket.org/psanan/sowing/commits/780ea53824388e8c6089ae2d6210332c63935edb</a><br>
> <br>
> (Posting this here since I'm not sure how closely the <a href="http://bitbucket.org/petsc/pkg-sowing" rel="noreferrer" target="_blank">bitbucket.org/petsc/pkg-sowing</a> repository is monitored)<br>
<br>
</blockquote></div>