1# Copyright (c) 2012-2013 Devin Teske
2# All rights reserved.
3#
4# Redistribution and use in source and binary forms, with or without
5# modification, are permitted provided that the following conditions
6# are met:
7# 1. Redistributions of source code must retain the above copyright
8#    notice, this list of conditions and the following disclaimer.
9# 2. Redistributions in binary form must reproduce the above copyright
10#    notice, this list of conditions and the following disclaimer in the
11#    documentation and/or other materials provided with the distribution.
12#
13# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16# ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23# SUCH DAMAGE.
24#
25# $FreeBSD$
26
27Usage: bsdconfig @PROGRAM_NAME@ [OPTIONS]
28
29OPTIONS:
30	-h    Print this usage statement and exit.
31	-c    Don't show command-line shortcut relationships.
32	-d    Don't show the date in the graph label.
33	-i    Don't show include relationships.
34
35EXAMPLES:
36	View dot(1) language output describing bsdconfig(8) layout/make-up:
37
38		bsdconfig @PROGRAM_NAME@ | less
39
40	Render dot(1) output in SVG format (displays in most modern browsers):
41
42		bsdconfig @PROGRAM_NAME@ | dot -Tsvg -o bsdconfig.svg
43
44		NOTE: Requires `graphics/graphviz' from ports/packages.
45
46	View the above-rendered SVG file using your favorite X11-based viewer:
47
48		gimmage bsdconfig.svg
49
50			NOTE: Requires `graphics/gimmage' from ports/packages.
51
52		or
53
54		gthumb bsdconfig.svg
55
56			NOTE: Image is scaled to fit window on launch.
57			NOTE: Requires `graphics/gthumb' from ports/packages.
58
59		or
60
61		gqview bsdconfig.svg
62
63			NOTE: Requires `graphics/gqview' from ports/packages.
64
65		or
66
67		gx bsdconfig.svg
68
69			NOTE: Image is scaled to fit window on launch.
70			NOTE: Requires `graphics/gx' from ports/packages.
71
72		or
73
74		eog bsdconfig.svg
75
76			NOTE: Requires `graphics/eog' from ports/packages.
77
78	Render dot(1) output as PostScript print output consisting of multiple
79	US-Letter sized pages that can be assembled into a large poster (using
80	traditional tools such as scissors and tape):
81
82		bsdconfig @PROGRAM_NAME@ | dot -Teps -o bsdconfig.eps
83		poster -v -mLet -s1 -o bsdconfig.ps bsdconfig.eps
84
85		NOTE: Change "-s1" above to "-s0.5" to halve the size of the
86		      poster or "-s2", for example, to double the poster size.
87
88		NOTE: Requires both `graphics/graphviz' and `print/poster' from
89		      ports/packages.
90
91	Render dot(1) output as PostScript scaled to fit on a poster consisting
92	of 2x-wide and 4x-tall US-Letter sized pages:
93
94		bsdconfig @PROGRAM_NAME@ | dot -Teps -o bsdconfig.eps
95		poster -v -mLet -p2x4Letter -o bsdconfig.ps bsdconfig.eps
96
97		NOTE: Requires both `graphics/graphviz' and `print/poster' from
98		      ports/packages.
99
100	View the above-rendered PostScript poster using X11:
101
102		gsview bsdconfig.ps
103
104			NOTE: Requires `print/gsview' from ports/packages.
105
106		or
107
108		convert bsdconfig.ps bsdconfig.pdf
109		xpdf bsdconfig.pdf
110
111			NOTE: Requires both `graphics/ImageMagick' and
112			      `graphics/xdpf' from ports/packages.
113
114			NOTE: The converted PDF file is not suitable for
115			      printing due to loss of quality during the
116			      conversion process.
117
118	Print the above-rendered PostScript poster:
119
120		lpr -h bsdconfig.ps
121
122		NOTE: Requires configuration of a printer in `/etc/printcap'.
123
124	Extract each page of the poster into a separate PNG file:
125
126		gs -q -dNOPAUSE -dBATCH -sPAPERSIZE=letter \
127		   -dTextAlphaBits=4 -dGraphicsAlphaBits=4 \
128		   -sDEVICE=png16m -sOutputFile=bsdconfig%03d.png \
129		   bsdconfig.ps
130
131		NOTE: Requires `print/ghostscript9' from ports/packages.
132
133		NOTE: The converted PNG files are not suitable for printing
134		      due to loss of quality during the conversion process.
135
136	Extract a single page of the poster into a separate PostScript file for
137	printing individual pages from the command-line:
138
139		psselect 1 bsdconfig.ps bsdconfig-page1.ps
140		lpr -h bsdconfig-page1.ps
141
142		NOTE: Change "1" to "2" for the second page, ad-infinitum.
143		NOTE: Requires `print/psutils-letter' from ports/packages.
144