diff options
author | James Ennis <james.ennis@codethink.com> | 2019-01-22 15:28:13 +0000 |
---|---|---|
committer | James Ennis <james.ennis@codethink.com> | 2019-01-22 15:28:13 +0000 |
commit | 35377522ddff7c2b47a7c9978c8cd0fa7be7d28c (patch) | |
tree | 39ebfa5e92f48ee9324a12d8b4ee59d7385527a3 | |
parent | 9c2a6b9324d662f490f841443759e92fa2755674 (diff) | |
download | buildstream-35377522ddff7c2b47a7c9978c8cd0fa7be7d28c.tar.gz |
cli.py: Add an obsoletion note to our deprecated commands.
Click 7.0 allows us to declare commands as 'hidden'.
However, sphinx-click and click-man still generate these hidden
commands in the documentation and man pages, respectively.
This is a stop gap solution until the upstream issues (tracked in
issues #879 and #881) have been addressed.
-rw-r--r-- | buildstream/_frontend/cli.py | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/buildstream/_frontend/cli.py b/buildstream/_frontend/cli.py index e8f3ed557..fd088b63c 100644 --- a/buildstream/_frontend/cli.py +++ b/buildstream/_frontend/cli.py @@ -1106,7 +1106,7 @@ def artifact_log(app, artifacts): ################################################################## # Fetch Command # ################################################################## -@cli.command(short_help="Fetch sources in a pipeline", hidden=True) +@cli.command(short_help="COMMAND OBSOLETE - Fetch sources in a pipeline", hidden=True) @click.option('--except', 'except_', multiple=True, type=click.Path(readable=False), help="Except certain dependencies from fetching") @@ -1128,7 +1128,7 @@ def fetch(app, elements, deps, track_, except_, track_cross_junctions): ################################################################## # Track Command # ################################################################## -@cli.command(short_help="Track new source references", hidden=True) +@cli.command(short_help="COMMAND OBSOLETE - Track new source references", hidden=True) @click.option('--except', 'except_', multiple=True, type=click.Path(readable=False), help="Except certain dependencies from tracking") @@ -1148,7 +1148,7 @@ def track(app, elements, deps, except_, cross_junctions): ################################################################## # Checkout Command # ################################################################## -@cli.command(short_help="Checkout a built artifact", hidden=True) +@cli.command(short_help="COMMAND OBSOLETE - Checkout a built artifact", hidden=True) @click.option('--force', '-f', default=False, is_flag=True, help="Allow files to be overwritten") @click.option('--deps', '-d', default='run', @@ -1175,7 +1175,7 @@ def checkout(app, element, location, force, deps, integrate, hardlinks, tar): ################################################################ # Pull Command # ################################################################ -@cli.command(short_help="Pull a built artifact", hidden=True) +@cli.command(short_help="COMMAND OBSOLETE - Pull a built artifact", hidden=True) @click.option('--deps', '-d', default='none', type=click.Choice(['none', 'all']), help='The dependency artifacts to pull (default: none)') @@ -1192,7 +1192,7 @@ def pull(app, elements, deps, remote): ################################################################## # Push Command # ################################################################## -@cli.command(short_help="Push a built artifact", hidden=True) +@cli.command(short_help="COMMAND OBSOLETE - Push a built artifact", hidden=True) @click.option('--deps', '-d', default='none', type=click.Choice(['none', 'all']), help='The dependencies to push (default: none)') |