From 1fdf48659e2527dc831e29c09924054293bdcc03 Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Wed, 10 Nov 2021 23:11:54 +0100 Subject: update readme --- README.rst | 55 +++++++++++++++++++++++++++---------------------------- 1 file changed, 27 insertions(+), 28 deletions(-) diff --git a/README.rst b/README.rst index 922e2bf..58ec09a 100644 --- a/README.rst +++ b/README.rst @@ -7,11 +7,11 @@ setcolors_ utility. Usage ----- -**vtcol** knows two ways of loading a color scheme: Either by picking the -definitions for a set of predefined schemes or by loading it from a definition -file. The latter accepts input in the format supported by setcolors_. NB not -much effort has been put into ensuring compliance so YMMV. Check the -subdirectory ``./schemes`` in the **vtcol** tree for examples. +**vtcol** knows two ways of loading a color scheme: From a set of predefined +palettes or by loading it from a definition file. The latter accepts input in +the format supported by setcolors_. (Not much effort has been put into ensuring +compliance so YMMV.) Check the subdirectory ``./schemes`` in the **vtcol** tree +for examples of definition files. Three color schemes are predefined: @@ -19,44 +19,43 @@ Three color schemes are predefined: * ``solarized`` the Solarized_ color scheme, dark version. * ``solarized_light`` the Solarized_ color scheme, light version. -Invoke **vtcol** with the ``--scheme`` option specifying the scheme of your -choice: +Invoke **vtcol** with the ``set`` command specifying the scheme of your +choice: :: -:: + $ vtcol set solarized_light - vtcol --scheme solarized_light - -In order to view the available schemes, use the ``--list`` option. Should the +In order to view the available schemes, use the ``list`` command. Should the scheme specified not resolve to one of the predefined ones, **vtcol** will fall -back to interpreting the name as that of a file. Likewise, loading a scheme +back on interpreting the name as that of a file. Likewise, loading a scheme directly from a definition file is accomplished by specifying the ``--file`` -argument. - -:: +argument to ``set``. :: - vtcol --file ./schemes/solarized + $ vtcol set --file ./schemes/solarized Instead of an actual scheme or file name, these parameters accept ``-`` -as an argument in order to read from ``stdin``. +as an argument in order to read from ``stdin``. :: + + $ vtcol set - -Also, in order to view a scheme’s definition, for instance in order to verify -that **vtcol** parses it correctly, specify the ``--dump`` option. +To show the current scheme of the active console use the ``get`` subcommand: :: -:: + $ vtcol get + solarized_dark - vtcol --dump default - vtcol --dump ./schemes/solarized +To view a scheme’s definition, for instance in order to verify that **vtcol** +parses it correctly, use the ``dump`` command. :: -This will print the list of color definitions as dictated by the scheme; if the -specified name does not resolve to a pre-defined scheme it will be interpreted -as a file name instead. + $ vtcol dump default + $ vtcol dump ./schemes/solarized + +This will print the color definitions contained in the scheme; if the specified +name does not resolve to a pre-defined scheme it will be interpreted as a file +name instead. Building -------- -Use Cargo to obtain a binary: - -:: +Use Cargo to obtain a binary: :: cargo build -- cgit v1.2.3