docs: separate cli and gui docs

Author: changkun

README.md

@@ -1,6 +1,6 @@
 # clipboard [![PkgGoDev](https://pkg.go.dev/badge/golang.design/x/clipboard)](https://pkg.go.dev/golang.design/x/clipboard) ![](https://changkun.de/urlstat?mode=github&repo=golang-design/clipboard) ![clipboard](https://github.com/golang-design/clipboard/workflows/clipboard/badge.svg?branch=main)
 
-Cross platform clipboard package in Go
+Cross platform (macOS/Linux/Windows/Android/iOS) clipboard package in Go
 
 ```go
 import "golang.design/x/clipboard"
@@ -12,7 +12,7 @@ import "golang.design/x/clipboard"
 - Copy/paste UTF-8 text
 - Copy/paste PNG encoded images (Desktop-only)
 - Command `gclip` as a demo application
-- Mobile app `Gclip` as a demo application
+- Mobile app `gclip-gui` as a demo application
 
 ## API Usage
 
@@ -62,6 +62,12 @@ for data := range ch {
 }
 ```
 
+## Demos
+
+- A command line tool `gclip` for command line clipboard accesses, see document [here](./cmd/gclip/README.md).
+- A GUI application `gclip-gui` for functionality verifications on mobile systems, see a document [here](./cmd/gclip-gui/README.md).
+
+
 ## Command Usage
 
 `gclip` command offers the ability to interact with the system clipboard

clipboard.go

@@ -5,9 +5,11 @@
 // Written by Changkun Ou <changkun.de>
 
 /*
-Package clipboard provides three major APIs for manipulating the
-clipboard: `Read`, `Write`, and `Watch`. The most common operations are
-`Read` and `Write`. To use them:
+Package clipboard provides cross platform clipboard access and supports
+macOS/Linux/Windows/Android/iOS platform. There are three major APIs
+to interact with the clipboard: `Read`, `Write`, and `Watch`.
+
+The most common operations are `Read` and `Write`. To use them:
 
 	// write/read text format data of the clipboard, and
 	// the byte buffer regarding the text are UTF8 encoded.

cmd/gclip-gui/README.md

@@ -22,6 +22,10 @@ provided in the [GoMobile wiki](https://github.com/golang/go/wiki/Mobile) page.
 
 ## Screenshots
 
-| macOS | iOS |
-|:------:|:---:|
-|![](./darwin.png)|![](./ios.png)|
+| macOS | iOS | Windows |
+|:------:|:---:|:------:|
+|![](./darwin.png)|![](./ios.png)|![](./windows.png)
+
+## License
+
+MIT | © 2021 The golang.design Initiative Authors, written by [Changkun Ou](https://changkun.de).

cmd/gclip-gui/windows.png

@@ -0,0 +1,40 @@
+# gclip
+
+`gclip` command offers the ability to interact with the system clipboard
+from the shell. To install:
+
+```bash
+$ go install golang.design/x/clipboard/cmd/gclip@latest
+```
+
+```bash
+$ gclip
+gclip is a command that provides clipboard interaction.
+usage: gclip [-copy|-paste] [-f <file>]
+options:
+  -copy
+        copy data to clipboard
+  -f string
+        source or destination to a given file path
+  -paste
+        paste data from clipboard
+examples:
+gclip -paste                    paste from clipboard and prints the content
+gclip -paste -f x.txt           paste from clipboard and save as text to x.txt
+gclip -paste -f x.png           paste from clipboard and save as image to x.png
+cat x.txt | gclip -copy         copy content from x.txt to clipboard
+gclip -copy -f x.txt            copy content from x.txt to clipboard
+gclip -copy -f x.png            copy x.png as image data to clipboard
+```
+
+If `-copy` is used, the command will exit when the data is no longer
+available from the clipboard. You can always send the command to the
+background using a shell `&` operator, for example:
+
+```bash
+$ cat x.txt | gclip -copy &
+```
+
+## License
+
+MIT | &copy; 2021 The golang.design Initiative Authors, written by [Changkun Ou](https://changkun.de).