1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
[comment {-*- tcl -*- doctools manpage}]
[manpage_begin diagram-viewer n 1.0]
[keywords canvas]
[keywords conversion]
[keywords diagram]
[keywords vector]
[copyright {2010 Andreas Kupries <andreas_kupries@users.sourceforge.net>}]
[titledesc {Lightweight Diagram Processor}]
[moddesc {Documentation toolbox}]
[category {Documentation tools}]
[description]
[para]
The application described by this document, [syscmd diagram-viewer], is a
lightweight processor for tklib diagram files
[para]
[syscmd diagram-viewer] is based upon the package [package diagram].
See it for examples and language reference.
[subsection {USE CASES}]
[syscmd diagram-viewer] was written with the following two use cases in
mind.
[para]
[list_begin enumerated]
[enum]
Processing and display of one or more diagram files.
[enum]
Batch conversion of one or more diagram files into raster image files.
[list_end]
[para]
[subsection {COMMAND LINE}]
[list_begin definitions]
[call [cmd diagram-viewer] [method show] [arg inputfile]...]
This is the form for use case [lb]1[rb]. The application opens a gui
showing the list of input files to the left, allowing the user to
choose which of them to render to the canvas on the right.
[call [cmd diagram-viewer] [method convert] [option -o] [arg output] [arg format] [arg inputfile]...]
This is the form for use case [lb]2[rb]. The application converts
the input files into raster image of the specified [arg format].
[list_begin arguments]
[arg_def path output in]
This argument specifies where to write the generated image. It can
be the path to a file or directory.
[para]
If the [arg output] does not exist then [lb]file dirname $output[rb]
has to exist and must be a writable directory.
[para]
In case of multiple input files the generated image will be written to
a file in the directory, and the name of that file will be derived
from the [arg inputfile], and [arg format].
[para]
In case of a single input file the generated image will be written to
the file.
[arg_def (handle) format in]
This argument specifies the image format to convert the diagrams into
when processing the input. The application recognizes all formats
supported by the [package Img] package, i.e. for which it can load a
package [package img::[var format]]
[arg_def path inputfile in]
This argument specifies the path to the diagram file to process. It
has to exist, must be readable, and written in [term diagram] format.
[list_end]
[para]
[list_end]
[section {BUGS, IDEAS, FEEDBACK}]
This document, and the application it describes, will undoubtedly
contain bugs and other problems.
Please report such in the category [emph diagram] of the
[uri {http://sourceforge.net/tracker/?group_id=12883} {Tcllib SF Trackers}].
Please also report any ideas for enhancements you may have for either
application and/or documentation.
[vset CATEGORY diagram]
[include ../support/devel/doc/feedback.inc]
[manpage_end]
|
