Merge pull request #637 from moewew/mrgdoc

Clarify mergedate further (#520)

doc/latex/biblatex/examples/50-style-authoryear.tex

@@ -39,13 +39,13 @@ \subsubsection*{The \texttt{mergedate} option}
 Since this style prints the date label after the author/editor in the
 bibliography, there are effectively two dates in the bibliography:
 the full date specification (e.g., \enquote{2001}, \enquote{June
-2006}, \enquote{5th~Jan. 2008}, the format is controlled by the
+2006}, \enquote{5th~Jan. 2008}, whose format is controlled by the
 \texttt{date} option) and the date label (e.g., \enquote{2006a},
-the format is controlled with the \texttt{labeldate} option),
+whose format is controlled with the \texttt{labeldate} option),
 as found in citations. The \texttt{mergedate} option controls whether
 or not date specifications are merged with the date label.
 This option is best explained by example. Note that
-it only affects the bibliography. Citations use the date label only:
+it only affects the bibliography. Citations use the date label only.
 
 \begin{bibsample}
 \item Doe 2000
@@ -71,10 +71,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \item Doe, John (2017). \emph{Webpage}. 7th Aug. 2017.
 \end{bibsample}
 
-\texttt{mergedate=minimum} merges the dates whenever the full date
-and the date label are exactly the same string. If the date is a bare
-year number and there is no \texttt{extrayear} field, the date
-specification will be omitted:
+\texttt{mergedate=minimum} omits the date whenever the full date
+and the date label have exactly the same precision.
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -88,8 +86,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \end{bibsample}
 
 \texttt{mergedate=basic} is similar in concept but more economical.
-It will always omit the date specification if the date is a bare year
-number:
+It will also omit the date if it differs from the date label only by
+\texttt{extrayear}.
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -104,7 +102,8 @@ \subsubsection*{The \texttt{mergedate} option}
 
 \texttt{mergedate=compact} merges all date specifications with the
 date labels. The merged date is printed in \texttt{date} format,
-not \texttt{labeldate}. The \texttt{issue} field is still treated specially:
+not \texttt{labeldate}, even if it is printed in the position of
+the date label. The \texttt{issue} field is still treated specially:
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -117,8 +116,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \end{bibsample}
 
 \texttt{mergedate=maximum} strives for maximum compactness.
-The merged date is printed in \texttt{date} format, not
-\texttt{labeldate}.
+Like \texttt{mergedate=compact} this option merges the date
+into the date label.
 Even the \texttt{issue} field is merged with the date label:
 
 \begin{bibsample}

doc/latex/biblatex/examples/51-style-authoryear-ibid.tex

@@ -53,13 +53,13 @@ \subsubsection*{The \texttt{mergedate} option}
 Since this style prints the date label after the author/editor in the
 bibliography, there are effectively two dates in the bibliography:
 the full date specification (e.g., \enquote{2001}, \enquote{June
-2006}, \enquote{5th~Jan. 2008}, the format is controlled by the
+2006}, \enquote{5th~Jan. 2008}, whose format is controlled by the
 \texttt{date} option) and the date label (e.g., \enquote{2006a},
-the format is controlled with the \texttt{labeldate} option),
+whose format is controlled with the \texttt{labeldate} option),
 as found in citations. The \texttt{mergedate} option controls whether
 or not date specifications are merged with the date label.
 This option is best explained by example. Note that
-it only affects the bibliography. Citations use the date label only:
+it only affects the bibliography. Citations use the date label only.
 
 \begin{bibsample}
 \item Doe 2000
@@ -85,10 +85,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \item Doe, John (2017). \emph{Webpage}. 7th Aug. 2017.
 \end{bibsample}
 
-\texttt{mergedate=minimum} merges the dates whenever the full date
-and the date label are exactly the same string. If the date is a bare
-year number and there is no \texttt{extrayear} field, the date
-specification will be omitted:
+\texttt{mergedate=minimum} omits the date whenever the full date
+and the date label have exactly the same precision.
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -102,8 +100,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \end{bibsample}
 
 \texttt{mergedate=basic} is similar in concept but more economical.
-It will always omit the date specification if the date is a bare year
-number:
+It will also omit the date if it differs from the date label only by
+\texttt{extrayear}.
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -118,7 +116,8 @@ \subsubsection*{The \texttt{mergedate} option}
 
 \texttt{mergedate=compact} merges all date specifications with the
 date labels. The merged date is printed in \texttt{date} format,
-not \texttt{labeldate}. The \texttt{issue} field is still treated specially:
+not \texttt{labeldate}, even if it is printed in the position of
+the date label. The \texttt{issue} field is still treated specially:
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -131,8 +130,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \end{bibsample}
 
 \texttt{mergedate=maximum} strives for maximum compactness.
-The merged date is printed in \texttt{date} format, not
-\texttt{labeldate}.
+Like \texttt{mergedate=compact} this option merges the date
+into the date label.
 Even the \texttt{issue} field is merged with the date label:
 
 \begin{bibsample}

doc/latex/biblatex/examples/52-style-authoryear-comp.tex

