From 83db5c34c3c7f59c5c7e75204d66f7a6b4037ac8 Mon Sep 17 00:00:00 2001
From: Shaurya Shubham <shauryashubham1234567890@gmail.com>
Date: Sat, 25 Jan 2020 21:01:20 +0530
Subject: [PATCH] Add docs for the from-ods and from-xlsx commands (#1279)

---
 docs/commands/from-ods.md  | 29 +++++++++++++++++++++++++++++
 docs/commands/from-xlsx.md | 29 +++++++++++++++++++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 docs/commands/from-ods.md
 create mode 100644 docs/commands/from-xlsx.md

diff --git a/docs/commands/from-ods.md b/docs/commands/from-ods.md
new file mode 100644
index 0000000000..0d72c16919
--- /dev/null
+++ b/docs/commands/from-ods.md
@@ -0,0 +1,29 @@
+# from-ods 
+
+Parses OpenDocument Spreadsheet binary data into a table. `open` calls `from-ods` automatically when the file extension  is `ods`. Use this command when `open` is unable to guess the file type from the extension.
+
+## Examples 
+
+```sh 
+> open abc.ods
+─────────────────
+ Sheet1 
+─────────────────
+ [table 26 rows] 
+─────────────────
+> open abc.ods --raw
+Length: 4816 (0x12d0) bytes
+0000:   50 4b 03 04  14 00 00 00  00 00 00 00  00 00 85 6c   PK.............l
+0010:   39 8a 2e 00  00 00 2e 00  00 00 08 00  00 00 6d 69   9.............mi
+0020:   6d 65 74 79  70 65 61 70  70 6c 69 63  61 74 69 6f   metypeapplicatio
+... 
+12a0:   00 61 10 00  00 4d 45 54  41 2d 49 4e  46 2f 6d 61   .a...META-INF/ma
+12b0:   6e 69 66 65  73 74 2e 78  6d 6c 50 4b  05 06 00 00   nifest.xmlPK....
+12c0:   00 00 06 00  06 00 5a 01  00 00 60 11  00 00 00 00   ......Z...`.....
+> open abc.ods --raw | from-ods
+─────────────────
+ Sheet1 
+─────────────────
+ [table 26 rows] 
+─────────────────
+```
diff --git a/docs/commands/from-xlsx.md b/docs/commands/from-xlsx.md
new file mode 100644
index 0000000000..18d738ca26
--- /dev/null
+++ b/docs/commands/from-xlsx.md
@@ -0,0 +1,29 @@
+# from-xlsx 
+
+Parses MS Excel binary data into a table. `open` calls `from-xlsx` automatically when the file extension  is `xlsx`. Use this command when `open` is unable to guess the file type from the extension.
+
+## Examples 
+
+```sh 
+> open abc.xlsx
+─────────────────
+ Sheet1 
+─────────────────
+ [table 26 rows] 
+─────────────────
+> open abc.xlsx --raw
+Length: 6344 (0x18c8) bytes
+0000:   50 4b 03 04  14 00 00 00  08 00 00 00  00 00 d5 5f   PK............._
+0010:   a7 48 68 01  00 00 23 05  00 00 13 00  00 00 5b 43   .Hh...#.......[C
+0020:   6f 6e 74 65  6e 74 5f 54  79 70 65 73  5d 2e 78 6d   ontent_Types].xm
+... 
+18a0:   6b 73 68 65  65 74 73 2f  73 68 65 65  74 31 2e 78   ksheets/sheet1.x
+18b0:   6d 6c 50 4b  05 06 00 00  00 00 0a 00  0a 00 7f 02   mlPK............
+18c0:   00 00 33 16  00 00 00 00                             ..3.....
+> open abc.xlsx --raw | from-xlsx
+─────────────────
+ Sheet1 
+─────────────────
+ [table 26 rows] 
+─────────────────
+```