<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.EmailStyle18
        {mso-style-type:personal;
        font-family:"Calibri",sans-serif;}
span.EmailStyle20
        {mso-style-type:personal-reply;
        font-family:"Calibri",sans-serif;}
.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:1017804987;
        mso-list-type:hybrid;
        mso-list-template-ids:-166840938 -1722655130 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;
        margin-left:.75in;
        text-indent:-.25in;
        font-family:"Calibri",sans-serif;
        mso-fareast-font-family:Calibri;}
@list l0:level2
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        margin-left:1.25in;
        text-indent:-.25in;
        font-family:"Courier New";}
@list l0:level3
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        margin-left:1.75in;
        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;
        margin-left:2.25in;
        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;
        margin-left:2.75in;
        text-indent:-.25in;
        font-family:"Courier New";}
@list l0:level6
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        margin-left:3.25in;
        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;
        margin-left:3.75in;
        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;
        margin-left:4.25in;
        text-indent:-.25in;
        font-family:"Courier New";}
@list l0:level9
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        margin-left:4.75in;
        text-indent:-.25in;
        font-family:Wingdings;}
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">
<p class="MsoNormal">Your recollection is correct.&nbsp; The early adopters (Windows division) manually specified and maintained dependencies.&nbsp; A few noteworthy points:<o:p></o:p></p>
<ul style="margin-top:0in" type="disc">
<li class="MsoListParagraph" style="margin-left:.25in;mso-list:l0 level1 lfo1">The team was primarily interested in componentization, i.e. enforcement of components boudnaries<o:p></o:p></li><li class="MsoListParagraph" style="margin-left:.25in;mso-list:l0 level1 lfo1">The build system modification needed for modules were local and minimal (because of source file suffixes)<o:p></o:p></li></ul>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">The Developer division, which Visual C&#43;&#43; is part of, is working on build systems support.
<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div style="border:none;border-left:solid blue 1.5pt;padding:0in 0in 0in 4.0pt">
<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> Thursday, January 10, 2019 12:04 PM<br>
<b>To:</b> WG21 Tooling Study Group SG15 &lt;tooling@open-std.org&gt;<br>
<b>Subject:</b> Re: [Tooling] Modules naming<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<p class="MsoNormal">Microsoft has some internal user experience as well.&nbsp; It is my (likely flawed) understanding that those internal users maintained dependency information by hand, rather than automatically generate it.<o:p></o:p></p>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div style="border:none;border-left:solid blue 1.5pt;padding:0in 0in 0in 4.0pt">
<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>Corentin<br>
<b>Sent:</b> Thursday, January 10, 2019 1:52 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 naming<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<p class="MsoNormal">I suspect it will be a while (several years) before we start to see large projects transitioning fully to modules and consumed as such by tools doing automatic dependency scanning etc.<o:p></o:p></p>
<div>
<p class="MsoNormal">My understanding is that there is little large scale implementation experience as far as tooling and build systems are concerned ( there is plenty&nbsp; _compilers_ implementation experience, and some build system implementation (and usage of
 modules) experience - mostly in build2).<o:p></o:p></p>
