replace get_extra_markdown() with get_longdesc()

DocParser: implement get_longdesc()

DocParser: return empty string instead of false

DocParser: remove decorations before processing

add a few unit tests for DocParser

pass string to DocParser (makes it easier to unit test)

make `wp help` read intermediary format

introduce utils/convert-docs.php script

remove unnecessary temporary variable

don't return 'filter' object in `wp post get --format=json`

it's a transient value, not actual data

giving credit where credit is due

remove 'Need even more info' section

Revert "remove redundant array_filter() around preg_split()"

This reverts commit e8ea7f5b62baeb860cdc329a029d2cbc854f2d5c.

It's not redundant when the synopsis has leading or trailing whitespace
or when it's an empty string.

remove redundant array_filter() around preg_split()

ignore repeating parameters in enough_positionals()

This isn't necessarily the best approach, but it matches previous behaviour.

(see parent commit)

Rewrite SynopsisParser to support optional values for assoc parameters.

Props @jmslbam for initial implementation and tests.

see #570

introduce SynopsisValidator class

add some Behat tests for `wp user *-role`

see #594

make `wp user get` show roles

fixes #616

allow WP_CLI::error() to do its thing

(it prints both the error message and any additional data)

Merge pull request #598 from wp-cli/multisite-install

Introduce command to install multisite from scratch

fix indentation in .travis.yml

merge master into multisite-install branch

Merge pull request #603 from wp-cli/fix-603

`wp core` should work without a WP install

extract init_config() helper method

show synopsis for incomplete commands, even without a WP install

move find_command_to_run() method to WP_CLI\Runner

the WP_CLI class should be a simple facade, with only public methods

add comment above apparently unnecessary load_command() call

clone object instead of calling constructor; fixes #592

don't fail if the site is already installed

add --locale parameter to 'wp core config'. fixes #607

make --title optional for multisite-convert

use the same logic from /wp-admin/network.php

add comment about cURL + tar. see #604

Merge pull request #604 from Veered/master

Make wp-cli more Windows compatible

The Windows version of tar doesn't play nicely with pipes. This way is more cross-platform.

Allow paths with spaces.

add docs for 'core multisite-install'

account for already defined multisite constants

behat: remove mismatched URL

define COOKIEHASH to get rid of DB warning

That's because wp_cookie_constants() goes looking for siteurl in the
not-yet-existing wp_sitemeta table.

get rid of some DB warnings

move docs for multisite-convert

move set_url_params() to WP_CLI\Runner

It wasn't really meant to be a public utility. We just didn't have a
runner class back then.

fix edge case in guess_url()

fake $current_site and $current_blog globals

copy the missing steps from populate_network()

test both with and without multisite constants scenarios

skip ms_site_check() when installing

introduce `wp core multisite-install` (doesn't work yet)

bump version to 0.11.0-alpha2

Merge pull request #595 from wp-cli/user-get

Implement `wp user get`

WP_User->to_array() doesn't exist in WP 3.4

behat: align table bars

implement `wp user get`

extract assoc_array_to_table() utility.

Also:
- unset the 'format_content' field; it can be just as long as
'post_content'.
- unset the 'filter' field; it's a runtime value, not persistent data

simplify user test

Merge pull request #555 from wp-cli/user-first-arg

`wp user` subcommands should accept `user_login` or `user_id`

don't abort if a user isn't found

rename get_user_from_first_arg() to get_user()

Merge branch 'user-first-arg' of github.com:wp-cli/wp-cli into user-first-arg

Update "Generating Users" scenario to accommodate deleting multiple users in one go.

Merge branch 'master' into user-first-arg

Update to accommodate scenario when multiple users are passed

See https://github.com/wp-cli/wp-cli/pull/555#discussion_r5179695

add missing docs for `user add-role`; improve docs for `user set-role`

Merge pull request #567 from wp-cli/check-version

Check wp-includes/version.php before loading WP

Merge pull request #538 from wp-cli/behat-check-stderr

behat: make run_check() check STDERR

behat: hide export warnings

suppress curl download meter if not running interactively

don't show progress bar if not in a TTY

this fixes 'tput: No value for $TERM and no -T specified' error

behat: fix `user generate` test

behat: no-op wp_mail()

behat: make run_check() check STDERR

rename _download() to _read() to make it clearer that it doesn't deal with binary data

media: make the temp file have the proper extension from the start

media: don't call get_post() if --post_id isn't even passed

code formatting fixes in media.php

Fix notices no index featured_image

Merge pull request #476 from wp-cli/force-install-476

Support for `--force` flag when installing plugins or themes

simplify logic for theme and plugin installs

leverage 'clear_destination' parameter from WP_Upgrader

Merge branch 'master' into force-install

theme: parse_name() only needs the first argument

plugin: parse_name() only needs the first arg and only needs to return
the filename.

It accepted the whole arguments initially because it used to check if
the slug was missing. This is handled by the synopsis validator now,
beforehand.

make parse_name a private function, since it's not used in CommandWithUpgrade

also, each implementation returns different things

document --force flag

replace --yes with --force

Merge pull request #576 from eugeneware/fix_core_init_tests

don't hard code localhost in wp core init-tests

fix travis.yml

Merge branch 'master' into force-install-476

Conflicts:
features/theme.feature
php/commands/plugin.php
php/commands/theme.php

ioption fixes

Force install Akismet, as it comes with a default WordPress install.

remove :

ternary -> if else

add comments to examples for plugin/theme install

see #581

Merge pull request #581 from om4james/zipfiles

Bug fix: allow plugins and themes to be installed from zip file URLs that contain GET parameters

man-src updates for #581

behat: upgradables comment updates

Merge branch 'master' into zipfiles

Conflicts:
features/steps/basic_steps.php

behat: Convert duplicate plugin/theme tests to scenario outlines

Converts the plugin/theme tests added in e749f71 to Behat's scenario outlines (http://docs.behat.org/guides/1.gherkin.html#scenario-outlines), which removes test duplication.

vendor/bin/behat features/upgradables.feature --expand

Merge remote-tracking branch 'upstream/master' into zipfiles

Changes: https://github.com/wp-cli/wp-cli/compare/fbaab715...498fb6

behat: replace 'a large image file' step with a more generic and explicit 'download' step