<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sans-serif; "><div><div>Hi Ian.</div><div><div><br></div><div>Yes, I saw the McLachlan/doc directory, but of course that won't show up in a Cactus-generated ThornGuide, even if it *did* contain the information we're talking about.</div></div></div><div><br></div><div>It's true that thorn documentation can easily go out of date, but if the .tex file is date-stamped (or even release-stamped), it should inform the reader as to how up-to-date it is. And the current alternative is no documentation at all ...</div><div><br></div><div>Bernard</div><div><br></div><span id="OLK_SRC_BODY_SECTION"><div style="font-family:Calibri; font-size:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt"><span style="font-weight:bold">From: </span> Ian Hinder <<a href="mailto:ian.hinder@aei.mpg.de">ian.hinder@aei.mpg.de</a>><br><span style="font-weight:bold">Date: </span> Tuesday, April 2, 2013 5:28 PM<br><span style="font-weight:bold">To: </span> Bernard Kelly <<a href="mailto:bernard.j.kelly@nasa.gov">bernard.j.kelly@nasa.gov</a>><br><span style="font-weight:bold">Cc: </span> "<a href="mailto:users@einsteintoolkit.org">users@einsteintoolkit.org</a>" <<a href="mailto:users@einsteintoolkit.org">users@einsteintoolkit.org</a>><br><span style="font-weight:bold">Subject: </span> Re: [Users] Cactus documentation in Kranc-generated thorns?<br></div><div><br></div><div><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><br><div><div>On 2 Apr 2013, at 23:16, "Kelly, Bernard J. (GSFC-660.0)[UNIVERSITY OF MARYLAND BALTIMORE COUNTY]" <<a href="mailto:bernard.j.kelly@nasa.gov">bernard.j.kelly@nasa.gov</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">Hi.<br><br>
I recently went through the main McLachlan_BSSN.m Kranc/Mathematica<br>
script, noting the exact form of the BSSNOK evolution equations, as well<br>
as their CCZ4 and GSFC variants. It occurred to me that these would be<br>
useful things to have in a human-readable format, as part of the ML_BSSN<br>
(say) thorn documentation. But of course, there *is* not ML_BSSN/doc<br>
directory by default.<br><br>
Can McLachlan.m incorporate external documentation? Perhaps something<br>
stored in the "prototype" subdirectory could be added to the newly<br>
generated thorn?<br></blockquote><div><br></div><div>There is arrangement documentation in McLachlan/doc. This could be added to. I have always wanted Kranc to output documentation LaTeX files including the equations in tensorial form, but have not implemented this. One problem was that there was no good
way to automatically line-break the equations in LaTeX. I think there are some hacks, but nothing reliable. I would prefer the equation documentation to be automatically-generated, as otherwise it risks becoming out of date.</div></div><br><div apple-content-edited="true"><span class="Apple-style-span" style="border-collapse: separate; font-family: Helvetica; border-spacing: 0px; font-size: medium; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><span class="Apple-style-span" style="border-collapse: separate; color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-border-horizontal-spacing: 0px; -webkit-border-vertical-spacing: 0px; -webkit-text-decorations-in-effect: none; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div>-- </div><div>Ian Hinder</div><div><a href="http://numrel.aei.mpg.de/people/hinder">http://numrel.aei.mpg.de/people/hinder</a></div></div></span></div></span></div></span></span></div><br></div></div></span></body></html>