From f2b9d0ccc187b1bdb45a19bce6bf1c20f0953bee Mon Sep 17 00:00:00 2001 From: Nick Martin Date: Mon, 12 Aug 2013 17:12:54 -0700 Subject: [PATCH] History wording tweaks. --- History.md | 67 +++++++++++++++++++++++++++++++++--------------------- 1 file changed, 41 insertions(+), 26 deletions(-) diff --git a/History.md b/History.md index 2ecae8bd4c..deff0b6838 100644 --- a/History.md +++ b/History.md @@ -10,44 +10,59 @@ package scope. * Packages must explicitly declare which symbols they export with - `api.export`. + `api.export` in `package.js`. * Apps and packages only see the exported symbols from packages they explicitly use. For example, if your app uses package A which in turn depends on package B, only package A's symbols will be available in the app. - * Package names can only contain alphanumeric characters and - dashes. Packages with dots, spaces, and underscores must be renamed. + * Package names can only contain alphanumeric characters, dashes, and + dots. Packages with spaces and underscores must be renamed. * Remove hardcoded list of required packages. New default - `standard-app-packages` package adds dependencies on the whole - Meteor stack. This package can be removed to make an app with only - parts of the Meteor stack. + `standard-app-packages` package adds dependencies on the core Meteor + stack. This package can be removed to make an app with only parts of + the Meteor stack. `standard-app-packages` will be automatically + added to a project when it is updated to Meteor 0.6.5. * Custom app packages in the `packages` directory are no longer automatically used. They must be explicitly added to the app with - `meteor add `. + `meteor add `. To help with the transition, all + packages in the `packages` directory will be automatically added to + the project when it is updated to Meteor 0.6.5. - * New "unipackage" format for built packages. Compiled packages are + * New "unipackage" on-disk format for built packages. Compiled packages are cached and rebuilt only when their source or dependencies change. * Add "unordered" and "weak" package dependency modes to allow circular package dependencies and conditional code inclusion. - * New `registerBuildPlugin` API for declaring compilers, - preprocessors, and file extension handlers. The old - `register_extension` API is deprecated. + * New API (`_transitional_registerBuildPlugin`) for declaring + compilers, preprocessors, and file extension handlers. These new + build plugins are full compilation targets in their own right, and + have their own namespace, source files, NPM requirements, and package + dependencies. The old `register_extension` API is deprecated. Please + note that the `package.js` format and especially + `_transitional_registerBuildPlugin` are not frozen interfaces and + are subject to change in future releases. - * Move HTTP serving out of core Meteor into the `webapp` package. This - allows building Meteor apps that are not web servers (eg. command - line tools, DDP clients, etc.). Connect middlewares can now be - registered on the new `WebApp.connectHooks` instead of the old - `__meteor_bootstrap__.app` + * Move HTTP serving out of the server bootstrap into the `webapp` + package. This allows building Meteor apps that are not web servers + (eg. command line tools, DDP clients, etc.). Connect middlewares can + now be registered on the new `WebApp.connectHooks` instead of the + old `__meteor_bootstrap__.app`. -* Add JavaScript sourcemaps in development mode. This includes files - compiled by CoffeeScript. XXX how to use. +* The entire Meteor build process now has first-class source map + support. A source map is maintained for every source file as it + passes through the build pipeline. Currently, the source maps are + only served in development mode. Not all web browsers support source + maps yet and for those that do, you may have to turn on an option to + enable them. Source maps will always be used when reporting + exceptions on the server. + +* Update the `coffeescript` package to generate source maps. * Add new `Assets` API and `private` subdirectory for including and accessing static assets on the server. http://docs.meteor.com/#assets @@ -57,9 +72,6 @@ * Add `Match.Integer` to `check` for 32-bit signed integers. -* New `Log` function which prints with timestamps, color, filenames and - linenumbers. - * `Meteor.connect` has been renamed to `DDP.connect` and is now fully supported on the server. Server-to-server DDP connections use websockets, and can be used for both method calls and subscriptions. @@ -72,17 +84,20 @@ * `ROOT_URL` may now have a path part. This allows serving multiple Meteor apps on the same domain. -* Allow creating named unmanaged collections with - `new Meteor.Collection("name", {connection: null})` - XXX note on why useful XXX doc update! +* Support creating named unmanaged collections with + `new Meteor.Collection("name", {connection: null})`. + +* New `Log` function in the `logging` package which prints with + timestamps, color, filenames and linenumbers. * Include http response in errors from oauth providers. #1246 * The `observe` callback `movedTo` now has a fourth argument `before`. * Move NPM control files for packages from `.npm` to - `.npm/package`. Also, when removing the last NPM dependency, clean up - the `.npm` dir. + `.npm/package`. This is to allow build plugins such as `coffeescript` + to depend on NPM packages. Also, when removing the last NPM + dependency, clean up the `.npm` dir. * Remove deprecated `Meteor.is_client` and `Meteor.is_server` variables.