From ebc79c386d4db262ae76bb2ba0386460a35648f9 Mon Sep 17 00:00:00 2001 From: Colin Okay Date: Sun, 13 Mar 2022 10:17:18 -0500 Subject: tweaks to synopsis definition --- app/app.lisp | 37 ++++++++++++++++++++----------------- 1 file changed, 20 insertions(+), 17 deletions(-) diff --git a/app/app.lisp b/app/app.lisp index ff8322c..0e8b103 100644 --- a/app/app.lisp +++ b/app/app.lisp @@ -101,78 +101,81 @@ export EDITOR=/usr/bin/zile (flag :long-name "all-flagged" :description "Request that only flagged oneliners are returned. Without any TERMS, simply returns all flagged oneliners.") (flag :long-name "not-flagged" - :description "Request that no flagged oneliners are returned with the search results. Does nothing without TERMS") + :description "Request that no flagged oneliners are returned with the search results. Does nothing without TERMS.") (flag :long-name "newest" :description "Return newest oneliners that match. Without any TERMS, simply returns the newest oneliners.")) (group (:header "RUNNING ONELINERS" :hidden t) - (text :contents " ") (text :contents "Usage: ol [OPTIONS] run [ARGS...]") - (text :contents "Run the oneliner identified by IDENTIFIER, if it exists, with optionally supplied ARGS") + (text :contents " ") + (text :contents "Run the oneliner identified by IDENTIFIER, if it exists, with any required ARGS.") (text :contents "IDENTIFIER should either be the name or the unique numeric ID of a oneliner.") (text :contents "E.g. `ol run demo foo bar` # run \"demo\" with args \"foo\" and \"bar\"") (text :contents " ") (text :contents "Options include:") (lispobj :long-name "timeout" - :short-name "t" :argument-type :optional :argument-name "SECONDS" :default-value 1 :typespec 'integer :description "How many seconds to wait for standard output before giving up.")) (group (:header "CLIPPING ONELINERS" :hidden t) - (text :contents " ") (text :contents "Usage: ol clip [ARGS...]") + (text :contents " ") (text :contents "Instead of running a oneliner, copy it to your system's clipboard") (text :contents "ol clip demo-1 foo extra=bar")) (group (:header "SHOWING INFORMATION ABOUT ONELINERS" :hidden t) - (text :contents " ") (text :contents "Usage: ol show ") + (text :contents " ") (text :contents "Print information about a oneliner to the screen.")) (group (:header "NEW ONELINERS" :hidden t) - (text :contents " ") (text :contents "Usage: ol new") + (text :contents " ") (text :contents "Interactively create a new oneliner and upload it to the server.")) (group (:header "EDITING ONELINERS" :hidden t) - (text :contents " ") (text :contents "Usage: ol edit ") + (text :contents " ") (text :contents "Interactively alter a oneliner and uplaod it to the server.")) (group (:header "FLAGGING AND UNFLAGGING ONELINERS" :hidden t) - (text :contents " ") (text :contents "Usage: ol ") + (text :contents " ") (text :contents "Flag or unflag a oneliner. A flagged oneliner is marked as potentially hazardous and will prompt users before exectuion.") (text :contents "Flagged oneliners may also be specifically factor into search using the --all-flagged or --not-flagged search options.")) (group (:header "LOCKING AND UNLOCKING ONELINERS" :hidden t) - (text :contents " ") (text :contents "Usage: ol ") + (text :contents " ") (text :contents "(ADMINS ONLY) Lock or unlock a oneliner. A locked oneliner may not be altered or edited.")) (group (:header "REDEEMING INVITE TOKENS" :hidden t) - (text :contents " ") (text :contents "Usage: ol redeem ") + (text :contents " ") (text :contents "Redeem an invite token, INVITE, and reate a new contributor account on the wiki server with user handle and password.")) (group (:header "INVITE TOKENS" :hidden t) - (text :contents " ") (text :contents "Usage: ol invite") + (text :contents " ") (text :contents "Generate a new invite token if you are allowed to do so.")) (group (:header "LOGIN AND LOGOUT" :hidden t) - (text :contents " ") (text :contents "Usage: ol [HANDLE PASWORD]") + (text :contents " ") (text :contents "Login or logout. If logging in, provide a handle and password.") (text :contents "Once logged in to your configured server, an API access token will be written to your config file, allowing you to make contributions to the wiki.")) (group (:header "PASSWORD CHANGES" :hidden t) - (text :contents " ") (text :contents "Usage: ol password ") + (text :contents " ") (text :contents "Change your password on the configured server.")) (group (:header "SIGNATURE CHANGES" :hidden t) - (text :contents " ") (text :contents "Usage: ol signature") + (text :contents " ") (text :contents "Interactively update your contributor signature.")) + (group (:header "WHOIS CONTRIBUTOR" :hidden t) + (text :contents "Usage: ol whois ") + (text :contents " ") + (text :contents "Print information about a contributor.")) (group (:header "HELP MENU") + (text :contents "Usage: ol help [COMMAND TOPIC]") (text :contents " ") - (text :contents "Usage: ol help [TOPIC]") (text :contents "Print a help menu. With no arguments, prints this help.") - (text :contents "Help topics include: search, run, clip, show, new, edit, flag, lock, redeem, invite, login, password, signature"))) + (text :contents "Command topics include: search, run, clip, show, new, edit, flag, lock, redeem, invite, login, password, signature"))) ;;; HELPERS -- cgit v1.2.3