<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 15 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
p.MsoPlainText, li.MsoPlainText, div.MsoPlainText
{mso-style-priority:99;
mso-style-link:"Plain Text Char";
margin:0cm;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
span.PlainTextChar
{mso-style-name:"Plain Text Char";
mso-style-priority:99;
mso-style-link:"Plain Text";
font-family:"Calibri",sans-serif;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-NZ link="#0563C1" vlink="#954F72"><div class=WordSection1><p class=MsoPlainText>>> Break will not work in map definition from maps. Only sequence of particular maps works. <o:p></o:p></p><p class=MsoPlainText><o:p> </o:p></p><p class=MsoPlainText>>OK, now how come I didn't know that?!<o:p></o:p></p><p class=MsoPlainText><o:p> </o:p></p><p class=MsoPlainText>>Whenever I make maps, I have been putting "break" in there, and it has happened to work because I will always put them in the right order anyway. It doesn't show any error message, and just silently ignores them. (It doesn't hurt to have it there, if only just to help mental understanding of the layers.)<o:p></o:p></p><p class=MsoPlainText><o:p> </o:p></p><p class=MsoPlainText>>But even the Therion book does it - see the "displaying overlaying maps in offset" section. When defining "break" it doesn't say that it applies only to scraps and not maps. And when defining "map" syntax, it actually shows you putting a map reference, then "break" then another map reference.<o:p></o:p></p><p class=MsoPlainText><o:p> </o:p></p><p class=MsoPlainText>>This should really be stated very explicitly, since it is not at all consistent with what the book shows. Are you sure it's not a bug?<o:p></o:p></p><p class=MsoPlainText><o:p> </o:p></p><p class=MsoPlainText>>I was told previously that maps represent their scraps, so a map that references two maps could just be thought of as the combined list of scraps (and breaks) within them. But as you said, it seems to implicitly add a "break" at the end of each child map.<o:p></o:p></p><p class=MsoPlainText><o:p> </o:p></p><p class=MsoPlainText>>Could someone authoritatively state the intended behaviour here, because either a bug needs to be fixed, or the documentation needs to be updated to match the implementation. I will happily file the required bug report accordingly.<o:p></o:p></p><p class=MsoPlainText><o:p> </o:p></p><p class=MsoPlainText>>Cheers :)<o:p></o:p></p><p class=MsoPlainText>>Tarquin<o:p></o:p></p><p class=MsoPlainText>_______________________________________________<o:p></o:p></p><p class=MsoPlainText><span style='color:black'><o:p> </o:p></span></p><p class=MsoPlainText><span style='color:black'>Hi Tarquin<o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'>Don't worry, it took me 12 years to discover that break was completely ineffective for maps that contain maps!<o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'><o:p> </o:p></span></p><p class=MsoPlainText><span style='color:black'>Last month Stacho announced a new 'maps [on]off' feature <a href="https://www.mail-archive.com/therion@speleo.sk/msg07571.html">https://www.mail-archive.com/therion@speleo.sk/msg07571.html</a><o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'>It adds some more reporting to the therion.log, that includes map definitions and elevations. Is quite informative, but as yet quite buggy, or else it is showing up some hither to unnoticed problem with my datasets. Current issues include altitudes reported as an overflow value if a scrap is empty, and if a map is defined from maps or includes a map defined from a survey centreline. Also ‘maps off’ takes 4x longer to compile and produces pdfs 15x larger. Is a problem as ‘maps off’ is a nice way to disable offsets and cross-sections for overview maps. I mention ‘maps’ as it is indirectly related to ‘break’. It provides useful insights, and warrants a wiki article once its behaviour settles down.<o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'><o:p> </o:p></span></p><p class=MsoPlainText><span style='color:black'>I'm certainly not authoritative, but I think the ‘break’ behaviour is, and is intended to be, as follows;<o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'>• <b>Breaks are required for maps defined from scraps</b> if you want one set of scraps to render over another.<o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'>• <b>Breaks are not required for maps defined from maps</b> (as there is an automatic break inferred by Therion between every map in the definition).<o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'>• However <b>a break placed in a map defined from maps will not cause any error</b>. It is perhaps useful for the map author to use a break to clarify how main levels of cave are subdivided.<o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'>• Items at the top of a map definition list are taken to be the highest level passages, and render over top of items below, regardless of their average elevation based on centreline stations.<o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'><o:p> </o:p></span></p><p class=MsoPlainText><span style='color:black'>The 10 June commit on Github appears to correct some of the issues in the Therion Book that you mention, but for some reason they don’t seem to have turned up in the latest version that I downloaded. The issue is with the documentation I think.<o:p></o:p></span></p><p class=MsoPlainText><span style='color:black'><o:p> </o:p></span></p><p class=MsoPlainText><span style='color:black'>Bruce<o:p></o:p></span></p></div></body></html>