The extjs/ subdir in JSDuck output is now dedicated to the ExtJS
which the Docs app itself uses.

For examples to work, a separate directory (by default extjs-build/)
should be created and referenced from eg-iframe.html and examples.

Instead of hardcoding ExtJS and Touch examples paths, the
--examples-base-url option determines where icons are located.

The important change is that examples.json file now has to define
icons relative to --examples-base-url (this was the case for Touch,
but not for ExtJS).

Example title and description fields are now also correctly convered,
independent of url being absolute or not.

Auto-created example name no more contains the --examples-base-url
in it.

Variable 'comment' is already a parameter, no 'var' needed.

Simplify calls to #warn by moving more logic inside it.  Now with
the calls to warn taking up less space, other code comes easier to read.

Previously #membername always had to be prefixed with full class name.
Now one can just use member name to reference member from current class.

The default value is now specified in config.json in touch repo.

Not really used for now and only confuses things in this already
cluttered file.

In touch2[export] task make use of SDK/touch/docs/build-* files.
This removes the need for the whole rewriting process of welcome and
eg-iframe pages.

Instead of launching the CodeMirror editor right away, only the toolbar
is created and the original highlighted <pre> is kept.  Only after
"preview" or "code" button is pressed will the <pre> be replaced with
CodeMirror editor and inline preview iframe.

This greatly speeds up the loading time of classes that have inline
examples.  This of course only applies to examples that don't start
off in preview mode - these will still slow the page down.

Most of the logic that was previously in InlineExamples controller is
now moved away to the components.  The controller only deals with the
high-level stuff like initializing the components when page loaded.

From look-and-feel side the editor component now has rounded corners
and looks almost like the normal <pre> code block.  When switching
from <pre> to editor, the text stays at the exact same position,
only the syntax highlighting colors change.

Having removed this slowness factor, inline examples are now also
enabled in IE.  The experience in IE is seriously crappy still...

There needs to be a separate mechanism for giving people access to
all the assets used in documentation.  The previous approach of
writing out guides/videos/examples JSON files generated needless
files for most users of the docs, while not really helping the
people who wanted the actual source files of the docs, as these
files weren't really the actual source files, only gone-through-jsduck
versions of only some of them.

The default icon files is now icon.png.  When guide doesn't contain
it, icon-lg.png is looked for.  When that is also missing, the
default guide icon is used.

This was a hack with no obvious need.

All guides are now read only from guides/ dir, like in ye old times.

When used on a member, it's treated as if the doc-comment wasn't even
there.

When used on a class, all its members will be ignored too.

This makes it a useful tool to easily exclude a class or a member from docs.

Singletons and components are now shown with their designated icons
in search results dropdown.

By default MetaTagRegistry.instance will return a registry that's
loaded with builtin tags.  This instance can be overridden for
testing and for loading custom tags.

This greatly simplifies tests and makes them faster as we no more
need to ensure that MetaTagRegistry has been loaded with builtins
before running the tests.  The registry is only instanciated once
for the general case and second time for running special tests
against itself.  Previously initialization happened multiple times.

Hacks no more needed to inject private tag into meta tags list,
it's now in there naturally. Although now I'm doing a small hack
to make :private appear on doc object hash itself.

With this, the [pri] label will appear in search results dropdown.

This way one can easily differenciate between static, deprecated, and
other types of items in search results.

It's now OK for a guide to be listed in multiple groupes, but when
it's listed multiple times within one group, a warning is printed.

Also added new warning type :dup_asset.

Build a map by position type once, instead of filtering tags list every time.

Previusly null resulted in type=nil which caused problems when
@cfg happened to be @accessor that generated methods which then
ended up having nil return type and nil param type.

@hide is no more equivalent of @private.  Members tagged with @hide
won't appear in documentation at all.

This variable is no more used.