diff --git a/RELEASE-NOTES b/RELEASE-NOTES index 1d170fe9f4..aeefe567a4 100644 --- a/RELEASE-NOTES +++ b/RELEASE-NOTES @@ -230,14 +230,23 @@ Caveats when upgrading from earlier versions to 2.0.x - There has been a large change in how Flex insets are named. Previously, they tended to have names like "CharStyle:Noun". Now, they just have - names like "Flex:Noun" (where "Flex" is a namespace that is optional). - When LyX 2.0 reads older files, it silently converts the old-style names - to new-style names; this direction works perfectly. It will also silently - revert new-style names to old-style names, when exporting to 1.6.x format, - but only for the pre-defined LyX insets. This means that user-defined flex - insets will not be properly reverted. - To solve this problem, you can modify the file $LYXDIR/lyx2lyx/lyx_2_0.py. - In that file, you will find the following: + names like "Flex:Noun" (where the "Flex" prefix is now required). When + LyX 2.0 reads older files, it silently converts the old-style names + to new-style names; this direction works almost perfectly. The one place + it does not work is with CopyStyle declarations, IF your old InsetLayout + was NOT named "CharStyle:..." or "Custom:..." or "Element:...", but, say, + just "MyInset". In that case, "InsetLayout MyInset" will be changed to + "InsetLayout Flex:MyInset", but "CopyStyle MyInset" will be left as is. + Users will need to make that kind of change manually. The best way to do + this is to use the layout2layout.py script, which gets installed in + $LYXDIR/scripts/layout2layout.py, to convert your custom layout files to + the new format, and then check them for correctness. + + LyX will also silently revert new-style names to old-style names when + exporting to 1.6.x format, but only for the pre-defined LyX insets. This + means that user-defined flex insets will not be properly reverted. To solve + this problem, you can modify the file $LYXDIR/lyx2lyx/lyx_2_0.py. In that + file, you will find the following: flex_insets = { "Alert" : "CharStyle:Alert", "Code" : "CharStyle:Code", @@ -257,7 +266,7 @@ Caveats when upgrading from earlier versions to 2.0.x "PresentationMode" : "Custom:PresentationMode", "Tri-Glosse" : "Custom:Tri-Glosse" } - This is a map form new-style names (minux "Flex") to old-style names (and + This is a map from new-style names (minux "Flex") to old-style names (and there is a similar for DocBook elements). To get a user-defined CharStyle to revert properly, it simply needs to be added to this list.