<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:Wingdings;
        panose-1:5 0 0 0 0 0 0 0 0 0;}
@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:0in;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:blue;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {mso-style-priority:99;
        color:purple;
        text-decoration:underline;}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
        {mso-style-priority:34;
        margin-top:0in;
        margin-right:0in;
        margin-bottom:0in;
        margin-left:.5in;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
p.msonormal0, li.msonormal0, div.msonormal0
        {mso-style-name:msonormal;
        mso-margin-top-alt:auto;
        margin-right:0in;
        mso-margin-bottom-alt:auto;
        margin-left:0in;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
span.EmailStyle19
        {mso-style-type:personal;
        font-family:"Calibri",sans-serif;}
span.EmailStyle20
        {mso-style-type:personal;
        font-family:"Calibri",sans-serif;}
span.EmailStyle21
        {mso-style-type:personal;
        font-family:"Calibri",sans-serif;}
span.EmailStyle23
        {mso-style-type:personal-reply;
        font-family:"Calibri",sans-serif;
        color:windowtext;}
.MsoChpDefault
        {mso-style-type:export-only;
        font-size:10.0pt;}
@page WordSection1
        {size:8.5in 11.0in;
        margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
        {page:WordSection1;}
/* List Definitions */
@list l0
        {mso-list-id:854536517;
        mso-list-type:hybrid;
        mso-list-template-ids:1803427860 194823732 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l0:level1
        {mso-level-start-at:0;
        mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Wingdings;
        mso-fareast-font-family:Calibri;
        mso-bidi-font-family:"Times New Roman";}
@list l0:level2
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:"Courier New",serif;}
@list l0:level3
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Wingdings;}
@list l0:level4
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Symbol;}
@list l0:level5
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:"Courier New",serif;}
@list l0:level6
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Wingdings;}
@list l0:level7
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Symbol;}
@list l0:level8
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:"Courier New",serif;}
@list l0:level9
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Wingdings;}
@list l1
        {mso-list-id:1994329873;
        mso-list-type:hybrid;
        mso-list-template-ids:-1593921884 1021371634 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l1:level1
        {mso-level-start-at:0;
        mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Wingdings;
        mso-fareast-font-family:Calibri;
        mso-bidi-font-family:"Times New Roman";}
@list l1:level2
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:"Courier New",serif;}
@list l1:level3
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Wingdings;}
@list l1:level4
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Symbol;}
@list l1:level5
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:"Courier New",serif;}
@list l1:level6
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Wingdings;}
@list l1:level7
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Symbol;}
@list l1:level8
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:"Courier New",serif;}
@list l1:level9
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-.25in;
        font-family:Wingdings;}
@list l2
        {mso-list-id:2136945152;
        mso-list-template-ids:-1118513584;}
@list l2:level1
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:.5in;
        mso-level-number-position:left;
        text-indent:-.25in;
        mso-ansi-font-size:10.0pt;
        font-family:Symbol;}
@list l2:level2
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:1.0in;
        mso-level-number-position:left;
        text-indent:-.25in;
        mso-ansi-font-size:10.0pt;
        font-family:Symbol;}
@list l2:level3
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:1.5in;
        mso-level-number-position:left;
        text-indent:-.25in;
        mso-ansi-font-size:10.0pt;
        font-family:Symbol;}
@list l2:level4
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:2.0in;
        mso-level-number-position:left;
        text-indent:-.25in;
        mso-ansi-font-size:10.0pt;
        font-family:Symbol;}
@list l2:level5
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:2.5in;
        mso-level-number-position:left;
        text-indent:-.25in;
        mso-ansi-font-size:10.0pt;
        font-family:Symbol;}
@list l2:level6
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:3.0in;
        mso-level-number-position:left;
        text-indent:-.25in;
        mso-ansi-font-size:10.0pt;
        font-family:Symbol;}
@list l2:level7
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:3.5in;
        mso-level-number-position:left;
        text-indent:-.25in;
        mso-ansi-font-size:10.0pt;
        font-family:Symbol;}
@list l2:level8
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:4.0in;
        mso-level-number-position:left;
        text-indent:-.25in;
        mso-ansi-font-size:10.0pt;
        font-family:Symbol;}
@list l2:level9
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:4.5in;
        mso-level-number-position:left;
        text-indent:-.25in;
        mso-ansi-font-size:10.0pt;
        font-family:Symbol;}
ol
        {margin-bottom:0in;}
ul
        {margin-bottom:0in;}
--></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-US" link="blue" vlink="purple">
<div class="WordSection1">
<ul style="margin-top:0in" type="disc">
<li class="MsoListParagraph" style="margin-left:0in;mso-list:l1 level1 lfo4">In the header generation cases I have encountered, there tend to be a small number of source files in some domain specific language.&nbsp; I can generate all the headers that originate
 from that small set of source files.&nbsp; The small number of inputs makes the process tolerable.<o:p></o:p></li></ul>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">I have seen from small, to medium, to large – Windows source code would be an example of large.<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">With modules, I expect the number of files need needing scanning for dependency to be small.&nbsp; Of course if you adopt a programming style that conflates modules with Java classes, where you get one module per class, you get what you ask
 for…<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<ul style="margin-top:0in" type="disc">
