From 9d345cab073b055272a5136e47e634b581eacd0d Mon Sep 17 00:00:00 2001
From: Shaurya Shubham <shauryashubham1234567890@gmail.com>
Date: Sun, 10 Nov 2019 12:37:27 +0530
Subject: [PATCH] Add documentation for the pick and reject command

Partial fix of issue#711
---
 docs/commands/pick.md   | 53 +++++++++++++++++++++++++++++++++++++++++
 docs/commands/reject.md | 38 +++++++++++++++++++++++++++++
 2 files changed, 91 insertions(+)
 create mode 100644 docs/commands/pick.md
 create mode 100644 docs/commands/reject.md

diff --git a/docs/commands/pick.md b/docs/commands/pick.md
new file mode 100644
index 000000000..e0d0e4c07
--- /dev/null
+++ b/docs/commands/pick.md
@@ -0,0 +1,53 @@
+# pick
+
+This command displays only the column names passed on to it.
+
+## Examples
+
+```shell
+> ls
+━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━┯━━━━━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━
+ # │ name                       │ type │ readonly │ size   │ created     │ accessed    │ modified 
+───┼────────────────────────────┼──────┼──────────┼────────┼─────────────┼─────────────┼─────────────
+ 0 │ zeusiscrazy.txt            │ File │          │ 556 B  │ a month ago │ a month ago │ a month ago 
+ 1 │ coww.txt                   │ File │          │  24 B  │ a month ago │ a month ago │ a month ago 
+ 2 │ randomweirdstuff.txt       │ File │          │ 197 B  │ a month ago │ a month ago │ a month ago 
+ 3 │ abaracadabra.txt           │ File │          │ 401 B  │ a month ago │ a month ago │ a month ago 
+ 4 │ youshouldeatmorecereal.txt │ File │          │ 768 B  │ a month ago │ a month ago │ a month ago 
+━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━┷━━━━━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━
+> ls | pick name 
+━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ # │ name 
+───┼────────────────────────────
+ 0 │ zeusiscrazy.txt 
+ 1 │ coww.txt 
+ 2 │ randomweirdstuff.txt 
+ 3 │ abaracadabra.txt 
+ 4 │ youshouldeatmorecereal.txt 
+━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+The order in which you put the column names matters: 
+
+```shell
+> ls | pick type name size
+━━━┯━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━━━
+ # │ type │ name                       │ size 
+───┼──────┼────────────────────────────┼────────
+ 0 │ File │ zeusiscrazy.txt            │ 556 B  
+ 1 │ File │ coww.txt                   │  24 B  
+ 2 │ File │ randomweirdstuff.txt       │ 197 B  
+ 3 │ File │ abaracadabra.txt           │ 401 B  
+ 4 │ File │ youshouldeatmorecereal.txt │ 768 B  
+━━━┷━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━━━
+> ls | pick size type name
+━━━┯━━━━━━━━┯━━━━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ # │ size   │ type │ name 
+───┼────────┼──────┼────────────────────────────
+ 0 │ 556 B  │ File │ zeusiscrazy.txt 
+ 1 │  24 B  │ File │ coww.txt 
+ 2 │ 197 B  │ File │ randomweirdstuff.txt 
+ 3 │ 401 B  │ File │ abaracadabra.txt 
+ 4 │ 768 B  │ File │ youshouldeatmorecereal.txt 
+━━━┷━━━━━━━━┷━━━━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
diff --git a/docs/commands/reject.md b/docs/commands/reject.md
new file mode 100644
index 000000000..0d474ee86
--- /dev/null
+++ b/docs/commands/reject.md
@@ -0,0 +1,38 @@
+# reject
+
+This column removes or rejects the columns passed to it.
+
+## Examples 
+
+```shell
+> ls
+━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━┯━━━━━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━
+ # │ name                       │ type │ readonly │ size   │ created     │ accessed    │ modified 
+───┼────────────────────────────┼──────┼──────────┼────────┼─────────────┼─────────────┼─────────────
+ 0 │ zeusiscrazy.txt            │ File │          │ 556 B  │ a month ago │ a month ago │ a month ago 
+ 1 │ coww.txt                   │ File │          │  24 B  │ a month ago │ a month ago │ a month ago 
+ 2 │ randomweirdstuff.txt       │ File │          │ 197 B  │ a month ago │ a month ago │ a month ago 
+ 3 │ abaracadabra.txt           │ File │          │ 401 B  │ a month ago │ a month ago │ a month ago 
+ 4 │ youshouldeatmorecereal.txt │ File │          │ 768 B  │ a month ago │ a month ago │ a month ago 
+━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━┷━━━━━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━
+> ls | reject readonly
+━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━
+ # │ name                       │ type │ size   │ created     │ accessed    │ modified 
+───┼────────────────────────────┼──────┼────────┼─────────────┼─────────────┼─────────────
+ 0 │ zeusiscrazy.txt            │ File │ 556 B  │ a month ago │ a month ago │ a month ago 
+ 1 │ coww.txt                   │ File │  24 B  │ a month ago │ a month ago │ a month ago 
+ 2 │ randomweirdstuff.txt       │ File │ 197 B  │ a month ago │ a month ago │ a month ago 
+ 3 │ abaracadabra.txt           │ File │ 401 B  │ a month ago │ a month ago │ a month ago 
+ 4 │ youshouldeatmorecereal.txt │ File │ 768 B  │ a month ago │ a month ago │ a month ago 
+━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━
+> ls | reject readonly accessed
+━━━┯━━━━━━━━━━━━━━━━━━━━━━━━━━━━┯━━━━━━┯━━━━━━━━┯━━━━━━━━━━━━━┯━━━━━━━━━━━━━
+ # │ name                       │ type │ size   │ created     │ modified 
+───┼────────────────────────────┼──────┼────────┼─────────────┼─────────────
+ 0 │ zeusiscrazy.txt            │ File │ 556 B  │ a month ago │ a month ago 
+ 1 │ coww.txt                   │ File │  24 B  │ a month ago │ a month ago 
+ 2 │ randomweirdstuff.txt       │ File │ 197 B  │ a month ago │ a month ago 
+ 3 │ abaracadabra.txt           │ File │ 401 B  │ a month ago │ a month ago 
+ 4 │ youshouldeatmorecereal.txt │ File │ 768 B  │ a month ago │ a month ago 
+━━━┷━━━━━━━━━━━━━━━━━━━━━━━━━━━━┷━━━━━━┷━━━━━━━━┷━━━━━━━━━━━━━┷━━━━━━━━━━━━━
+```