cloud(1)

NAME
cloud - read, edit, and manipulate cloud documents

SYNOPSIS
cloud edit [-c|-f] [-t] document

cloud cat [-f] document...

cloud extract [-d pattern] [-f] [-p] document search-text ...

cloud sync [-m explanation]

DESCRIPTION
cloud is a wrapper for a Subversion or Mercurial repository, allowing it to be used as a rudimentary data cloud. cloud automatically refreshes documents before use, and when editing, automatically pushes the changes back with a generated commit comment.

Encrypted files may be managed by assigning them a .cpt extension. These files are decrypted via pipelines when read; there are no intermediary files. When edited, they are decrypted to a temporary file which is edited, re-encrypted, and removed. Crytpo is done using ccrypt(1).

  SUBCOMMANDS
cloud cat concatenates documents, decrypting .cpt documents as it goes.

cloud edit edits a cloud document. Text and Markdown documents are edited in the terminal. For other documents, system document-type preferences are used to launch an appropriate utility.

cloud extract displays lines or paragraphs of a document that contain specified search terms. If multiple terms are specified, all terms must be present to match.

cloud sync synchronizes cloud documents, retrieving updates from and/or pushing local updates to the repository. Note that other commands do this as part of their execution; this command is to re-synchronize after being off-network.

OPTIONS

-c, --create
    Create the file if it does not exist. Without this option, it is an error if the document does not exist. This option is mutually exclusive with -f.

-d PATTERN, --divider=PATTERN
    Use the shell pattern to identify paragraph separators when extracting in paragraph mode (see -p).

-f, --find
    Find the files. With this option, a document's path may be omitted if there is exactly one document matching the filename. This option is mutually exclusive with -c.

-m MESSAGE, --message=MESSAGE
    A change message to include when committing changes to the back-end repository. If omitted, a generic message is generated.

-p, --paragraph
    Apply search criteria to paragraphs rather than lines of text.

-t, --text
    Treat file as a text file, ignoring the document's extension.

EXIT STATUS
0 on success, non-0 on error.

cloud extract returns 0 if matches were found, 1 on error, or 2 if there were no matches.

SEE ALSO
ccrypt(1), now(1), pass(1), pn(1), queue2ics(1), tasks(1)

AUTHOR
Perette Barella <perette@deviousfish.com>