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

Author: ibuclaw

articles/ctod.dd

@@ -1196,7 +1196,7 @@ $(H2 $(LNAME2 sort, Sorting arrays))
 
 $(H4 The C Way)
 
-        Although many C programmers tend to reimplmement bubble sorts
+        Although many C programmers tend to reimplement bubble sorts
         over and over, the right way to sort in C is to use qsort():
 
 $(CCODE

articles/faq.dd

@@ -360,7 +360,7 @@ $(ITEM real, What is the point of 80 bit reals?)
         to be done, especially when adding together large numbers of small
         real numbers. Prof. Kahan, who designed the Intel floating point
         unit, has an eloquent
-        <a href="http://http.cs.berkeley.edu/~wkahan/JAVAhurt.pdf">paper</a>
+        <a href="https://people.eecs.berkeley.edu/~wkahan/JAVAhurt.pdf">paper</a>
         on the subject.
 
 $(ITEM anonymous, How do I do anonymous struct/unions in D?)

book/dlang.org.ddoc

@@ -269,9 +269,8 @@ $(SUBMENU_MANUAL
     $(SUBMENU_LINK irc://irc.libera.chat/d, IRC)
     $(SUBMENU_LINK https://discord.gg/bMZk9Q4, Community Discord)
     $(SUBMENU_LINK https://wiki.dlang.org, Wiki)
-    $(SUBMENU_LINK_DIVIDER https://github.com/dlang, GitHub)
-    $(SUBMENU_LINK $(ROOT_DIR)bugstats.html, Issues)
-    $(SUBMENU_LINK https://wiki.dlang.org/Get_involved, Get involved)
+    $(SUBMENU_LINK_DIVIDER $(ROOT_DIR)bugstats.html, Issues)
+    $(SUBMENU_LINK $(ROOT_DIR)contributing.html, Contributing)
     $(SUBMENU_LINK_DIVIDER $(ROOT_DIR)foundation/contributors.html, Contributors)
     $(SUBMENU_LINK $(ROOT_DIR)foundation/index.html, Foundation)
     $(SUBMENU_LINK $(ROOT_DIR)/security.html, Security Team)

bugstats.dd

@@ -9,15 +9,16 @@ $(P
 )
 
 $(P
-    You can browse through the existing bugs for D projects $(LINK2 https://issues.dlang.org/describecomponents.cgi?product=D, $(B here)).
+    You can browse through the existing bugs by project $(LINK2 https://issues.dlang.org/describecomponents.cgi?product=D, $(B here)).
 )
 
 $(P
     If you want to search for a specific bug, you can use the $(LINK2 https://issues.dlang.org/query.cgi?format=specific, $(B search page)).
 )
 
 $(P
-    And if you want to file a new bug, you can use $(LINK2 https://issues.dlang.org/enter_bug.cgi?product=D, $(B this page)).
+    And if you want to file a new bug, you can use $(LINK2 https://issues.dlang.org/enter_bug.cgi?product=D, $(B this page)),
+    but please $(HTTPS github.com/dlang/dmd/blob/master/CONTRIBUTING.md#reporting-bugs, check the guidelines) first.
 )
 
 $(H3 Bug Tracker Statistics)

changelog/2.082.0.dd

@@ -309,8 +309,8 @@ from the Objective-C runtime can be used instead [2].
 )
 
 $(P
-[1] $(LINK2 Fragile Binary Interface Problem, https://en.wikipedia.org/wiki/Fragile_binary_interface_problem)
-[2] $(LINK2 Objective-C Runtime, https://developer.apple.com/documentation/objectivec/objective_c_runtime)
+[1] $(LINK2 https://en.wikipedia.org/wiki/Fragile_binary_interface_problem, Fragile Binary Interface Problem)
+[2] $(LINK2 https://developer.apple.com/documentation/objectivec/objective_c_runtime, Objective-C Runtime)
 )
 )
 

changelog/2.095.0.dd

@@ -228,7 +228,7 @@ This deprecation will become an error in 2.105.
 $(LI $(LNAME2 extern-pascal,`extern(Pascal)` has been removed)
 $(CHANGELOG_SOURCE_FILE dmd, changelog/extern-pascal.dd)
 $(P
-This unused linkage was deprecated in $(LINK2 v2.084.0, https://dlang.org/changelog/2.084.0.html#deprecated_extern_pascal) and has now been removed.
+This unused linkage was deprecated in $(LINK2 https://dlang.org/changelog/2.084.0.html#deprecated_extern_pascal, v2.084.0) and has now been removed.
 )
 )
 

changelog/2.097.0.dd

@@ -546,8 +546,8 @@ All public symbols are still accessible using `std.math` as usual.
 $(LI $(LNAME2 splitwhen,splitWhen added to std.algorithm.iteration)
 $(CHANGELOG_SOURCE_FILE phobos, changelog/splitwhen.dd)
 $(P
-$(REF splitWhen, std, algortihm, iteration) is a variant of the existing $(REF
-chunkBy, std, algortihm, iteration) function that does not require its predicate
+$(REF splitWhen, std, algorithm, iteration) is a variant of the existing $(REF
+chunkBy, std, algorithm, iteration) function that does not require its predicate
 to be an equivalence relation, allowing it to be used in ways that chunkBy
 cannot. For example:
 )

changelog/2.101.0.dd

@@ -20,7 +20,7 @@ $(LI $(RELATIVE_LINK2 dmd.deprecate_throwing_nothrow_contracts,Throwing from con
 $(LI $(RELATIVE_LINK2 dmd.deprecate_version_int,Using integers for `version` or `debug` conditions has been deprecated))
 $(LI $(RELATIVE_LINK2 dmd.dip1000_deprecation_warnings,Print deprecations for `scope` pointer errors))
 $(LI $(RELATIVE_LINK2 dmd.dtoh-improvements,Improvements for the C++ header generation))
-$(LI $(RELATIVE_LINK2 dmd.fix-immutable-conv,`-preview=fixImmmutableConv` has been added))
+$(LI $(RELATIVE_LINK2 dmd.fix-immutable-conv,`-preview=fixImmutableConv` has been added))
 $(LI $(RELATIVE_LINK2 dmd.fix22134,Returning a discarded void value from a function is now deprecated))
 $(LI $(RELATIVE_LINK2 dmd.importc_typeof,ImportC now recognizes the `typeof(...)` operator))
 $(LI $(RELATIVE_LINK2 dmd.markdown,Removed the `-transition=markdown` and `-revert=markdown` switches))
@@ -270,10 +270,10 @@ Note: The header generator is still considered experimental, so please submit
 )
 )
 
-$(LI $(LNAME2 dmd.fix-immutable-conv,`-preview=fixImmmutableConv` has been added)
+$(LI $(LNAME2 dmd.fix-immutable-conv,`-preview=fixImmutableConv` has been added)
 $(CHANGELOG_SOURCE_FILE dmd, changelog/dmd.fix-immutable-conv.dd)
 $(P
-The compiler allows implicitly converting a return value with indirections to immutable if it determines the result must be unique.
+The compiler allows implicitly converting a return value with indirections to immutable if it determines the result is unique.
 Formerly, this check would inspect the types of the indirections, and forget to take into account conversions, such as `int[]` to `void[]`:
 )
 
@@ -296,7 +296,7 @@ void main()
 $(P
 This was filed as [issue 15660](https://issues.dlang.org/show_bug.cgi?id=15660), which has been fixed some time ago by making the check more strict: the called function must be strongly pure.
 However, to avoid breaking code, the fix was only active with the `-preview=dip1000` switch.
-Since it is unrelated to dip1000 (which is about `scope` pointers), the fix has been moved to a new `-preview=fixImmmutableConv` switch.
+Since it is unrelated to dip1000 (which is about `scope` pointers), the fix has been moved to a new `-preview=fixImmutableConv` switch.
 )
 )
 

changelog/2.105.0.dd

@@ -5,7 +5,7 @@ $(CHANGELOG_NAV_INJECT)
 $(VERSION Aug 01, 2023, =================================================,
 
 $(CHANGELOG_HEADER_STATISTICS
-$(VER) comes with 11 major changes and 59 fixed Bugzilla issues.
+$(VER) comes with 12 major changes and 59 fixed Bugzilla issues.
         A huge thanks goes to the
         $(LINK2 #contributors, 34 contributors)
         who made $(VER) possible.)
@@ -18,6 +18,7 @@ $(LI $(RELATIVE_LINK2 dmd.enum-function,Functions can no longer have `enum` stor
 $(LI $(RELATIVE_LINK2 dmd.extern-c-overload,Overloading `extern(C)` functions is now an error))
 $(LI $(RELATIVE_LINK2 dmd.private-deprecation-error,Deprecation phase ended for access to private method when overloaded with public method.))
 $(LI $(RELATIVE_LINK2 dmd.visionos-version-identifier,Added predefined version identifier `VisionOS`))
+$(LI $(RELATIVE_LINK2 dmd.allow-parentheses-for-call,Do not error with a C cast when surrounding a type or expression in parentheses when calling or constructing.))
 
 )
 
@@ -174,6 +175,30 @@ This is Apple's new operating system for their VR/AR device Vision Pro.
 )
 )
 
+$(LI $(LNAME2 dmd.allow-parentheses-for-call,Do not error with a C cast when surrounding a type or expression in parentheses when calling or constructing.)
+$(P
+Previous to this version, an expression like `(IdentifierOrBasicType)(Expression)` would be considered a c-style cast,
+and disallowed, even if the `IdentifierOrBasicType` could be used as a callable. This is now allowed, as long as the expression is a call, or a construction.
+
+```
+struct S { int x; }
+int foo(int x) { return x; }
+auto bar = &foo;
+
+// these were previously disallowed
+auto s = (S)(5);   // equivalent to S(5)
+auto f = (foo)(5); // equivalent to foo(5)
+auto b = (bar)(5); // equivalent to bar(5)
+auto i = (int)(5); // equivalent to int(5), not a cast.
+
+// these are not allowed
+auto bad = (int)5; // Error: C style cast illegal, use `cast(int)5`
+auto bad2 = (ubyte)(12345); // Error: cannot implicitly convert expression `12345` of type `int` to `ubyte`
+```
+)
+
+$(P See $(BUGZILLA 24025): Expressions contained in parentheses should not be assumed to be C casts)
+)
 
 )
 

contributing.dd

@@ -0,0 +1,22 @@
+Ddoc
+
+$(D_S Contributing,
+
+$(NOTE To search the bug tracker or report issues, see $(LINK2 bugstats.html, Issues).)
+
+$(H2 $(LNAME2 github, GitHub Projects))
+
+* $(LINK2 https://github.com/dlang, dlang) - dmd, phobos, dub, dlang.org etc
+* $(LINK2 https://github.com/dlang-community, dlang-community) - dfmt, dscanner etc
+
+
+$(H2 $(LNAME2 see-also, Getting Started))
+
+* Please read: $(LINK2 https://github.com/dlang/dmd/blob/master/CONTRIBUTING.md#solving-bugs--submitting-pull-requests,
+    Solving bugs / Submitting pull requests)
+* Get involved: $(HTTPS wiki.dlang.org/Get_involved)
+
+)
+
+Macros:
+  TITLE=Contributing