<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Thanks, George. On the line numbering, unfortunately, this is very difficult to fix (and is a known problem). My proposal instead is to not use the line numbers in these cases; in the rare cases where we need to identify the location, we can count rows in the table or otherwise identify the line. There are some alternatives, but they are awkward and IMHO ugly, and don’t add much. <div class=""><br class=""></div><div class="">Bill</div><div class=""><br class=""><div class="">
<div dir="auto" style="caret-color: rgb(0, 0, 0); color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration: none; word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><div>William Gropp<br class="">Director, NCSA<br class="">Thomas M. Siebel Chair in Computer Science</div><div>University of Illinois Urbana-Champaign</div><div>IEEE-CS President-Elect</div><div class=""><br class=""></div></div><br class="Apple-interchange-newline"><br class="Apple-interchange-newline">
</div>
<div><br class=""><blockquote type="cite" class=""><div class="">On Sep 3, 2021, at 12:19 PM, George Bosilca <<a href="mailto:bosilca@icl.utk.edu" class="">bosilca@icl.utk.edu</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="auto" class="">Bill,</div><div dir="auto" class=""><br class=""></div><div dir="auto" class="">These PDFs looks great, a clear leap forward in improving the readability and cleanness of the MPI standard. </div><div dir="auto" class=""><br class=""></div><div dir="auto" class="">The only issue I noticed (and that was pinpointed in your email) was about the multi-page tabular where the numbering is done consecutively for the entire tabular environment despite the fact that the table is split across multiple pages, and the numbers are placed on the same side as the first page on all pages. If we can fix this to have the line numbers per page and on the correct side for all environments, that would be great.</div><div dir="auto" class=""><br class=""></div><div dir="auto" class="">Thanks,</div><div dir="auto" class=""> George.</div><div dir="auto" class=""><br class=""></div><div class=""><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Sep 2, 2021 at 11:03 Gropp, William D via mpi-forum <<a href="mailto:mpi-forum@lists.mpi-forum.org" class="">mpi-forum@lists.mpi-forum.org</a>> wrote:<br class=""></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;padding-left:1ex;border-left-color:rgb(204,204,204)">
<div class="">
<div style="word-wrap:break-word;line-break:after-white-space" class="">I’ve been experimenting with updating the MPI Forum document formatting, and in particular, modernizing the use of LaTeX and reducing the custom LaTeX in the document. Attached are a
few pages from my tests. These show:
<div class=""><br class="">
</div>
<div class="">1) Use of the lineno package to label each line of text - this replaces the ruler currently used, and means that text is more accurately labeled, but “boxes”, including tables, figures, and captions may not have line numbers. All of the attached
pages show the line numbers in the margins.</div>
<div class="">2) Use of the lstlisting package, with syntax and MPI routine highlighting. This also sets a background to gray to help the code examples standout. The approach used in MPI 4.0 creates a box with a border; because of the box, in that approach,
the individual lines of code are not numbered. Hence this change in how code examples are marked off. The attached examples show both one page and a code example that spans two pages.</div>
<div class="">3) There is a way to include numbering for tabular environments (and some others). However, this can lead to some odd labeling, because of how the labeling is implemented within the various LaTeX packages. I’ve included some examples which show
both the expected behavior (consecutive numbering) and the unexpected (and nearly impossible to fix) non-consecutive numbering.</div>
<div class="">4) I’ve also switched from the book to the srcbook document class. This is a more modern and powerful document class, and has allowed me to remove some of the custom LaTeX code.</div>
<div class=""><br class="">
</div>
<div class="">I’d like feedback on these. I’d like to adopt some of these for the next version. In particular:</div>
<div class=""><br class="">
</div>
<div class="">1) Use srcbook instead of book</div>
<div class="">2) Use lstlisting in code examples as shown here</div>
<div class="">3) For tabular environments, do NOT use line numbers for tabular environments used within a table (or other floating) environment. This is where the weird line numbering can happen (e.g., see the attached page 32). For inline tabular environments,
use edtable to get line numbers (this is what was used in these examples, and it has worked well in other parts of the document)</div>
<div class=""><br class="">
</div>
<div class="">
<div class="">If you have suggestions for improvements or alternatives, please let me know.</div>
<div class=""><br class="">
</div>
<div class="">Bill</div>
<div class=""><br class="">
</div>
<div class=""></div>
</div>
</div>
<div style="word-wrap:break-word;line-break:after-white-space" class="">
<div class="">
<div class=""></div>
</div>
</div>
<div style="word-wrap:break-word;line-break:after-white-space" class="">
<div class="">
<div class=""></div>
</div>
</div>
<div style="word-wrap:break-word;line-break:after-white-space" class="">
<div class="">
<div class=""></div>
</div>
</div>
<div style="word-wrap:break-word;line-break:after-white-space" class="">
<div class="">
<div class=""><br class="">
<div class="">
<div dir="auto" style="letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; text-decoration: none; word-wrap: break-word; line-break: after-white-space;" class="">
<div class="">William Gropp<br class="">
Director, NCSA<br class="">
Thomas M. Siebel Chair in Computer Science</div>
<div class="">University of Illinois Urbana-Champaign</div>
<div class="">IEEE-CS President-Elect</div>
<div class=""><br class="">
</div>
</div>
<br class="">
<br class="">
</div>
<br class="">
</div>
</div>
</div>
</div>
_______________________________________________<br class="">
mpi-forum mailing list<br class="">
<a href="mailto:mpi-forum@lists.mpi-forum.org" target="_blank" class="">mpi-forum@lists.mpi-forum.org</a><br class="">
<a href="https://urldefense.com/v3/__https://lists.mpi-forum.org/mailman/listinfo/mpi-forum__;!!DZ3fjg!ocG0YkYjZCIg26wHqY9ROpnb8nHCQTM8tYRtSx_Yw7RsjsMy5TL85BlU7F6wBdHXnA$" rel="noreferrer" target="_blank" class="">https://lists.mpi-forum.org/mailman/listinfo/mpi-forum</a><br class="">
</blockquote></div></div>
</div></blockquote></div><br class=""></div></body></html>