Merge branch 'master' into master

Author: Inkrementator

basics/imports-and-modules.md

@@ -47,6 +47,11 @@ The D compiler would then try to load `my/cat/package.d` instead of `my/cat.d`.
 The convention (but not a hard rule) for `package.d` files is to publicly import
 all other modules in the same folder.
 
+### In-Depth
+
+- [Modules and Libraries in _Programming in D_](http://ddili.org/ders/d.en/modules.html)
+- [Modules specification](https://dlang.org/spec/module.html)
+
 ## {SourceCode}
 
 ```d

multithreading/synchronization-sharing.md

@@ -24,16 +24,18 @@ its own variable.
 
 `synchronized` blocks are used to tell the compiler
 to create  a critical section that can only be entered
-by one thread at a time.
+by one thread at a time. With no arguments, a unique mutex
+for that statement alone will be locked and unlocked.
 
     synchronized {
         importStuff();
     }
 
-Within `class` member functions these blocks might be
-limited to different member objects *mutexes*
-with `synchronized(member1, member2)` to reduce
-contention. The D compiler inserts *critical
+Synchronization can be limited to just a class object's
+*mutex* by passing the object as an argument using
+`synchronized (obj)` to reduce contention.
+
+The D compiler inserts *critical
 sections* automatically. A whole class can be marked
 as `synchronized` as well in which case the compiler will
 make sure that just one thread accesses a concrete
@@ -53,7 +55,9 @@ helper:
 - [Lock-Based Synchronization with `synchronized`](http://www.informit.com/articles/article.aspx?p=1609144&seqNum=13)
 - [Deadlocks and `synchronized`](http://www.informit.com/articles/article.aspx?p=1609144&seqNum=15)
 - [`synchronized` specification](https://dlang.org/spec/statement.html#SynchronizedStatement)
-- [Implicit conversions with `shared` data types](https://dlang.org/spec/const3.html#implicit_conversions)
+- [`synchronized` classes](https://dlang.org/spec/class.html#synchronized-classes)
+- [`shared` type qualifier](https://dlang.org/spec/const3.html#shared)
+- [Implicit conversions with `shared` data types](https://dlang.org/spec/const3.html#implicit_qualifier_conversions)
 
 ## {SourceCode}