Difference between revisions of "Backward compatibility"

From Jmol
Jump to navigation Jump to search
(backward compatibility - change in Hbonds on)
(backward compatibility - change in Hbonds on)
Line 21: Line 21:
  
 
Old scripts using <code>hBonds on</code> will no longer display any hydrogen bonds in most cases, or will display just a few of them (few pdb files include H-bonds specification).
 
Old scripts using <code>hBonds on</code> will no longer display any hydrogen bonds in most cases, or will display just a few of them (few pdb files include H-bonds specification).
 +
 +
'''Advice:'''
 +
 +
Where you had the first <code>hBonds on</code> command for a molecule, replace it with <code>hBonds calculate</code>. Where <code>hBonds on</code> was only to restore display (e.g. after a <code>hBonds off</code>), you can leave it as it was.

Revision as of 11:47, 9 October 2008

Jmol intentionally keeps a strong backward-compatibility, that is, new versions try to maintain operative all things that could be done in older versions, with the same command syntax, and to also keep defaults.

However, on a few occasions there are stronger reasons to decide upon a change in the default behaviour; this can break existing scripts if you update the Jmol version.

This is a place to try and collect such discrepancies, for the benefit of the community of users and webpage/script programmers.

Please, add here any issues you have found when updating Jmol versions:

  • Script commands that get broken when moved to a new version of Jmol.
  • Changes in default behavior.

Make sure to specify the old and new version numbers across which the behaviour was changed.

Hydrogen bonds: calculation and display

Changed between: v. 10.0 and 10.2.

Description:

hBonds on does not calculate hydrogen bonds anymore. Instead, you must use hBonds calculate. This enables the separation of H-bond data present in the pdb file (e.g. calculated by a separate algorithm) and H-bond information as calculated by the Jmol algorithm.

Effects:

Old scripts using hBonds on will no longer display any hydrogen bonds in most cases, or will display just a few of them (few pdb files include H-bonds specification).

Advice:

Where you had the first hBonds on command for a molecule, replace it with hBonds calculate. Where hBonds on was only to restore display (e.g. after a hBonds off), you can leave it as it was.

Contributors

AngelHerraez