@@ -43,13 +43,13 @@ \subsubsection*{The \texttt{mergedate} option}
 Since this style prints the date label after the author/editor in the
 bibliography, there are effectively two dates in the bibliography:
 the full date specification (e.g., \enquote{2001}, \enquote{June
-2006}, \enquote{5th~Jan. 2008}, the format is controlled by the
+2006}, \enquote{5th~Jan. 2008}, whose format is controlled by the
 \texttt{date} option) and the date label (e.g., \enquote{2006a},
-the format is controlled with the \texttt{labeldate} option),
+whose format is controlled with the \texttt{labeldate} option),
 as found in citations. The \texttt{mergedate} option controls whether
 or not date specifications are merged with the date label.
 This option is best explained by example. Note that
-it only affects the bibliography. Citations use the date label only:
+it only affects the bibliography. Citations use the date label only.
 
 \begin{bibsample}
 \item Doe 2000
@@ -75,10 +75,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \item Doe, John (2017). \emph{Webpage}. 7th Aug. 2017.
 \end{bibsample}
 
-\texttt{mergedate=minimum} merges the dates whenever the full date
-and the date label are exactly the same string. If the date is a bare
-year number and there is no \texttt{extrayear} field, the date
-specification will be omitted:
+\texttt{mergedate=minimum} omits the date whenever the full date
+and the date label have exactly the same precision.
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -92,8 +90,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \end{bibsample}
 
 \texttt{mergedate=basic} is similar in concept but more economical.
-It will always omit the date specification if the date is a bare year
-number:
+It will also omit the date if it differs from the date label only by
+\texttt{extrayear}.
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -108,7 +106,8 @@ \subsubsection*{The \texttt{mergedate} option}
 
 \texttt{mergedate=compact} merges all date specifications with the
 date labels. The merged date is printed in \texttt{date} format,
-not \texttt{labeldate}. The \texttt{issue} field is still treated specially:
+not \texttt{labeldate}, even if it is printed in the position of
+the date label. The \texttt{issue} field is still treated specially:
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -121,8 +120,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \end{bibsample}
 
 \texttt{mergedate=maximum} strives for maximum compactness.
-The merged date is printed in \texttt{date} format, not
-\texttt{labeldate}.
+Like \texttt{mergedate=compact} this option merges the date
+into the date label.
 Even the \texttt{issue} field is merged with the date label:
 
 \begin{bibsample}

doc/latex/biblatex/examples/53-style-authoryear-icomp.tex

@@ -51,13 +51,13 @@ \subsubsection*{The \texttt{mergedate} option}
 Since this style prints the date label after the author/editor in the
 bibliography, there are effectively two dates in the bibliography:
 the full date specification (e.g., \enquote{2001}, \enquote{June
-2006}, \enquote{5th~Jan. 2008}, the format is controlled by the
+2006}, \enquote{5th~Jan. 2008}, whose format is controlled by the
 \texttt{date} option) and the date label (e.g., \enquote{2006a},
-the format is controlled with the \texttt{labeldate} option),
+whose format is controlled with the \texttt{labeldate} option),
 as found in citations. The \texttt{mergedate} option controls whether
 or not date specifications are merged with the date label.
 This option is best explained by example. Note that
-it only affects the bibliography. Citations use the date label only:
+it only affects the bibliography. Citations use the date label only.
 
 \begin{bibsample}
 \item Doe 2000
@@ -83,10 +83,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \item Doe, John (2017). \emph{Webpage}. 7th Aug. 2017.
 \end{bibsample}
 
-\texttt{mergedate=minimum} merges the dates whenever the full date
-and the date label are exactly the same string. If the date is a bare
-year number and there is no \texttt{extrayear} field, the date
-specification will be omitted:
+\texttt{mergedate=minimum} omits the date whenever the full date
+and the date label have exactly the same precision.
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -100,8 +98,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \end{bibsample}
 
 \texttt{mergedate=basic} is similar in concept but more economical.
-It will always omit the date specification if the date is a bare year
-number:
+It will also omit the date if it differs from the date label only by
+\texttt{extrayear}.
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -116,7 +114,8 @@ \subsubsection*{The \texttt{mergedate} option}
 
 \texttt{mergedate=compact} merges all date specifications with the
 date labels. The merged date is printed in \texttt{date} format,
-not \texttt{labeldate}. The \texttt{issue} field is still treated specially:
+not \texttt{labeldate}, even if it is printed in the position of
+the date label. The \texttt{issue} field is still treated specially:
 
 \begin{bibsample}
 \item Doe, John (2000). \emph{Book~1}. Location: Publisher.
@@ -129,8 +128,8 @@ \subsubsection*{The \texttt{mergedate} option}
 \end{bibsample}
 
 \texttt{mergedate=maximum} strives for maximum compactness.
-The merged date is printed in \texttt{date} format, not
-\texttt{labeldate}.
+Like \texttt{mergedate=compact} this option merges the date
+into the date label.
 Even the \texttt{issue} field is merged with the date label:
 
 \begin{bibsample}