<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi,<div class=""><br class=""></div><div class="">My initial comments are:</div><div class=""><br class=""></div><div class="">- Are the single quotes necessary (providing any value?) as there isn’t expected to be anything else on the line?</div><div class="">- Shouldn’t the ampersand be located outside of the quoted string?</div><div class="">- Is there a benefit to a free form text field having a comment? Particularly as it might contain an unlimited number of lines?</div><div class="">- I think that if a line ends with an ampersand but the next does not contain the “CONTINUE” keyword, is should be an error. If it looks like an error (even acknowledged in the document), it should be an error.</div><div class="">- There should be no chance (particularly through an error!) that the continuation string (“&”) be assumed to be part of the long string. This is another argument to keep the continuation character outside of the quoted string.</div><div class="">- Is there a maximum number of lines? While the intent here is for strings of a few lines, this clearly lays out the red carpet for the possibility of megabytes of text. In software, whatever your intent it, expect users to exceed it by an order of magnitude.</div><div class=""><br class=""></div><div class=""><div class="">Is the reason this specific format was chosen was that it is currently being implemented somewhere else?</div></div><div class=""><br class=""></div><div class="">I would also request the the LaTeX document for the documentation use the correct “straight” quote in the example headers. The document source is using straight single quotes, but these of course become a curly quote which is incorrect. This can be accomplished, for example, with the “\textquotesingle” macro in the textcomp package.</div><div class=""><br class=""></div><div class="">Demitri</div><div class=""><br class=""></div><div class="">
<div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="text-align: -webkit-auto; line-height: normal; orphans: 2; widows: 2; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="text-align: -webkit-auto; line-height: normal; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">_________________________________________<br class="">Demitri Muna<br class=""><a href="http://muna.com" class="">http://muna.com</a></div><div style="text-align: -webkit-auto; line-height: normal; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class="">Department of Astronomy<br class="">Ohio State University<br class=""><br class=""></div><div style="text-align: -webkit-auto; line-height: normal; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">My Projects:</div><div style="text-align: -webkit-auto; line-height: normal; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><a href="http://nightlightapp.io" class="">http://nightlightapp.io</a><br class="">http://trillianverse.org</div><div style="text-align: -webkit-auto; line-height: normal; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><a href="http://scicoder.org" class="">http://scicoder.org</a><br class=""><br class=""></div></div></div></div></div></div></div>
</div>
<br class=""></body></html>