Merge pull request #2184 from wilzbach/changelog-hint

Add contributor hints and explanation of pending.dd
merged-on-behalf-of: Petar Kirov <ZombineDev@users.noreply.github.com>

Author: dlang-bot

changelog/pending.ddoc

@@ -3,7 +3,36 @@ $(DIVC version,
 $(P
 $(B $(LARGE $(LINK2 http://nightlies.dlang.org, Download D nightlies)))$(BR)
 $(SMALL $1)
+
 )
+
+$(HR)
+
+$(P
+This changelog has been $(B automatically generated) from all commits in $(B $(CODE master))
+since the last release.
+)
+$(P
+    $(UL
+        $(LI The full-text messages are assembled from the $(CODE changelog/) directories of the respective repositories:
+            $(LINK2 https://github.com/dlang/dmd/tree/master/changelog, $(CODE dmd)),
+            $(LINK2 https://github.com/dlang/druntime/tree/master/changelog, $(CODE druntime)),
+            $(LINK2 https://github.com/dlang/phobos/tree/master/changelog, $(CODE phobos)),
+            $(LINK2 https://github.com/dlang/tools/tree/master/changelog, $(CODE tools)),
+            $(LINK2 https://github.com/dlang/dlang.org/tree/master/changelog, $(CODE dlang.org)),
+            $(LINK2 https://github.com/dlang/installer/tree/master/changelog, $(CODE installer)), and
+            $(LINK2 https://github.com/dlang/dub/tree/master/changelog, $(CODE dub)).
+        )
+        $(LI See the $(LINK2 https://github.com/dlang-bots/dlang-bot#automated-references, DLang-Bot documentation) for details on referencing Bugzilla.
+        The DAutoTest PR preview doesn't include the Bugzilla changelog.)
+        $(LI The pending changelog can be generated locally by $(LINK2 https://github.com/dlang/dlang.org/blob/master/CONTRIBUTING.md, setting up $(D dlang.org)) and running the $(D pending_changelog) target:
+            $(CONSOLE make -f posix.mak pending_changelog)
+        )
+    )
+)
+
+$(HR)
+
 $3
 )
 CHANGELOG_SEP_HEADER_TEXT_NONEMPTY=$(BR)$(BIG $(RELATIVE_LINK2 bugfix-list, List of all upcoming bug fixes and enhancements in D $(VER).))

posix.mak

@@ -930,13 +930,13 @@ changelog/prerelease.dd: $G/changelog/next-version $(LOOSE_CHANGELOG_FILES) | \
 							${STABLE_DMD} $(TOOLS_DIR) $(INSTALLER_DIR) $(DUB_DIR)
 	$(STABLE_RDMD) -version=Contributors_Lib $(TOOLS_DIR)/changed.d \
 		$(CHANGELOG_VERSION_STABLE) -o $@ --version "${NEXT_VERSION}" \
-		--date "To be released"
+		--prev-version="${LATEST}" --date "To be released"
 
 changelog/pending.dd: $G/changelog/next-version $(LOOSE_CHANGELOG_FILES) | \
 							${STABLE_DMD} $(TOOLS_DIR) $(INSTALLER_DIR) $(DUB_DIR)
 	$(STABLE_RDMD) -version=Contributors_Lib $(TOOLS_DIR)/changed.d \
 		$(CHANGELOG_VERSION_MASTER) -o $@ --version "${NEXT_VERSION}" \
-		--date "To be released"
+		--prev-version="${LATEST}" --date "To be released"
 
 pending_changelog: changelog/pending.dd html
 	@echo "Please open file:///$(shell pwd)/web/changelog/pending.html in your browser"