summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/csquotes/RELEASE
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-06-03 00:03:21 +0000
committerKarl Berry <karl@freefriends.org>2010-06-03 00:03:21 +0000
commited4b7e6d104db218c36f82e81edbcf3260befdbf (patch)
treee0fd631dae906579d45a0487e74cae8feedffb08 /Master/texmf-dist/doc/latex/csquotes/RELEASE
parent2a2fbc131c15823a6094173b0ae4b08d06500381 (diff)
csquotes 5.0 (2jun10)
git-svn-id: svn://tug.org/texlive/trunk@18701 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/csquotes/RELEASE')
-rw-r--r--Master/texmf-dist/doc/latex/csquotes/RELEASE87
1 files changed, 87 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/csquotes/RELEASE b/Master/texmf-dist/doc/latex/csquotes/RELEASE
new file mode 100644
index 00000000000..23329222cac
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/csquotes/RELEASE
@@ -0,0 +1,87 @@
+$Id: RELEASE,v 5.0 2010/06/02 19:22:07 lehman stable $
+
+RELEASE NOTES FOR VERSION 5.0
+
+* Backwards compatibility
+
+ This release introduces some changes which are not backwards
+ compatible out of the box. In order to ease the transition to the
+ new version, I've implemented a 'version' option which emulates
+ older versions of csquotes.
+
+ It is quite possible that you do not need to set this option at
+ all, even though you have older documents using csquotes. You
+ only need the 'version' option in older documents if:
+
+ - you are using the <punct> argument of \blockquote and/or
+ - you have redefined any of the old
+ '\mk(pre|mid|fin)(text|block|disp)punct' hooks.
+
+ If these conditions do not apply and you run 5.0 with the default
+ settings, the output will be similar to 4.4. There is absolutely
+ no need to set 'version=4.4' if you didn't use the old hooks and
+ the <punct> argument of \blockquote anyway.
+
+ I've also removed some legacy aliases. This is rather old stuff
+ from csquotes 3.x and even 2.x which has been marked as
+ depreciated for some time. Setting 'version=4.4' will restore
+ them as well.
+
+* Punctuation look-ahead
+
+ This release comes with a new punctuation look-ahead feature,
+ i.e., in addition to the <punct> argument of advanced quotation
+ commands like \textquote, these commands can now scan ahead for
+ trailing punctuation after their last argument and move it around
+ if desired.
+
+ This is required by quoting conventions such as the US quotation
+ style which requires that a period or a comma immediately after a
+ closing quotation mark be moved inside the quotes even if it is
+ not part of the quoted text.
+
+ The implementation of the look-ahead feature also implies a new
+ interpretation of the optional <punct> argument supported by
+ certain quotation commands. In previous version, the <punct>
+ argument was intended for terminal punctuation which is NOT part
+ of the quoted text. Starting with this release, it is intended
+ for punctuation which IS part of the quoted text (but may need to
+ be moved around).
+
+ The modified syntax is more intuitive to use because terminal
+ punctuation which is NOT part of the quoted text is simply placed
+ after the last argument of the command, i.e.:
+
+ \textquote[citation][.]{quoted text}
+
+ becomes:
+
+ \textquote[citation]{quoted text}.
+
+ All of this is discussed at length in the manual. See the
+ changelog in the manual for pointers to the relevant sections.
+
+* Revised quotation hooks
+
+ The old quotation hooks:
+
+ \mkpretextpunct
+ \mkmidtextpunct
+ \mkfintextpunct
+ \mkpreblockpunct
+ \mkmidblockpunct
+ \mkfinblockpunct
+ \mkpredisppunct
+ \mkmiddisppunct
+ \mkfindisppunct
+
+ have been removed and are replaced by new hooks:
+
+ \mktextquote
+ \mkblockquote
+ \mkbegdispquote
+ \mkenddispquote
+
+ which are much more powerful while being more intuitive to use.
+ If you have been using the old hooks in some documents, set
+ 'version=4.4' to emulate the old interface.