README

   1 1.  The latest release notes for SpiderMonkey can be found at:
   2
   3       https://developer.mozilla.org/En/SpiderMonkey/1.8.5
   4
   5
   6 2.  js/jsd contains code for debugging support for the JavaScript engine in js/src.
   7
   8
   9 Packaging Notes
  10 ---------------
  11 This release is based on revision 5f8f494a4c29 of https://hg.mozilla.org/releases/mozilla-2.0, with
  12 a few trivial changes applied to improve the manageability of the standalone-release. In addition
  13 to running autoconf 2.13 before bundling the release, the changes in the patches directory were
  14 applied.
  15
  16 This standalone release introduces a new, experimental, naming convention for the SpiderMonkey
  17 shared library.  This naming convention will not be rolled back into the mainline Mozilla source
  18 tree, however the relevant patches are included with this distribution.
  19
  20 Note: Please copy wes@page.ca on bugs related to packaging this standalone release.
  21
  22 Linux and non-Mac OS X Unices
  23 -----------------------------
  24 Previous releases and the master source repositories build a shared library named libmozjs.so. In
  25 an effort to make version identification easier for embedders and OS distribution maintainers, this
  26 standalone release builds libmozjs185.so.1.0.0  (.dylib.1.0.0 on Mac OS X).
  27
  28 libmozjs185 indicates that this is the SpiderMonkey library which implements JavaScript 1.8.5. The
  29 1.0.0 suffix is of the form major.minor.micro revision.  While it is unlikely that more than one
  30 official source release for a given version of JavaScript will be published, it has happened in the
  31 past (e.g JS 1.4-1), and we want to provide clear direction in case there is a compelling need:
  32
  33 * a change in major revision number indicates a change which is ABI and API incompatible with the
  34   previous release,
  35
  36 * a change in minor revision number indicates a change which is ABI incompatible, but API
  37   compatible with the previous release,
  38
  39 * a change in micro revision number indicates a change which is both ABI and API compatible with
  40   the previous release.
  41
  42 A symbolic link will be provided linking libmoz185.js.so to this library, along with
  43 libmoz185.js.so.1.0 when building the install target.
  44
  45 Most embeddings building on Unix or Linux should link against libmozjs185.so.1.0.
  46
  47 The static library has been renamed, from libjs_static.a to libmozjs185-1.0.a.
  48
  49 Mac OS X
  50 --------
  51 The versioning rules and symbolic links are the same as for the other flavours of Unix, but the
  52 library name is now libmozjs185.1.0.0.dylib.
  53
  54 Most embeddings building on Mac OS X should link against libmozjs185.1.0.dylib.
  55
  56 Microsoft Windows
  57 -----------------
  58 The versioning rules are the same as for Unix, but the the library name is now
  59 libmozjs185-1.0.dll. Symbolic links will not be created.