Document and remove picktool from default

papis/commands/add.py

@@ -8,28 +8,38 @@
 Examples
 ^^^^^^^^
 
-    - Add a document located in ``~/Documents/interesting.pdf``
-      and name the folder where it will be stored in the database
-      ``interesting-paper-2021``
+- Add a document located in ``~/Documents/interesting.pdf`` and name the
+  folder where it will be stored in the database ``interesting-paper-2021``
 
     .. code::
 
         papis add ~/Documents/interesting.pdf --name interesting-paper-2021
 
-    - Add a paper that you have locally in a file and get the paper
-      information through its ``doi`` identifier (in this case
-      ``10.10763/1.3237134`` as an example):
+  if you want to add directly some key values, like ``author``, ``title``
+  and ``tags``, you can also run the following:
+
+    .. code::
+
+        papis add ~/Documents/interesting.pdf \\
+            --name interesting-paper-2021 \\
+            --set author 'John Smith' \\
+            --set title 'The interesting life of bees' \\
+            --set year 1985 \\
+            --set tags 'biology interesting bees'
+
+- Add a paper that you have locally in a file and get the paper information
+  through its ``doi`` identifier (in this case ``10.10763/1.3237134`` as an
+  example):
 
     .. code::
 
         papis add ~/Documents/interesting.pdf --from-doi 10.10763/1.3237134
 
-    - Add paper to a library named ``machine-learning`` from ``arxiv.org``
+- Add paper to a library named ``machine-learning`` from ``arxiv.org``
 
     .. code::
 
-        papis -l machine-learning add \
---from-url https://arxiv.org/abs/1712.03134
+        papis -l machine-learning add --from-url https://arxiv.org/abs/1712.03134
 
 
 Examples in python

papis/commands/default.py

@@ -1,5 +1,24 @@
 """
 
+Examples
+^^^^^^^^
+
+- To override some configuration options, you can use the flag ``--set``, for
+  instance, if you want to override the editor used and the opentool to open
+  documents, you can just type
+
+    .. code:: shell
+
+        papis --set editor gedit --set opentool firefox edit
+        papis --set editor gedit --set opentool firefox open
+
+- If you want to list the libraries and pick one before sending a database
+  query to papis, use ``--pick-lib`` as such
+
+    .. code:: shell
+
+        papis --pick-lib open 'einstein relativity'
+
 Cli
 ^^^
 .. click:: papis.commands.default:run
@@ -48,11 +67,6 @@
     type=click.Choice(["INFO", "DEBUG", "WARNING", "ERROR", "CRITICAL"]),
     default="INFO"
 )
-@click.option(
-    "--picktool",
-    help="Override picktool",
-    default=""
-)
 @click.option(
     "--pick-lib",
     help="Pick library to use",
@@ -83,7 +97,6 @@ def run(
         config,
         lib,
         log,
-        picktool,
         pick_lib,
         cc,
         cores,
@@ -105,9 +118,6 @@ def run(
         papis.config.set_config_file(config)
         papis.config.reset_configuration()
 
-    if picktool:
-        papis.config.set("picktool", picktool)
-
     if pick_lib:
         lib = papis.api.pick(
             papis.api.get_libraries(),