Skip to content

Commit

Permalink
Merge pull request #791 from yangfl/master
Browse files Browse the repository at this point in the history
Debian: Improve packaging for debian.
  • Loading branch information
hluk committed Sep 11, 2017
2 parents 5af4bf4 + 0b30505 commit 7526a43
Show file tree
Hide file tree
Showing 7 changed files with 247 additions and 42 deletions.
2 changes: 1 addition & 1 deletion debian/compat
Original file line number Diff line number Diff line change
@@ -1 +1 @@
9
10
6 changes: 3 additions & 3 deletions debian/control
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
Source: copyq
Section: misc
Section: utils
Priority: optional
Maintainer: Lukas Holecek <hluk@email.cz>
Build-Depends:
cmake,
debhelper (>= 9),
debhelper (>= 10),
libqt5svg5-dev,
libxfixes-dev,
libxtst-dev,
qtbase5-private-dev,
qtscript5-dev,
qttools5-dev,
qttools5-dev-tools,
Standards-Version: 4.0.0
Standards-Version: 4.1.0
Homepage: https://hluk.github.io/CopyQ/
Vcs-Browser: https://github.com/hluk/CopyQ
Vcs-Git: https://github.com/hluk/CopyQ.git
Expand Down
205 changes: 205 additions & 0 deletions debian/copyq.1
Original file line number Diff line number Diff line change
@@ -0,0 +1,205 @@
.TH CopyQ 1
.SH NAME
CopyQ \- Clipboard Manager with Advanced Features


.SH SYNOPSIS
.B copyq
[\fBCOMMAND\fR]


.SH DESCRIPTION
.B CopyQ
is advanced clipboard manager with editing and scripting features. It monitors system clipboard and saves its content in customized tabs. Saved clipboard can be later copied and pasted directly into any application.


.SH COMMANDS
Starts server if no command is specified.

.TP
.BR show " [\fINAME\fR]"
Show main window and optionally open tab with given name.
.TP
.B hide
Hide main window.
.TP
.B toggle
Show or hide main window.
.TP
.B menu
Open context menu.
.TP
.B exit
Exit server.
.TP
.BR disable ", " enable
Disable or enable clipboard content storing.

.sp
.TP
.BR clipboard " [\fIMIME\fR]"
Print clipboard content.
.TP
.BR selection " [\fIMIME\fR]"
Print X11 selection content.
.TP
.B paste
Paste clipboard to current window (may not work with some applications).
.TP
.BR copy " \fITEXT\fR"
Set clipboard text.
.TP
.BR copy " \fIMIME\fR \fIDATA\fR [\fIMIME\fR \fIDATA\fR]..."
Set clipboard content.

.sp
.TP
.B count
Print amount of items in current tab.
.TP
.BR select " [\fIROW=0\fR]"
Copy item in the row to clipboard.
.TP
.B next
Copy next item from current tab to clipboard.
.TP
.B previous
Copy previous item from current tab to clipboard.
.TP
.BR add " \fITEXT\fR..."
Add text into clipboard.
.TP
.BR insert " \fIROW\fR \fITEXT\fR"
Insert text into given row.
.TP
.BR remove " [\fIROWS=0\fR...]"
Remove items in given rows.
.TP
.BR edit " [\fIROW=-1\fR...]"
Edit items or edit new one.
Value -1 is for current text in clipboard.

.sp
.TP
.BR separator " \fISEPARATOR\fR"
Set separator for items on output.
.TP
.BR read " [\fIMIME\fR|\fIROW\fR]..."
Print raw data of clipboard or item in row.
.TP
.BR write " [\fIROW=0\fR] \fIMIME\fR \fIDATA\fR [\fIMIME\fR \fIDATA\fR]..."
Write raw data to given row.

.sp
.TP
.BR action " [\fIROWS=0.\fR..]"
Show action dialog.
.TP
.BR action " [\fIROWS=0\fR...] [\fIPROGRAM\fR [\fISEPARATOR=\[rs]n\fR]]"
Run PROGRAM on item text in the rows.
Use %1 in PROGRAM to pass text as argument.
.TP
.BR popup " \fITITLE\fR \fIMESSAGE\fR [\fITIME=8000\fR]"
Show tray popup message for TIME milliseconds.

.sp
.TP
.B tab
List available tab names.
.TP
.BR tab " \fINAME\fR [\fICOMMAND\fR]"
Run command on tab with given name.
Tab is created if it doesn't exist.
Default is the first tab.
.TP
.BR removetab " \fINAME\fR"
Remove tab.
.TP
.BR renametab " \fINAME\fR \fINEW_NAME\fR"
Rename tab.

.sp
.TP
.BR exporttab " \fIFILE_NAME\fR"
Export items to file.
.TP
.BR importtab " \fIFILE_NAME\fR"
Import items from file.

.sp
.TP
.B config
List all options.
.TP
.BR config " \fIOPTION\fR"
Get option value.
.TP
.BR config " \fIOPTION\fR \fIVALUE\fR"
Set option value.