<li class="MsoListParagraph" style="margin-left:0in;mso-list:l1 level1 lfo4">If I apply that same practice to modules, would I need to scan the entirety of my project, boost, qt, and any other dependencies I have before compiling anything?&nbsp; My current understanding
 is that I would need to.<o:p></o:p></li></ul>
<p class="MsoNormal">How so?<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<ul style="margin-top:0in" type="disc">
<li class="MsoListParagraph" style="margin-left:0in;mso-list:l1 level1 lfo4">With vigorous hand-waving<o:p></o:p></li></ul>
<p class="MsoNormal">Which I am not doing, and won’t do.<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<ul style="margin-top:0in" type="disc">
<li class="MsoListParagraph" style="margin-left:0in;mso-list:l1 level1 lfo4">, you could say that each of those external projects could provide that dependency mapping for their project so that clients don’t need to.&nbsp; But which file format(s) do they choose
 to distribute to advertise this mapping?<o:p></o:p></li></ul>
<p class="MsoNormal">That is one possible solution.&nbsp; Both Tom and I have suggested (independently) MANIFEST-style file.&nbsp; There are other proposals on the table by Isabelle and Richard.<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<ul style="margin-top:0in" type="disc">
<li class="MsoListParagraph" style="margin-left:0in;mso-list:l1 level1 lfo4">Would every library need to provide something akin to a CMakeLists.txt, Visual Studio project, bazel build file, etc… in order to be usable in those environments?<o:p></o:p></li></ul>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">My view is that – regardless of modules – we (the C&#43;&#43; community) do need to have a common way to describe components (e.g. where installed build artefacts go, etc.)<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">I look at Maven, and say “yup, they got something right.”<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">-- Gaby<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> tooling-bounces@open-std.org &lt;tooling-bounces@open-std.org&gt;
<b>On Behalf Of </b>Ben Craig<br>
<b>Sent:</b> Friday, February 1, 2019 1:01 PM<br>
<b>To:</b> WG21 Tooling Study Group SG15 &lt;tooling@open-std.org&gt;<br>
<b>Subject:</b> Re: [Tooling] Modules<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">In the header generation cases I have encountered, there tend to be a small number of source files in some domain specific language.&nbsp; I can generate all the headers that originate from that small set of source files.&nbsp; The small number of
 inputs makes the process tolerable.<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">If I apply that same practice to modules, would I need to scan the entirety of my project, boost, qt, and any other dependencies I have before compiling anything?&nbsp; My current understanding is that I would need to.<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">With vigorous hand-waving, you could say that each of those external projects could provide that dependency mapping for their project so that clients don’t need to.&nbsp; But which file format(s) do they choose to distribute to advertise this
 mapping?&nbsp; Would every library need to provide something akin to a CMakeLists.txt, Visual Studio project, bazel build file, etc… in order to be usable in those environments?<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> <a href="mailto:tooling-bounces@open-std.org">tooling-bounces@open-std.org</a> &lt;<a href="mailto:tooling-bounces@open-std.org">tooling-bounces@open-std.org</a>&gt;
<b>On Behalf Of </b>Gabriel Dos Reis<br>
<b>Sent:</b> Friday, February 1, 2019 2:42 PM<br>
<b>To:</b> WG21 Tooling Study Group SG15 &lt;<a href="mailto:tooling@open-std.org">tooling@open-std.org</a>&gt;<br>
<b>Subject:</b> Re: [Tooling] Modules<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<ul style="margin-top:0in" type="disc">
<li class="MsoListParagraph" style="margin-left:0in;mso-list:l0 level1 lfo3">** This isn’t 100% true, as generated headers from tools like SWIG, protobufs, thrift, and I think some QT things, all require those headers to be generated before you can compile
 your .cpp files.&nbsp; In my experience, this is usually handled by doing all the header generation early in the build process, before any .cpp files are built, and that approach doesn’t scale well to modules.&nbsp; build2 does this different and more correctly, and
 I suspect that Google’s internal build process is similar.<o:p></o:p></li></ul>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">You can think of the metadata generation as generation of the headers, early in the build process.<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> <a href="mailto:tooling-bounces@open-std.org">tooling-bounces@open-std.org</a> &lt;<a href="mailto:tooling-bounces@open-std.org">tooling-bounces@open-std.org</a>&gt;
<b>On Behalf Of </b>Ben Craig<br>
<b>Sent:</b> Friday, February 1, 2019 7:47 AM<br>
<b>To:</b> WG21 Tooling Study Group SG15 &lt;<a href="mailto:tooling@open-std.org">tooling@open-std.org</a>&gt;<br>
<b>Subject:</b> Re: [Tooling] Modules<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">Current state of things:&nbsp; Within a library*, no dependency information** is needed in order to generate a clean build.&nbsp; I can build all my .cpp files in any order I want.<o:p></o:p></p>
<p class="MsoNormal">Future state of things: With a library, dependency information will need to be generated / provided in order to generate a clean build.&nbsp; I need to build my modules in dependency order.&nbsp; The correct order depends upon the contents of the
 modules.<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">* Across libraries, dependency order matters again because later linking steps depend on earlier linking steps.<o:p></o:p></p>
