From fb1ef0df636110a9913b17e48d427c0eb9f9420b Mon Sep 17 00:00:00 2001 From: Juan Cruz Viotti Date: Thu, 21 Jan 2016 10:23:40 -0400 Subject: [PATCH] Promote shorter uuids in all examples --- build/actions/device.js | 10 ++++---- build/actions/environment-variables.js | 4 ++-- build/actions/logs.js | 2 +- build/actions/notes.js | 2 +- build/actions/os.js | 2 +- doc/cli.markdown | 30 ++++++++++++------------ lib/actions/device.coffee | 16 ++++++------- lib/actions/environment-variables.coffee | 4 ++-- lib/actions/logs.coffee | 4 ++-- lib/actions/notes.coffee | 4 ++-- lib/actions/os.coffee | 2 +- 11 files changed, 40 insertions(+), 40 deletions(-) diff --git a/build/actions/device.js b/build/actions/device.js index 748d01bc..a50e2b6a 100644 --- a/build/actions/device.js +++ b/build/actions/device.js @@ -46,7 +46,7 @@ limitations under the License. exports.info = { signature: 'device ', description: 'list a single device', - help: 'Use this command to show information about a single device.\n\nExamples:\n\n $ resin device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9', + help: 'Use this command to show information about a single device.\n\nExamples:\n\n $ resin device 7cf02a6', permission: 'user', primary: true, action: function(params, options, done) { @@ -97,7 +97,7 @@ limitations under the License. exports.remove = { signature: 'device rm ', description: 'remove a device', - help: 'Use this command to remove a device from resin.io.\n\nNotice this command asks for confirmation interactively.\nYou can avoid this by passing the `--yes` boolean option.\n\nExamples:\n\n $ resin device rm 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9\n $ resin device rm 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 --yes', + help: 'Use this command to remove a device from resin.io.\n\nNotice this command asks for confirmation interactively.\nYou can avoid this by passing the `--yes` boolean option.\n\nExamples:\n\n $ resin device rm 7cf02a6\n $ resin device rm 7cf02a6 --yes', options: [commandOptions.yes], permission: 'user', action: function(params, options, done) { @@ -118,7 +118,7 @@ limitations under the License. exports.identify = { signature: 'device identify ', description: 'identify a device with a UUID', - help: 'Use this command to identify a device.\n\nIn the Raspberry Pi, the ACT led is blinked several times.\n\nExamples:\n\n $ resin device identify 23c73a12e3527df55c60b9ce647640c1b7da1b32d71e6a39849ac0f00db828', + help: 'Use this command to identify a device.\n\nIn the Raspberry Pi, the ACT led is blinked several times.\n\nExamples:\n\n $ resin device identify 23c73a1', permission: 'user', action: function(params, options, done) { var resin; @@ -130,7 +130,7 @@ limitations under the License. exports.rename = { signature: 'device rename [newName]', description: 'rename a resin device', - help: 'Use this command to rename a device.\n\nIf you omit the name, you\'ll get asked for it interactively.\n\nExamples:\n\n $ resin device rename 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 MyPi\n $ resin device rename 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9', + help: 'Use this command to rename a device.\n\nIf you omit the name, you\'ll get asked for it interactively.\n\nExamples:\n\n $ resin device rename 7cf02a6\n $ resin device rename 7cf02a6 MyPi', permission: 'user', action: function(params, options, done) { var Promise, _, events, form, resin; @@ -158,7 +158,7 @@ limitations under the License. exports.move = { signature: 'device move ', description: 'move a device to another application', - help: 'Use this command to move a device to another application you own.\n\nIf you omit the application, you\'ll get asked for it interactively.\n\nExamples:\n\n $ resin device move 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9\n $ resin device move 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 --application MyNewApp', + help: 'Use this command to move a device to another application you own.\n\nIf you omit the application, you\'ll get asked for it interactively.\n\nExamples:\n\n $ resin device move 7cf02a6\n $ resin device move 7cf02a6 --application MyNewApp', permission: 'user', options: [commandOptions.optionalApplication], action: function(params, options, done) { diff --git a/build/actions/environment-variables.js b/build/actions/environment-variables.js index ddc9e419..d46c7654 100644 --- a/build/actions/environment-variables.js +++ b/build/actions/environment-variables.js @@ -23,7 +23,7 @@ limitations under the License. exports.list = { signature: 'envs', description: 'list all environment variables', - help: 'Use this command to list all environment variables for\na particular application or device.\n\nThis command lists all custom environment variables.\nIf you want to see all environment variables, including private\nones used by resin, use the verbose option.\n\nExample:\n\n $ resin envs --application MyApp\n $ resin envs --application MyApp --verbose\n $ resin envs --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9', + help: 'Use this command to list all environment variables for\na particular application or device.\n\nThis command lists all custom environment variables.\nIf you want to see all environment variables, including private\nones used by resin, use the verbose option.\n\nExample:\n\n $ resin envs --application MyApp\n $ resin envs --application MyApp --verbose\n $ resin envs --device 7cf02a6', options: [ commandOptions.optionalApplication, commandOptions.optionalDevice, { signature: 'verbose', @@ -91,7 +91,7 @@ limitations under the License. exports.add = { signature: 'env add [value]', description: 'add an environment variable', - help: 'Use this command to add an enviroment variable to an application.\n\nIf value is omitted, the tool will attempt to use the variable\'s value\nas defined in your host machine.\n\nUse the `--device` option if you want to assign the environment variable\nto a specific device.\n\nIf the value is grabbed from the environment, a warning message will be printed.\nUse `--quiet` to remove it.\n\nExamples:\n\n $ resin env add EDITOR vim --application MyApp\n $ resin env add TERM --application MyApp\n $ resin env add EDITOR vim --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9', + help: 'Use this command to add an enviroment variable to an application.\n\nIf value is omitted, the tool will attempt to use the variable\'s value\nas defined in your host machine.\n\nUse the `--device` option if you want to assign the environment variable\nto a specific device.\n\nIf the value is grabbed from the environment, a warning message will be printed.\nUse `--quiet` to remove it.\n\nExamples:\n\n $ resin env add EDITOR vim --application MyApp\n $ resin env add TERM --application MyApp\n $ resin env add EDITOR vim --device 7cf02a6', options: [commandOptions.optionalApplication, commandOptions.optionalDevice], permission: 'user', action: function(params, options, done) { diff --git a/build/actions/logs.js b/build/actions/logs.js index 04d06262..da3e636e 100644 --- a/build/actions/logs.js +++ b/build/actions/logs.js @@ -19,7 +19,7 @@ limitations under the License. module.exports = { signature: 'logs ', description: 'show device logs', - help: 'Use this command to show logs for a specific device.\n\nBy default, the command prints all log messages and exit.\n\nTo continuously stream output, and see new logs in real time, use the `--tail` option.\n\nNote that for now you need to provide the whole UUID for this command to work correctly.\n\nThis is due to some technical limitations that we plan to address soon.\n\nExamples:\n\n $ resin logs 23c73a12e3527df55c60b9ce647640c1b7da1b32d71e6a39849ac0f00db828\n $ resin logs 23c73a12e3527df55c60b9ce647640c1b7da1b32d71e6a39849ac0f00db828 --tail', + help: 'Use this command to show logs for a specific device.\n\nBy default, the command prints all log messages and exit.\n\nTo continuously stream output, and see new logs in real time, use the `--tail` option.\n\nNote that for now you need to provide the whole UUID for this command to work correctly.\n\nThis is due to some technical limitations that we plan to address soon.\n\nExamples:\n\n $ resin logs 23c73a1\n $ resin logs 23c73a1', options: [ { signature: 'tail', diff --git a/build/actions/notes.js b/build/actions/notes.js index 961192bb..d79809c3 100644 --- a/build/actions/notes.js +++ b/build/actions/notes.js @@ -19,7 +19,7 @@ limitations under the License. exports.set = { signature: 'note <|note>', description: 'set a device note', - help: 'Use this command to set or update a device note.\n\nIf note command isn\'t passed, the tool attempts to read from `stdin`.\n\nTo view the notes, use $ resin device .\n\nExamples:\n\n $ resin note "My useful note" --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9\n $ cat note.txt | resin note --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9', + help: 'Use this command to set or update a device note.\n\nIf note command isn\'t passed, the tool attempts to read from `stdin`.\n\nTo view the notes, use $ resin device .\n\nExamples:\n\n $ resin note "My useful note" --device 7cf02a6\n $ cat note.txt | resin note --device 7cf02a6', options: [ { signature: 'device', diff --git a/build/actions/os.js b/build/actions/os.js index b8ecd6a4..820e325a 100644 --- a/build/actions/os.js +++ b/build/actions/os.js @@ -92,7 +92,7 @@ limitations under the License. exports.configure = { signature: 'os configure ', description: 'configure an os image', - help: 'Use this command to configure a previously download operating system image with a device.\n\nExamples:\n\n $ resin os configure ../path/rpi.img 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9', + help: 'Use this command to configure a previously download operating system image with a device.\n\nExamples:\n\n $ resin os configure ../path/rpi.img 7cf02a6', permission: 'user', options: [ { diff --git a/doc/cli.markdown b/doc/cli.markdown index 55c8d8d4..29dbb23e 100644 --- a/doc/cli.markdown +++ b/doc/cli.markdown @@ -263,7 +263,7 @@ Use this command to show information about a single device. Examples: - $ resin device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin device 7cf02a6 ## device register <application> @@ -288,8 +288,8 @@ You can avoid this by passing the `--yes` boolean option. Examples: - $ resin device rm 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 - $ resin device rm 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 --yes + $ resin device rm 7cf02a6 + $ resin device rm 7cf02a6 --yes ### Options @@ -305,7 +305,7 @@ In the Raspberry Pi, the ACT led is blinked several times. Examples: - $ resin device identify 23c73a12e3527df55c60b9ce647640c1b7da1b32d71e6a39849ac0f00db828 + $ resin device identify 23c73a1 ## device rename <uuid> [newName] @@ -315,8 +315,8 @@ If you omit the name, you'll get asked for it interactively. Examples: - $ resin device rename 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 MyPi - $ resin device rename 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin device rename 7cf02a6 + $ resin device rename 7cf02a6 MyPi ## device move <uuid> @@ -326,8 +326,8 @@ If you omit the application, you'll get asked for it interactively. Examples: - $ resin device move 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 - $ resin device move 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 --application MyNewApp + $ resin device move 7cf02a6 + $ resin device move 7cf02a6 --application MyNewApp ### Options @@ -376,7 +376,7 @@ Example: $ resin envs --application MyApp $ resin envs --application MyApp --verbose - $ resin envs --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin envs --device 7cf02a6 ### Options @@ -436,7 +436,7 @@ Examples: $ resin env add EDITOR vim --application MyApp $ resin env add TERM --application MyApp - $ resin env add EDITOR vim --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin env add EDITOR vim --device 7cf02a6 ### Options @@ -552,8 +552,8 @@ This is due to some technical limitations that we plan to address soon. Examples: - $ resin logs 23c73a12e3527df55c60b9ce647640c1b7da1b32d71e6a39849ac0f00db828 - $ resin logs 23c73a12e3527df55c60b9ce647640c1b7da1b32d71e6a39849ac0f00db828 --tail + $ resin logs 23c73a1 + $ resin logs 23c73a1 ### Options @@ -573,8 +573,8 @@ To view the notes, use $ resin device . Examples: - $ resin note "My useful note" --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 - $ cat note.txt | resin note --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin note "My useful note" --device 7cf02a6 + $ cat note.txt | resin note --device 7cf02a6 ### Options @@ -604,7 +604,7 @@ Use this command to configure a previously download operating system image with Examples: - $ resin os configure ../path/rpi.img 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin os configure ../path/rpi.img 7cf02a6 ### Options diff --git a/lib/actions/device.coffee b/lib/actions/device.coffee index 0f5fcb48..c609d906 100644 --- a/lib/actions/device.coffee +++ b/lib/actions/device.coffee @@ -63,7 +63,7 @@ exports.info = Examples: - $ resin device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin device 7cf02a6 ''' permission: 'user' primary: true @@ -139,8 +139,8 @@ exports.remove = Examples: - $ resin device rm 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 - $ resin device rm 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 --yes + $ resin device rm 7cf02a6 + $ resin device rm 7cf02a6 --yes ''' options: [ commandOptions.yes ] permission: 'user' @@ -165,7 +165,7 @@ exports.identify = Examples: - $ resin device identify 23c73a12e3527df55c60b9ce647640c1b7da1b32d71e6a39849ac0f00db828 + $ resin device identify 23c73a1 ''' permission: 'user' action: (params, options, done) -> @@ -182,8 +182,8 @@ exports.rename = Examples: - $ resin device rename 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 MyPi - $ resin device rename 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin device rename 7cf02a6 + $ resin device rename 7cf02a6 MyPi ''' permission: 'user' action: (params, options, done) -> @@ -215,8 +215,8 @@ exports.move = Examples: - $ resin device move 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 - $ resin device move 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 --application MyNewApp + $ resin device move 7cf02a6 + $ resin device move 7cf02a6 --application MyNewApp ''' permission: 'user' options: [ commandOptions.optionalApplication ] diff --git a/lib/actions/environment-variables.coffee b/lib/actions/environment-variables.coffee index 0c9a7ac0..e483b3b7 100644 --- a/lib/actions/environment-variables.coffee +++ b/lib/actions/environment-variables.coffee @@ -31,7 +31,7 @@ exports.list = $ resin envs --application MyApp $ resin envs --application MyApp --verbose - $ resin envs --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin envs --device 7cf02a6 ''' options: [ commandOptions.optionalApplication @@ -130,7 +130,7 @@ exports.add = $ resin env add EDITOR vim --application MyApp $ resin env add TERM --application MyApp - $ resin env add EDITOR vim --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin env add EDITOR vim --device 7cf02a6 ''' options: [ commandOptions.optionalApplication diff --git a/lib/actions/logs.coffee b/lib/actions/logs.coffee index 37938257..ba439424 100644 --- a/lib/actions/logs.coffee +++ b/lib/actions/logs.coffee @@ -30,8 +30,8 @@ module.exports = Examples: - $ resin logs 23c73a12e3527df55c60b9ce647640c1b7da1b32d71e6a39849ac0f00db828 - $ resin logs 23c73a12e3527df55c60b9ce647640c1b7da1b32d71e6a39849ac0f00db828 --tail + $ resin logs 23c73a1 + $ resin logs 23c73a1 ''' options: [ { diff --git a/lib/actions/notes.coffee b/lib/actions/notes.coffee index 91690d35..d28b4a7e 100644 --- a/lib/actions/notes.coffee +++ b/lib/actions/notes.coffee @@ -26,8 +26,8 @@ exports.set = Examples: - $ resin note "My useful note" --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 - $ cat note.txt | resin note --device 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin note "My useful note" --device 7cf02a6 + $ cat note.txt | resin note --device 7cf02a6 ''' options: [ signature: 'device' diff --git a/lib/actions/os.coffee b/lib/actions/os.coffee index 38c78deb..e2d6ddfb 100644 --- a/lib/actions/os.coffee +++ b/lib/actions/os.coffee @@ -96,7 +96,7 @@ exports.configure = Examples: - $ resin os configure ../path/rpi.img 7cf02a62a3a84440b1bb5579a3d57469148943278630b17e7fc6c4f7b465c9 + $ resin os configure ../path/rpi.img 7cf02a6 ''' permission: 'user' options: [