.sp
.TP
.BR eval ", " \-e " [\fISCRIPT\fR] [\fIARGUMENTS\fR]..."
Evaluate ECMAScript program.
Arguments are accessible using with "arguments[0..N]".
.TP
.BR session ", " \-s ", " \-\-session " \fISESSION\fR"
Starts or connects to application instance with given session name.
.TP
.BR help ", " \-h ", " \-\-help " [\fICOMMAND\fR]..."
Print help for COMMAND or all commands.


.SH NOTES
Use \fBdash argument\fR (\fB\-\fR) to read data from stdandard input.
.sp
Use \fBdouble-dash argument\fR (\fB\-\-\fR) to read all following arguments without expanding escape sequences (i.e. \\n, \\t and others).
.sp
Use \fB?\fR for MIME to print available MIME types (default is "text/plain").
.sp
You can read more about it at
.B https://copyq.readthedocs.io/en/latest/basic-usage.html


.SH EXAMPLES

.TP
Insert some texts to the history:
copyq add "first item" "second item" "third item"

.TP
Print content of the first three items:
copyq read 0 1 2
copyq separator "," read 0 1 2

.TP
Show current clipboard content:
copyq clipboard
copyq clipboard text/html
copyq clipboard \\? # lists formats in clipboard

.TP
Copy text to the clipboard:
copyq copy "Some Text"

.TP
Load file content into clipboard:
copyq copy - < file.txt
copyq copy text/html < index.html
copyq copy image/jpeg - < image.jpg

.TP
Create an image items:
copyq write image/gif - < image.gif
copyq write image/svg - < image.svg


.SH SEE ALSO
.B http://copyq.readthedocs.io/


.SH AUTHOR
.B CopyQ
The maintainer of CopyQ is Lukas Holecek <hluk@email.cz>. A comprehensive list of authors and contributors is available in the website mentioned above.

This manual page was written by GengYu Rao (zouyoo@outlook.com), for the Debian project (and may be used by others).
3 changes: 3 additions & 0 deletions debian/copyq.docs
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
AUTHORS
HACKING
README.md
70 changes: 33 additions & 37 deletions debian/copyright
Original file line number Diff line number Diff line change
@@ -1,22 +1,11 @@
Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: CopyQ
Upstream-Contact: Lukas Holecek <hluk@email.cz>
Source: https://github.com/hluk/CopyQ
Files-Excluded: src/images/*.ttf

Files: *
Copyright: 2009-2017 Lukas Holecek <hluk@email.cz>
License: GPL-3+
Comment:
CopyQ is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
.
CopyQ is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
License: GPL-3.0+

Files: src/images/fontawesome-webfont.ttf
Copyright: Font Awesome by Dave Gandy - http://fontawesome.io
Expand Down Expand Up @@ -157,53 +146,60 @@ License: BSD-3-clause
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Files: debian/*
Copyright: Dmitry Smirnov <onlyjob@debian.org>
Copyright: 2015 Dmitry Smirnov <onlyjob@debian.org>
2017 Boyuan Yang <073plan@gmail.com>
License: GPL-3+
2017 Yangfl <mmyangfl@gmail.com>
License: GPL-3.0+

License: GPL-3+
This program is free software; you can redistribute it and/or modify
Files: debian/copyq.1
Copyright: 2017 GengYu Rao <zouyoo@outlook.com>
License: GPL-3.0+

License: GPL-3.0+
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3, or (at your option)
any later version.
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
.
This program is distributed in the hope that it will be useful,
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
.
The complete text of the GNU General Public License can be found
in "/usr/share/common-licenses/GPL-3".
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
.
On Debian systems, the complete text of the GNU General
Public License version 3 can be found in "/usr/share/common-licenses/GPL-3".

License: LGPL-2.1
This library is free software; you can redistribute it and/or
This package is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License version 2.1 as published by the Free Software Foundation.
.
This library is distributed in the hope that it will be useful,
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
.
The complete text of the GNU Lesser General Public License
can be found in "/usr/share/common-licenses/LGPL-2.1".
On Debian systems, the complete text of the GNU Lesser General
Public License can be found in "/usr/share/common-licenses/LGPL-2.1".

License: LGPL-3
This package is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License version 3
as published by the Free Software Foundation.
This package is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License version 3 as published by the Free Software Foundation.
.
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
.
You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>
along with this program. If not, see <https://www.gnu.org/licenses/>.
.
The complete text fo the GNU Lesser General Public License version 3
can be found in "/usr/share/common-licenses/LGPL-3"
On Debian systems, the complete text of the GNU Lesser General
Public License can be found in "/usr/share/common-licenses/LGPL-3".
1 change: 1 addition & 0 deletions debian/manpages
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
debian/copyq.1
2 changes: 1 addition & 1 deletion debian/source/format
Original file line number Diff line number Diff line change
@@ -1 +1 @@
3.0 (native)
3.0 (quilt)

0 comments on commit 7526a43

Please sign in to comment.