From ed4b7e6d104db218c36f82e81edbcf3260befdbf Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 3 Jun 2010 00:03:21 +0000 Subject: csquotes 5.0 (2jun10) git-svn-id: svn://tug.org/texlive/trunk@18701 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/csquotes/RELEASE | 87 ++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/csquotes/RELEASE (limited to 'Master/texmf-dist/doc/latex/csquotes/RELEASE') 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 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 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 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 argument supported by + certain quotation commands. In previous version, the + 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. -- cgit v1.2.3