Seth/sethLabels
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 1 Wiki Activity

Merge branch 'RefactorPrint'

Browse Source 
- Modifies printing model to be similar to glabels-3.x.
   - Allow simple projects to print by-the-page (#51)
   - Added collated vs uncollated document merges
- Added ability to separate merge groups by page
- Updated man pages
- Updated misc developer documentation
This commit is contained in:
Jim Evins
2020-01-01 14:19:11 -05:00
parent af607ca4af
commit aebcda43cb
23 changed files with 1184 additions and 380 deletions
Download Patch File Download Diff File Expand all files Collapse all files
user-docs/man/glabels-batch-qt.rst
+48 -32
View File
@@ -9,55 +9,61 @@ SYNOPSIS
DESCRIPTION
-----------
:program:`glabels-batch-qt` is a utility for printing files previously
prepared with :program:`glabels-qt` from the command line. It is suitable
for use with scripts.
:program:`glabels-batch-qt` is a utility for printing a glabels project file
from the command line. It is suitable for use with scripts.
OPTIONS
-------
.. program:: glabels-batch-qt
.. option:: -h, --help
Displays usage information and exits.
.. option:: -v, --version
Displays version information and exits.
.. option:: -p <printer>, --printer <printer>
Send output to <printer>.
.. option:: -o [<filename>], --output [<filename>]
Set output filename to <filename>. Set to "-" for stdout.
Set output filename to <filename>. If filename is "-", write to standard output.
(Default="output.pdf")
.. option:: -s <n>, --sheets <n>
Set number of sheets to <n>. (Default=1)
For simple projects, sets number of full sheets to <n>. (Default=1)
.. option:: -c <n>, --copies <n>
Set number of copies to <n>. (Default=1)
.. option:: -a, --collate
Collate merge copies.
.. option:: -g, --group
Start each merge group on a new page.
.. option:: -f <n>, --first <n>
Set starting label on 1st page to <n>. (Default=1)
Set starting position to <n>. (Default=1)
.. option:: -l, --outlines
Print label outlines.
.. option:: -m, --crop-marks
Print crop marks.
.. option:: -r, --reverse
Print in reverse (mirror image).
.. option:: -D <var>=<value>, --define <var>=<value>
@@ -68,21 +74,31 @@ FILES
-----
.. describe:: ${prefix}/share/glabels-qt/templates/
Directory containing predefined product templates distributed with glabels.
.. describe:: ${XDG_CONFIG_HOME}/glabels.org/glabels-qt/
Directory containing user defined product templates created with the
gLabels Product Template Designer. **Do not place manually created
templates here!**
.. describe:: ${HOME}/.glabels/
Directory for manually created product templates.
BUGS
----
KNOWN ISSUES
------------
On GNU/Linux platforms, :program:`glabels-batch-qt` must be run from within a windowing environment, such as X or Wayland. This is because Qt requires a suitable platform to obtain system font information. A work-around is to run :program:`glabels-batch-qt` using a virtual X server environment:
.. code:: shell
xvfb-run glabels-batch-qt -o output.pdf myProject.glabels
REPORTING BUGS
--------------
On GNU/Linux platforms, :program:`glabels-batch-qt` must be run from within a windowing environment, such as X or Wayland. This is because Qt requires a suitable platform to obtain system font information. A work-around is to run :program:`glabels-batch-qt` using a virtual X server environment:
@@ -100,5 +116,5 @@ SEE ALSO
--------
:manpage:`glabels-qt(1)`
The gLabels homepage at <http://glabels.org/>.
user-docs/man/glabels-qt.rst
+10 -10
View File
@@ -17,30 +17,30 @@ OPTIONS
-------
.. program:: glabels-qt
.. option:: -h, --help
Displays usage information and exits.
.. option:: -v, --version
Displays version information and exits.
FILES
-----
.. describe:: ${prefix}/share/glabels-qt/templates/
Directory containing predefined product templates distributed with glabels.
.. describe:: ${XDG_CONFIG_HOME}/glabels.org/glabels-qt/
Directory containing user defined product templates created with the
gLabels Product Template Designer. **Do not place manually created
templates here!**
.. describe:: ${HOME}/.glabels/
Directory for manually created product templates.
REPORTING BUGS
@@ -53,5 +53,5 @@ SEE ALSO
--------
:manpage:`glabels-batch-qt(1)`
The gLabels homepage at <http://glabels.org/>.