<div dir="ltr">The quickest fix would of course be to remove that limit. Some pages would probably end up with dozens of example links, but that might not be so bad, as below are only "implementations" (which are probably used mainly by (potential) developers), and links back to the indices. With some scripting one could make an html table (or whatever) to have more than one link per line to save space.<div><br></div><div>It would also be helpful to move some of the "bad" examples (which look more like tests in many cases) to the tests/ directories. <br></div><div>There are papers out there which reference these examples, but those would of course be expected to be the "good" ones.</div><div><br></div><div>Out of curiosity, is there any non-historical argument to have this sort of logic in bash, as opposed to python?</div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Am Sa., 20. Apr. 2019 um 23:37 Uhr schrieb Smith, Barry F. via petsc-dev <<a href="mailto:petsc-dev@mcs.anl.gov">petsc-dev@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>
   Yeah this is done in lib/petsc/conf/rules<br>
<br>
#<br>
#   Example usage for manual pages; adds each example that uses a function to that functions<br>
# manual page up to a limit of 10 examples.<br>
#<br>
manexamples:<br>
        -@base=`basename ${LOCDIR}`; \<br>
        if [ "$${base}" = "tutorials" ] ; then \<br>
          echo "Generating manual example links" ; \<br>
          for i in ${EXAMPLESC} ${EXAMPLESF} foo ; do \<br>
            if [ "$$i" != "foo" ] ; then \<br>
              a=`cat $$i | ${MAPNAMES} -map ${LOC}/docs/manualpages/manualpages.cit \<br>
                   -printmatch-link -o /dev/null| cut -f 2 | cut -d '#' -f 1 |sed -e s~^../~~ | grep \\.html$$ | sort | uniq` ;  \<br>
              for j in $$a ; do \<br>
                b=`ls ${LOC}/docs/manualpages/$${j} | grep -v /all/ | cut -f9` ; \<br>
                l=`grep "^<A HREF=\"\.\./\.\./\.\..*/tutorials/" $${b} | wc -l`; \<br>
                if [ $$l -le 10 ] ; then \<br>
                  if [ $$l -eq 0 ] ; then \<br>
                    echo "<P><H3><FONT COLOR=\"#CC3333\">Examples</FONT></H3>" >> $$b; \<br>
                  fi; \<br>
                  echo  "<A HREF=\"../../../BB\">BB</A><BR>" | sed s?BB?${LOCDIR}$$i.html?g >> $$b; \<br>
                  grep -v /BODY $$b > ltmp; \<br>
                  echo "</BODY></HTML>" >> ltmp; \<br>
                  mv -f ltmp $$b; \<br>
                fi; \<br>
              done; \<br>
            fi; \<br>
          done; \<br>
        fi<br>
<br>
It has a hardwired limit of 10 (though it seems to produce 11 :-).<br>
<br>
Given how many bad examples we have in the tutorial directories it is not a good model to just grab 10 of them.<br>
<br>
<br>
<br>
> On Apr 20, 2019, at 3:49 AM, Hapla Vaclav via petsc-dev <<a href="mailto:petsc-dev@mcs.anl.gov" target="_blank">petsc-dev@mcs.anl.gov</a>> wrote:<br>
> <br>
> Hello<br>
> <br>
> Why<br>
> <a href="https://www.mcs.anl.gov/petsc/petsc-dev/docs/manualpages/SNES/SNESSolve.html#SNESSolve" rel="noreferrer" target="_blank">https://www.mcs.anl.gov/petsc/petsc-dev/docs/manualpages/SNES/SNESSolve.html#SNESSolve</a><br>
> <a href="https://www.mcs.anl.gov/petsc/petsc-dev/docs/manualpages/SNES/SNESSetDM.html#SNESSetDM" rel="noreferrer" target="_blank">https://www.mcs.anl.gov/petsc/petsc-dev/docs/manualpages/SNES/SNESSetDM.html#SNESSetDM</a><br>
> do not list ex62 and ex77<br>
> <a href="https://www.mcs.anl.gov/petsc/petsc-dev/src/snes/examples/tutorials/ex62.c.html" rel="noreferrer" target="_blank">https://www.mcs.anl.gov/petsc/petsc-dev/src/snes/examples/tutorials/ex62.c.html</a><br>
> <a href="https://www.mcs.anl.gov/petsc/petsc-current/src/snes/examples/tutorials/ex77.c.html" rel="noreferrer" target="_blank">https://www.mcs.anl.gov/petsc/petsc-current/src/snes/examples/tutorials/ex77.c.html</a><br>
> while these examples use these routines?<br>
> <br>
> It affects both dev and current manpages. Is there a deliberate limit on number of examples listed?<br>
> <br>
> I think it's confusing. Particularly these examples are often used in tutorials, right?<br>
> <br>
> Thanks,<br>
> Vaclav<br>
<br>
</blockquote></div>