From 5b6d79859cd27a755ecabbc00104ee5e365c1285 Mon Sep 17 00:00:00 2001 From: Ben Morrison Date: Wed, 27 May 2020 00:53:41 -0400 Subject: expanded usage, removed extraneous info about crates --- README.md | 53 +++++++++++++++++++---------------------------------- 1 file changed, 19 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index bdfde1f..a2060c0 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # clinte   [![Build Status](https://travis-ci.com/gbmor/clinte.svg?branch=master)](https://travis-ci.com/gbmor/clinte) [![codecov](https://codecov.io/gh/gbmor/clinte/branch/master/graph/badge.svg)](https://codecov.io/gh/gbmor/clinte) -Command-line community notice board. Post simple notes for other users to see. +Command-line community notice board. Post text-only notes for other users to see. ## Features @@ -18,7 +18,7 @@ Command-line community notice board. Post simple notes for other users to see. Current build dependencies are as follows: -- `rustc/cargo >= 1.36` +- `rust >= 1.36` - `libsqlite3-dev` The installation for the build deps will vary based on your OS (`Linux, BSD`) @@ -29,6 +29,7 @@ Clone the repository and jump into the directory: $ git clone git://github.com/gbmor/clinte.git ... $ cd clinte +$ git checkout $(git describe --tags --abbrev=0) ``` Run the makefile and install: @@ -46,13 +47,13 @@ $ sudo make install Issuing the program name itself will list the currently available posts, like in the screenshot above. -To display the 15 most recent posts: +**Display recent posts** ``` $ clinte ``` -To make a new post: +**Create a post** ``` $ clinte post @@ -62,44 +63,28 @@ $ clinte post tagged automatically by your logged-in username, reflecting its intended use on multi-user UNIX-like systems. -To edit a post: +**Edit a post** ``` -$ clinte update +$ clinte update [id] ``` -`clinte` will ask for the ID number of the post. If it's been authored by you, -then you will be asked for the new title and body after being shown the -previous title and body. +If the `[id]` argument is absent, `clinte` will ask for the ID number of the post. +If it's been authored by you, then you will be asked for the new title. +Your `$EDITOR` will be called, and will be populated with the previous body. -To delete a post: +**Delete a post** ``` -$ clinte delete +$ clinte delete [id] ``` -Then `clinte` asks for the numeric ID of the post to delete. +If the `[id]` argument is absent, `clinte` asks for the numeric ID of the post to delete. -## Contributing +**Verbose logging** -This is very new, so feel free to hack on it in any way you -please and submit a PR! I'll be working on it myself over the next several days -to flesh it out. - -## Notes - -`clinte` has roughly 60 library dependencies from the `rust` ecosystem. -Nevertheless, the binary remains only `2.1MB` in size as of `v0.4.3`. -For your information, the direct library dependencies of `clinte` are: - -- `chrono >= 0.4` -- `clap >= 2.33` -- `lazy_static >= 1.4` -- `log >= 0.4` -- `rusqlite >= 0.20` -- `simplelog >= 0.7` -- `users >= 0.9` - -The indirect dependencies (dependencies of dependencies) are: - -`ansi_term, arrayref, arrayvec, atty, autocfg, backtrace, backtrace-sys, base64, bitflags, blake2b_simd, byteorder, cc, cfg-if, cloudabi, constant_time_eq, crossbeam-utils, dirs, dirs-sys, failure, failure_derive, fallible-iterator, fallible-streaming-iterator, fuchsia-cprng, libc, libsqlite3-sys, linked-hash-map, lru-cache, memchr, nodrop, num-integer, num-traits, pkg-config, proc-macro2, quote, rand_core, rand_os, rdrand, redox_syscall, redox_users, rust-argon2, rustc-demangle, strsim, syn, synstructure, term, textwrap, time, unicode-width, unicode-xid, vcpkg, winapi, winapi-i686-pc-windows-gnu, winapi-x86_64-pc-windows-gnu` +``` +$ clinte -v [post|update|delete] [id] +``` +Use this flag if something's going wrong. Additional information will be written to +`/tmp/clinte_$USER.log` that will, hopefully, reveal the cause of the error. -- cgit 1.4.1-2-gfad0