<p class="MsoNormal">** This isn’t 100% true, as generated headers from tools like SWIG, protobufs, thrift, and I think some QT things, all require those headers to be generated before you can compile your .cpp files.&nbsp; In my experience, this is usually handled
 by doing all the header generation early in the build process, before any .cpp files are built, and that approach doesn’t scale well to modules.&nbsp; build2 does this different and more correctly, and I suspect that Google’s internal build process is similar.<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> <a href="mailto:tooling-bounces@open-std.org">tooling-bounces@open-std.org</a> &lt;<a href="mailto:tooling-bounces@open-std.org">tooling-bounces@open-std.org</a>&gt;
<b>On Behalf Of </b>Titus Winters<br>
<b>Sent:</b> Friday, February 1, 2019 8:25 AM<br>
<b>To:</b> WG21 Tooling Study Group SG15 &lt;<a href="mailto:tooling@open-std.org">tooling@open-std.org</a>&gt;<br>
<b>Subject:</b> Re: [Tooling] Modules<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<p class="MsoNormal">No, naturally not.&nbsp; The build system handles transitivity and making transitive includes available in each parallel build shard.<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
</div>
<div>
<p class="MsoNormal">I'm just trying to figure out how much of this is fundamental to all build systems (I don't think it is) vs. &quot;I just want globbing to be enough&quot; (I also don't think it's that).&nbsp; There's some subtlety in here that I think is getting lost
 and conflated with &quot;stuff works this way now&quot;. Of course if we change things, things will be different.&nbsp;<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<p class="MsoNormal">On Fri, Feb 1, 2019 at 9:20 AM Boris Kolpackov &lt;<a href="mailto:boris@codesynthesis.com">boris@codesynthesis.com</a>&gt; wrote:<o:p></o:p></p>
</div>
<p class="MsoNormal">Titus Winters &lt;<a href="mailto:titus@google.com" target="_blank">titus@google.com</a>&gt; writes:<br>
<br>
&gt; We've been doing explicit statements of the dependency chain for our<br>
&gt; codebase for almost 20 years, and I've literally never heard a new hire (or<br>
&gt; anyone else) say it is a &quot;huge&quot; burden.<br>
<br>
The question is to what degree. I am sure you don't require new<br>
hires to manually specify for each translation unit dependencies<br>
on headers it includes, transitively?<br>
<br>
But that would sure make for a nice hazing ritual.<br>
_______________________________________________<br>
Tooling mailing list<br>
<a href="mailto:Tooling@isocpp.open-std.org" target="_blank">Tooling@isocpp.open-std.org</a><br>
<a href="https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Furldefense.proofpoint.com%2Fv2%2Furl%3Fu%3Dhttps-3A__nam06.safelinks.protection.outlook.com_-3Furl-3Dhttps-253A-252F-252Furldefense.proofpoint.com-252Fv2-252Furl-253Fu-253Dhttp-2D3A-5F-5Fwww.open-2D2Dstd.org-5Fmailman-5Flistinfo-5Ftooling-2526d-253DDwMFaQ-2526c-253DI-5F0YwoKy7z5LMTVdyO6YCiE2uzI1jjZZuIPelcSjixA-2526r-253Dy8mub81SfUi-2DUCZRX0Vl1g-2526m-253DeaeY1tSTEuCzTo9xdX44sV6O7OLiE17toll5vn7KdAI-2526s-253Dbctoohp0MRXTUcbLj9zhZjut-2DQJKdYHhKi2-5Fwff-5FSKk-2526e-253D-26data-3D02-257C01-257Cgdr-2540microsoft.com-257Cb88dea0d02ba44acd4a608d6885c9591-257C72f988bf86f141af91ab2d7cd011db47-257C1-257C0-257C636846328562989351-26sdata-3DvNZY4Lu2DOLksaX-252B2nSqtNMsA-252FHHdQZF1zIjh7AQ6eY-253D-26reserved-3D0%26d%3DDwMGaQ%26c%3DI_0YwoKy7z5LMTVdyO6YCiE2uzI1jjZZuIPelcSjixA%26r%3Dy8mub81SfUi-UCZRX0Vl1g%26m%3DfLj8zoWsErmIt1ruqqviQZCc6zBJ6AoprP0fx17_NbA%26s%3D0krHG0s9fTdIoLSXm5K7faOhKLkktaDA2GEvf1O0XYY%26e%3D&amp;data=02%7C01%7Cgdr%40microsoft.com%7C04e0b2f75993409024e208d68888607c%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636846516657415294&amp;sdata=Begukdi7WMpWjsFT8czjP%2Bax%2BlHUEVBHMuCQcJCGiWg%3D&amp;reserved=0" target="_blank">http://www.open-std.org/mailman/listinfo/tooling</a><o:p></o:p></p>
</div>
</body>
</html>