Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
releasenotes [2018/08/04 16:04]
christian [Release Notes for PDFtalk 2.0] 		releasenotes [2020/02/22 11:02]
christian
Line 1: Line 1:
-====== Release Notes for PDFtalk 2.0 ======+====== Release Notes ====== 
 + 
 +===== PDFtalk 2.3 ===== 
 + 
 +===== PDFtalk 2.0 =====
  
 This is the release of the second major version of the PDF library in October 2017. This is the release of the second major version of the PDF library in October 2017.
  
-===== What's new =====+==== What's new ====
  
 **Name** The new name is //**PDFtalk**//. The first version was called //PDF4Smalltalk//. The namespace changed from ''PDF'' to ''PDFtalk'' and the domain "pdftalk.de" provides a home with a wiki dedicated to the library: [[https://wiki.pdftalk.de|wiki.pdftalk.de]]. **Name** The new name is //**PDFtalk**//. The first version was called //PDF4Smalltalk//. The namespace changed from ''PDF'' to ''PDFtalk'' and the domain "pdftalk.de" provides a home with a wiki dedicated to the library: [[https://wiki.pdftalk.de|wiki.pdftalk.de]].
Line 14: Line 18:
  
 Both new projects are open source with MIT licence. Both new projects are open source with MIT licence.
-===== Changes for users of the library =====+==== Changes for users of the library ====
  
 Some changes are incompatible with the previous version, which are described here. Some changes are incompatible with the previous version, which are described here.
Line 20: Line 24:
 It is not recommended to load the new version into an image with the old version of the library. It is not recommended to load the new version into an image with the old version of the library.
  
-==== Namespace and bundle structure ====+=== Namespace and bundle structure ===
  
 The former namespace //PDF// is renamed to **''PDFtalk''**. The former namespace //PDF// is renamed to **''PDFtalk''**.
Line 32: Line 36:
 to see if they are running. You may need to edit the file path to the PDF specification and to your demo directory. to see if they are running. You may need to edit the file path to the PDF specification and to your demo directory.
  
-==== Referencing PDF classes ====+=== Referencing PDF classes ===
  
 Smalltalk classes representing a PDF type should not be referenced directly anymore. Instead an expression like Smalltalk classes representing a PDF type should not be referenced directly anymore. Instead an expression like
Line 58: Line 62:
   - The Smalltalk class name may differ in different ports of the library.   - The Smalltalk class name may differ in different ports of the library.
  
-==== New shared Smalltalk.PDF ====+=== New shared Smalltalk.PDF ===
  
 The shared variable **''PDF''** was added to the Smalltalk namespace. The variable holds the class **''PDFtalk.PDF''** which serves as general entry point for the library. The shared variable **''PDF''** was added to the Smalltalk namespace. The variable holds the class **''PDFtalk.PDF''** which serves as general entry point for the library.
Line 64: Line 68:
 Unless you extend the library, there should be no need to add the PDFtalk namespace to the imports of your project. Instead most functionality should be accessed through **''PDF''** in the Smalltalk namespace. Unless you extend the library, there should be no need to add the PDFtalk namespace to the imports of your project. Instead most functionality should be accessed through **''PDF''** in the Smalltalk namespace.
  
-==== Aligned types ====+=== Aligned types ===
  
 The new typing system allowed to remove the PDF classes **''Null''** and **''Boolean''**. Instead, they are now implemented by the system classes **''UndefinedObject''** and **''Boolean''**. The new typing system allowed to remove the PDF classes **''Null''** and **''Boolean''**. Instead, they are now implemented by the system classes **''UndefinedObject''** and **''Boolean''**.
Line 71: Line 75:
  
 The work is not finished yet. **''Number''** and maybe **''String''** and **''Date''** could be aligned as well. The work is not finished yet. **''Number''** and maybe **''String''** and **''Date''** could be aligned as well.
-===== Typing redesign =====+==== Typing redesign ====
  
 The major change is the redesign of the [[newtyping|PDF typing system]]. Initially, I represented the types of PDF objects by Smalltalk classes with the same name. This turned out to be not sufficient.  The major change is the redesign of the [[newtyping|PDF typing system]]. Initially, I represented the types of PDF objects by Smalltalk classes with the same name. This turned out to be not sufficient. 
Line 80: Line 84:
  
 Therefore, PDF types are now modeled independently. Therefore, PDF types are now modeled independently.
-==== Notes ====+=== Notes ===
  
-=== Specialization only on assignment ===+== Specialization only on assignment ==
  
 When PDF objects were created, all classes were searched for possible specializations: for example, a Dictionary with a #Type entry was automatically converted to its corresponding class. When PDF objects were created, all classes were searched for possible specializations: for example, a Dictionary with a #Type entry was automatically converted to its corresponding class.
Line 88: Line 92:
 In the new version, objects are only typed and specialized when they are assigned to an attribute of a Dictionary or Array. In the new version, objects are only typed and specialized when they are assigned to an attribute of a Dictionary or Array.
  
-=== System classes as PDF classes===+== System classes as PDF classes ==
  
 The first version had wrappers for all basic types of PDF, such as null, booleans, numbers etc.. This is similar to boxing of primitive types in other programming languages. The first version had wrappers for all basic types of PDF, such as null, booleans, numbers etc.. This is similar to boxing of primitive types in other programming languages.
  • releasenotes.txt
  • Last modified: 2021/07/29 20:10
  • by christian