<div>
<div>
<div>
<div>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
<div>
<div>
<p class="MsoNormal">On Thu, 10 Jan 2019 at 18:47 JF Bastien &lt;<a href="mailto:cxx@jfbastien.com">cxx@jfbastien.com</a>&gt; wrote:<o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<p class="MsoNormal">On Thu, Jan 10, 2019 at 6:53 AM Corentin &lt;<a href="mailto:corentin.jabot@gmail.com" target="_blank">corentin.jabot@gmail.com</a>&gt; wrote:<br>
&gt;<br>
&gt; Hello.<br>
&gt; I would like to suggest two modules related proposals that I think SG15 should look at.<br>
&gt;<br>
&gt; - Compiler enforced mapping between module names and module interface file (resource) name.<br>
<br>
Why does SG15 need to do this, versus someone implementing it in an<br>
open-source toolchain, trying it out, and bringing what using it<br>
taught them to SG15?<br>
<br>
<br>
&gt; Currently, modules interfaces can be declared in any file - which makes dependency scanning more tedious than it needs to be and have performance implications<br>
&gt; (The build system needs to open all files to gather a list of modules) - notably when the build system tries to start building while the dependency graph isn't yet complete.<br>
&gt;<br>
&gt; Tools ( ide, code servers, indexers, refactoring) may also greatly benefit from an easier way to locate the source file which declares a module.<br>
&gt;<br>
&gt; The specifics of the mapping are open to bikeshedding. However, I think we would have better luck sticking to something simple like &lt;module identifier&gt; &lt;=&gt; &lt;file name&gt;.&lt;extension&gt;<br>
&gt; (The standardese would mention resource identifier rather than filename)<br>
&gt;<br>
&gt; - A standing document giving guidelines for modules naming.<br>
&gt;<br>
&gt; The goal is to take everything the community had to learn the hard way about header naming over the past 30 years and apply it to modules by providing a set of guidelines<br>
&gt; that could be partially enforced by build system vendors.<br>
&gt; Encouraging consistency and uniqueness of module identifiers across the industry is I think a necessary step towards sane package management.<br>
&gt; Note that the standard requires uniqueness of modules identifiers within (the standard definition of) a program but says little about a way to ensure this uniqueness.<br>
&gt;<br>
&gt; Here is a rough draft of what I think would be good guidelines, partially inspired by what is done by other languages facing similar issues.<br>
&gt;<br>
&gt; Prefix module names with an entity and/or a project name to prevent modules from different companies, entities and projects of declaring the same module names.<br>
&gt; Exported top-level namespaces should have a name identic to the project name used as part of the name of the module(s) from which it is exported.<br>
&gt; Do not export multiple top-level namespaces<br>
&gt; Do not export entities in the global namespace outside of the global module fragment.<br>
&gt; Organize modules hierarchically. For example, if both modules example.foo and example.foo.bar exist as part of the public API of example, example.foo should reexport example.foo.bar<br>
&gt; Avoid common names such as util and core for module name prefix and top-level namespace names.<br>
&gt; Use lower-case module names<br>
&gt; Do not use characters outside of the basic source character set in module name identifiers.<br>
&gt;<br>
&gt; My hope is that these 2 proposals (whose impact on the standard is minimal) would make it easier for current tooling to deal with modules<br>
&gt; while making possible for example to design dependency managers and build systems able to work at the module level.<br>
&gt;<br>
&gt; I'd love to gather feedback and opinions before going further in that direction.<br>
&gt; Thanks a lot!<br>
&gt;<br>
&gt; Corentin<br>
&gt;<br>
&gt; PS: For a bit of background, I talked about these issues there<br>
&gt;<br>
&gt; <a href="https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Furldefense.proofpoint.com%2Fv2%2Furl%3Fu%3Dhttps-3A__cor3ntin.github.io_posts_modules-5Fmapping_%26d%3DDwMFaQ%26c%3DI_0YwoKy7z5LMTVdyO6YCiE2uzI1jjZZuIPelcSjixA%26r%3Dy8mub81SfUi-UCZRX0Vl1g%26m%3DwMVCtcOClnK6fSH49PWMZlyAyj-tqPvl6ev_V2t1am4%26s%3Dc6Usu_rfiWBfNCrWSIh0vPbUS5kf84PjTC5qGGkhZ1k%26e%3D&amp;data=02%7C01%7Cgdr%40microsoft.com%7C4d78895bae31408b2c6e08d6773bc032%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636827495853687974&amp;sdata=Youst%2BzTipkaf5mNy28vLqRz4zY8hbRw7c%2F87ev43s0%3D&amp;reserved=0" target="_blank">
https://cor3ntin.github.io/posts/modules_mapping/</a><br>
&gt; <a href="https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Furldefense.proofpoint.com%2Fv2%2Furl%3Fu%3Dhttps-3A__cor3ntin.github.io_posts_modules-5Fnaming_%26d%3DDwMFaQ%26c%3DI_0YwoKy7z5LMTVdyO6YCiE2uzI1jjZZuIPelcSjixA%26r%3Dy8mub81SfUi-UCZRX0Vl1g%26m%3DwMVCtcOClnK6fSH49PWMZlyAyj-tqPvl6ev_V2t1am4%26s%3DCHSmj32vYThBch_8Q3k88FHC0qOTfhyYhfv-TlT_se0%26e%3D&amp;data=02%7C01%7Cgdr%40microsoft.com%7C4d78895bae31408b2c6e08d6773bc032%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636827495853697986&amp;sdata=gJ1%2FxnvH4aTpygFPPaeX3W56DmzY%2Bytnhsr2VfrVs6s%3D&amp;reserved=0" target="_blank">
https://cor3ntin.github.io/posts/modules_naming/</a><br>
&gt;<br>
&gt;<br>
&gt; _______________________________________________<br>
&gt; Tooling mailing list<br>
&gt; <a href="mailto:Tooling@isocpp.open-std.org" target="_blank">Tooling@isocpp.open-std.org</a><br>
&gt; <a href="https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Furldefense.proofpoint.com%2Fv2%2Furl%3Fu%3Dhttp-3A__www.open-2Dstd.org_mailman_listinfo_tooling%26d%3DDwMFaQ%26c%3DI_0YwoKy7z5LMTVdyO6YCiE2uzI1jjZZuIPelcSjixA%26r%3Dy8mub81SfUi-UCZRX0Vl1g%26m%3DwMVCtcOClnK6fSH49PWMZlyAyj-tqPvl6ev_V2t1am4%26s%3DBRyNt2DjC3eSa4B8CF5n67_k_0KPZUtumMt2FVQtE9Y%26e%3D&amp;data=02%7C01%7Cgdr%40microsoft.com%7C4d78895bae31408b2c6e08d6773bc032%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636827495853697986&amp;sdata=Ljp4PQFYoo4WfpRotOga80ptmhVjeMEET0V1iX8DOK0%3D&amp;reserved=0" target="_blank">
http://www.open-std.org/mailman/listinfo/tooling</a><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%3Dhttp-3A__www.open-2Dstd.org_mailman_listinfo_tooling%26d%3DDwMFaQ%26c%3DI_0YwoKy7z5LMTVdyO6YCiE2uzI1jjZZuIPelcSjixA%26r%3Dy8mub81SfUi-UCZRX0Vl1g%26m%3DwMVCtcOClnK6fSH49PWMZlyAyj-tqPvl6ev_V2t1am4%26s%3DBRyNt2DjC3eSa4B8CF5n67_k_0KPZUtumMt2FVQtE9Y%26e%3D&amp;data=02%7C01%7Cgdr%40microsoft.com%7C4d78895bae31408b2c6e08d6773bc032%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C636827495853707995&amp;sdata=Xuwzj%2BROVkjbRwcxYY1yKdPaxwX6JA4kfokMBIYoIts%3D&amp;reserved=0" target="_blank">http://www.open-std.org/mailman/listinfo/tooling</a><o:p></o:p></p>
</blockquote>
</div>
</div>
</div>
</div>
</body>
</html>