Merge remote-tracking branch 'upstream/master' into stable

MartinNowak · MartinNowak · commit 354d2ee17b0a · 2020-04-23T03:25:52.000+02:00
diff --git a/css/style.css b/css/style.css
@@ -1552,11 +1552,13 @@ textarea.d_code_stdin, textarea.d_code_args
     background: white;
     margin-left: 2px;
     outline: none;
+    hyphens: none;
 }
 
 pre.d_code_output {
     border: none;
     max-height: 30em;
+    overflow: auto;
 }
 
 div.d_code {margin: 0; padding: 0; background: #F5F5F5;}
@@ -1572,6 +1574,13 @@ div.d_code_output, div.d_code_stdin, div.d_code_args, div.d_code_unittest
 
 .d_code_title {font-weight: bold;padding: 5px;}
 
+pre.d_code
+{
+    overflow-x: auto;
+    white-space: pre;
+    word-wrap: unset;
+}
+
 .CodeMirror-wrap {padding: 3px;}
 .CodeMirror {line-height: normal; border: 1px solid #CCC; background: #FCFCFC; height: auto}
 .cm-s-eclipse .CodeMirror-matchingbracket {border:1px solid grey;color:black !important;}
diff --git a/d-keyring.gpg b/d-keyring.gpg
diff --git a/d-keyring.gpg.sig b/d-keyring.gpg.sig
diff --git a/foundation/sponsors.dd b/foundation/sponsors.dd
@@ -19,6 +19,27 @@ $(P On this page, we recognize some of those who have made monetary donations to
 Each $(LINK2 $(ROOT_DIR)foundation/donate.html, donation), big and small, enables us to keep working toward our goals.
 )
 
+$(H2 Corporate and Organizational Sponsors)
+
+$(DIVC orgs-using-d center,
+    $(DORG Symmetry Investments, http://symmetryinvestments.com/about-us/, symmetry.png,
+        Alternative Investment Management,
+        Analytics and investment tools.
+        $(LINK_ROW
+            $(FA_TALK www.youtube.com/watch?v=xJy6ifCekCE&index=34&list=PL3jwVPmk_PRxo23yyoc0Ip_cP3-rCm7eB, Excel-D) $(FA_SEPARATOR)
+            $(FA_GITHUB symmetryinvestments)
+        )
+    )
+    $(DORG Weka.IO, http://www.weka.io, weka.png,
+        Software defined storage,
+        Complete distributed storage solution (over 200K LoC).
+        $(LINK_ROW
+            $(FA_TALK dconf.org/2016/talks/zvibel.html, DConf talk) $(FA_SEPARATOR)
+            $(FA_HIRING www.weka.io)
+        )
+    )
+)
+
 $(H2 Backers on OpenCollective)
 
 <script src='https://opencollective.com/dlang/banner.js?style={"a":{"color":"black"}}'></script>
@@ -32,7 +53,7 @@ $(LINK2 mailto:social@dlang.org, social@dlang.org). We're eager to add you to it
 
 $(UL
     $(LI Andrei Alexandrescu)
-    $(LI Symmetry Investments)
+    $(LI Etienne Cimon)
     $(LI John Hall)
     $(LI Gerhardus Jansen)
     $(LI Radu Racariu)
@@ -62,10 +83,55 @@ $(UL
 Macros:
     TITLE=D Language Foundation Sponsors
     SUBNAV=$(SUBNAV_FOUNDATION)
+    FA_HIRING=$(FA_ICON rocket) $(HTTP $1, Hiring)
+    FA_GITHUB=$(FA_ICON github) $(HTTPS github.com/$1, Github)
+    FA_TALK=$(FA_ICON youtube-play) $(HTTP $1, $2)
+    FA_SEPARATOR=&nbsp;
+    FA_TESTIMONIAL=$(FA_ICON heart)
+    FA_QUOTE=$(FA_ICON quote-left) $0 $(FA_ICON quote-right)
+    LINK_ROW=$(DIVC orgs-using-d-linkrow, $1)
+    DORGIMG=<a class="orgs-using-d-img-wrapper vcontainer-box" href="$1"><img class="vcontainer-element" src="$(ROOT_DIR)images/orgs-using-d/$2" /></a>
+    DORG=$(DIVC orgs-using-d-cell, $(DORGIMG $2, $3) <h3 class="dont-highlight-link">$(LINK2 $2, $1)</h3> $(P $(DIVC orgs-using-d-desc, $4 ) $(DIVC orgs-using-d-uses donthyphenate, $5)))
+
     EXTRA_HEADERS=$(T style,
         #opencollective-banner h2 {
           color: red;
         }
-
+        .orgs-using-d-cell {
+            width: 280px;
+            display: inline-block;
+            vertical-align: top;
+            margin-bottom: 0.5em;
+            padding-left: 25px;
+            padding-right: 25px;
+            padding-bottom: 10px;
+        }
+        .orgs-using-d h3 {
+        margin: 0.4em;
+        margin-left: 0;
+        margin-right: 0;
+        text-align: center;
+        }
+        .orgs-using-d-img-wrapper {
+            width: 280px;
+            height: 100px;
+            padding-bottom: 10px;
+            text-align: center;
+        }
+        .orgs-using-d img {
+            max-width: 280px;
+            max-height: 100px;
+        }
+        .orgs-using-d-desc {
+            font-style: italic;
+            margin-left: -1px;
+            margin-right: -1px;
+        }
+        .orgs-using-d-uses {
+            padding-top: 10px;
+        }
+        .orgs-using-d-linkrow {
+            padding-top: 5px;
+        }
     )
     _=
diff --git a/gpg_keys.dd b/gpg_keys.dd
@@ -5,31 +5,39 @@ $(H2 D Release Team)
 $(P Since 2.067.0 dmd binaries and git tags are signed by D's release managers. The following GnuPG keys can be used to verify those signatures.)
 
 $(PRE
-pub   4096R/0xAB8FE924C2F7E724 2014-09-01 [expires: 2020-03-25]
-      Key fingerprint = AFC7 DB45 693D 62BB 472B  F27B AB8F E924 C2F7 E724
-uid                            Martin Nowak (dawg) $(LT)me@dawg.eu$(GT)
-uid                            Martin Nowak $(LT)martin.nowak@plugintheworld.com$(GT)
-uid                            Martin Nowak $(LT)code@dawg.eu$(GT)
-uid                            Martin Nowak $(LT)martin@dlang.org$(GT)
-sub   4096R/0xB273811612BB1939 2015-02-27 [expires: 2020-03-25]
-sub   4096R/0xA78068C444E12E4D 2014-09-01 [expires: 2020-03-25]
-
-pub   2048R/0x5004F0FAD051576D 2016-01-29
-      Key fingerprint = BBED 1B08 8CED 7F95 8917  FBE8 5004 F0FA D051 576D
-uid                            Vladimir Panteleev $(LT)gpg@thecybershadow.net$(GT)
-sub   2048R/0x3850E93043EBB12C 2016-01-29
-
-pub   4096R/0x2055F76601A36FB0 2015-11-24 [expires: 2026-03-23]
-      Key fingerprint = 8FDB 8D35 7AF4 68A9 428A  CE3C 2055 F766 01A3 6FB0
-uid                            Sebastian Wilzbach $(LT)seb@wilzba.ch$(GT)
-uid                            Sebastian Wilzbach $(LT)sebi@wilzbach.me$(GT)
-sub   4096R/0xFEB1F8D40328010D 2015-11-24 [expires: 2020-11-22]
-
-pub   4096R/0x65394AFEF4A68565 2018-03-26 [expires: 2020-03-25]
-      Key fingerprint = F771 5881 4C19 E5E0 7BA1  079A 6539 4AFE F4A6 8565
-uid                            DLang Nightly (bot) $(LT)builder@nightlies.dlang.org$(GT)
-sub   4096R/0x318B84C8855CCD65 2018-03-26 [expires: 2020-03-25]
-sub   4096R/0xD2EDBA9B3200C132 2018-03-26 [expires: 2020-03-25]
+pub   rsa4096/0xAB8FE924C2F7E724 2014-09-01 [SC] [expires: 2020-03-25]
+      AFC7DB45693D62BB472BF27BAB8FE924C2F7E724
+uid                             Martin Nowak (dawg) $(LT)me@dawg.eu$(GT)
+uid                             Martin Nowak $(LT)martin.nowak@plugintheworld.com$(GT)
+uid                             Martin Nowak $(LT)code@dawg.eu$(GT)
+uid                             Martin Nowak $(LT)martin@dlang.org$(GT)
+sub   rsa4096/0xB273811612BB1939 2015-02-27 [S] [expires: 2020-03-25]
+sub   rsa4096/0xA78068C444E12E4D 2014-09-01 [E] [expires: 2020-03-25]
+
+pub   rsa2048/0x5004F0FAD051576D 2016-01-29 [SC]
+      BBED1B088CED7F958917FBE85004F0FAD051576D
+uid                             Vladimir Panteleev $(LT)gpg@thecybershadow.net$(GT)
+sub   rsa2048/0x3850E93043EBB12C 2016-01-29 [E]
+
+pub   rsa4096/0x2055F76601A36FB0 2015-11-24 [SC] [expires: 2026-03-23]
+      8FDB8D357AF468A9428ACE3C2055F76601A36FB0
+uid                             Sebastian Wilzbach $(LT)seb@wilzba.ch$(GT)
+uid                             Sebastian Wilzbach $(LT)sebi@wilzbach.me$(GT)
+sub   rsa4096/0xFEB1F8D40328010D 2015-11-24 [E] [expires: 2020-11-22]
+
+pub   rsa4096/0x65394AFEF4A68565 2018-03-26 [SC] [expires: 2020-03-25]
+      F77158814C19E5E07BA1079A65394AFEF4A68565
+uid                             DLang Nightly (bot) $(LT)builder@nightlies.dlang.org$(GT)
+sub   rsa4096/0x318B84C8855CCD65 2018-03-26 [S] [expires: 2020-03-25]
+sub   rsa4096/0xD2EDBA9B3200C132 2018-03-26 [E] [expires: 2020-03-25]
+
+pub   rsa4096/0xBCDD73FFC3EB6146 2020-03-12 [SC] [expires: 2022-03-12]
+      F46A10D0AB44C3D15DD65797BCDD73FFC3EB6146
+uid                             Martin Nowak $(LT)code@dawg.eu$(GT)
+uid                             Martin Nowak $(LT)martin.nowak@7learnings.com$(GT)
+uid                             Martin Nowak $(LT)martin@dlang.org$(GT)
+sub   rsa4096/0x9A813AD3C11508BC 2020-03-12 [E] [expires: 2022-03-12]
+sub   rsa4096/0xDB8C5218B9329CF8 2020-03-12 [S] [expires: 2022-03-12]
 )
 
 $(P You can also download them as $(LINK2 d-keyring.gpg,keyring) file.)
diff --git a/images/orgs-using-d/weka.png b/images/orgs-using-d/weka.png
diff --git a/index.dd b/index.dd
@@ -769,6 +769,7 @@ Macros:
             padding-left: 1em;
             position: relative;
             width: 32em;
+            max-width: 32em;
         }
 
         body#Home #content > .intro #your-code-here .tip
diff --git a/orgs-using-d.dd b/orgs-using-d.dd
@@ -201,14 +201,6 @@ $(DIVC orgs-using-d center,
             $(FA_GITHUB veelo/Pascal2D)
         )
     )
-    $(DORG Sociomantic, https://www.sociomantic.com, sociomantic.png,
-        Real-time personalized advertising,
-        Key infrastructure in D - main sponsor of D conference 2016 and 2017.
-        $(LINK_ROW
-            $(FA_TALK dconf.org/2016/talks/lucarella.html, DConf talk) $(FA_SEPARATOR)
-            $(FA_HIRING www.sociomantic.com/jobs/d-software-developer)
-        )
-    )
     $(DORG Symmetry Investments, http://symmetryinvestments.com/about-us/, symmetry.png,
         Alternative Investment Management,
         Analytics and investment tools.
diff --git a/spec/betterc.dd b/spec/betterc.dd
@@ -84,6 +84,7 @@ $(H2 $(LNAME2 retained, Retained Features))
     $(LI `switch` with strings)
     $(LI `final switch`)
     $(LI `unittest`)
+    $(LI $(DDSUBLINK spec/interfaceToC, calling_printf, `printf` format validation))
     )
 
 $(H3 $(LNAME2 unittests, Running unittests in `-betterC`))
diff --git a/spec/interfaceToC.dd b/spec/interfaceToC.dd
@@ -208,30 +208,79 @@ extern (C)
 ---
 
 
-$(H2 $(LNAME2 calling_printf, Calling printf()))
-
-        $(P This mostly means checking that the
-        $(LINK2 http://www.digitalmars.com/rtl/stdio.html#printf, printf format specifier)
-        matches the corresponding D data type.
-        Although printf is designed to handle 0 terminated strings,
-        not D dynamic arrays of chars, it turns out that since D
-        dynamic arrays are a length followed by a pointer to the data,
-        the $(D %.*s) format works:
-        )
+$(H2 $(LNAME2 calling_printf, Calling `printf()`))
 
-------
-void foo(char[] string)
+        $(P `printf` can be directly called from D code:)
+---
+import core.stdc.stdio;
+
+int main
 {
-    printf("my string is: %.*s\n", string.length, string.ptr);
+    printf("hello world\n");
+    return 0;
 }
-------
+---
+
+        $(P Printing values works as it does in C:)
+---
+int apples;
+printf("there are %d apples\n", apples);
+---
+        $(P Correctly matching the format specifier to the D type is necessary.
+        The D compiler recognizes the printf formats and diagnoses mismatches
+        with the supplied arguments. The specification for the formats
+        used by D is the C99 specification 7.19.6.1.
+        )
+
+        $(P A generous interpretation of what is a match between the argument
+        and format specifier is taken, for example, an unsigned type can
+        be printed with a signed format specifier. Diagnosed incompatibilites
+        are:
+        )
+
+        $(UL
+        $(LI incompatible sizes which may cause argument misalignment)
+        $(LI dereferencing arguments that are not pointers)
+        $(LI insufficient number of arguments)
+        $(LI struct, array and slice arguments are not allowed)
+        $(LI non-pointer arguments to `s` specifier)
+        $(LI non-Standard formats)
+        $(LI undefined behavior per C99)
+        )
+
+$(H3 Strings)
 
-        $(P The $(CODE printf) format string literal
-        in the example doesn't end with $(CODE '\0').
-        This is because string literals,
-        when they are not part of an initializer to a larger data structure,
-        have a $(CODE '\0') character helpfully stored after the end of them.
+        $(P A string cannot be printed directly. But `%.*s` can be used:
         )
+---
+string s = "betty";
+printf("hello %.*s\n", cast(int) s.length, s.ptr);
+---
+        $(P The cast to `int` is required.
+        )
+
+$(H3 `size_t` and `ptrdiff_t`)
+
+        $(P These use the `zd` and `dt` format specifiers respectively:
+        )
+
+---
+int* p, q;
+printf("size of an int is %zt, pointer difference is %td\n", int.sizeof, p - q);
+---
+
+$(H3 Non-Standard Format Specifiers)
+
+        $(P Non-Standard format specifiers will be rejected by the compiler.
+        Since the checking is only done for formats as string literals,
+        non-Standard ones can be used:
+        )
+---
+const char* format = "value: %K\n";
+printf(format, value);
+---
+
+$(H3 Modern Formatted Writing)
 
         $(P An improved D function for formatted output is
         $(CODE std.stdio.writef()).
diff --git a/spec/operatoroverloading.dd b/spec/operatoroverloading.dd
@@ -538,7 +538,7 @@ $(H2 $(LEGACY_LNAME2 Assignment, assignment, Assignment Operator Overloading))
     ---
     struct S
     {
-        // identiy assignment, allowed.
+        // identity assignment, allowed.
         void $(CODE_HIGHLIGHT opAssign)(S rhs);
 
         // not identity assignment, also allowed.

Original file line number	Diff line number	Diff line change
`@@ -769,6 +769,7 @@ Macros:`
`769`	`769`	`padding-left: 1em;`
`770`	`770`	`position: relative;`
`771`	`771`	`width: 32em;`
	`772`	`+ max-width: 32em;`
`772`	`773`	`}`
`773`	`774`
`774`	`775`	`body#Home #content > .intro #your-code-here .tip`
Original file line number	Diff line number	Diff line change
`@@ -84,6 +84,7 @@ $(H2 $(LNAME2 retained, Retained Features))`
`84`	`84`	$(LI `switch` with strings)
`85`	`85`	$(LI `final switch`)
`86`	`86`	$(LI `unittest`)
	`87`	+ $(LI $(DDSUBLINK spec/interfaceToC, calling_printf, `printf` format validation))
`87`	`88`	`)`
`88`	`89`
`89`	`90`	$(H3 $(LNAME2 unittests, Running unittests in `-betterC`))