1 # Copyright (c) 2012-2013 Devin Teske
4 # Redistribution and use in source and binary forms, with or without
5 # modification, are permitted provided that the following conditions
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.
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
27 Usage: bsdconfig @PROGRAM_NAME@ [OPTIONS]
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.
36 View dot(1) language output describing bsdconfig(8) layout/make-up:
38 bsdconfig @PROGRAM_NAME@ | less
40 Render dot(1) output in SVG format (displays in most modern browsers):
42 bsdconfig @PROGRAM_NAME@ | dot -Tsvg -o bsdconfig.svg
44 NOTE: Requires `graphics/graphviz' from ports/packages.
46 View the above-rendered SVG file using your favorite X11-based viewer:
50 NOTE: Requires `graphics/gimmage' from ports/packages.
56 NOTE: Image is scaled to fit window on launch.
57 NOTE: Requires `graphics/gthumb' from ports/packages.
63 NOTE: Requires `graphics/gqview' from ports/packages.
69 NOTE: Image is scaled to fit window on launch.
70 NOTE: Requires `graphics/gx' from ports/packages.
76 NOTE: Requires `graphics/eog' from ports/packages.
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):
82 bsdconfig @PROGRAM_NAME@ | dot -Teps -o bsdconfig.eps
83 poster -v -mLet -s1 -o bsdconfig.ps bsdconfig.eps
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.
88 NOTE: Requires both `graphics/graphviz' and `print/poster' from
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:
94 bsdconfig @PROGRAM_NAME@ | dot -Teps -o bsdconfig.eps
95 poster -v -mLet -p2x4Letter -o bsdconfig.ps bsdconfig.eps
97 NOTE: Requires both `graphics/graphviz' and `print/poster' from
100 View the above-rendered PostScript poster using X11:
104 NOTE: Requires `print/gsview' from ports/packages.
108 convert bsdconfig.ps bsdconfig.pdf
111 NOTE: Requires both `graphics/ImageMagick' and
112 `graphics/xdpf' from ports/packages.
114 NOTE: The converted PDF file is not suitable for
115 printing due to loss of quality during the
118 Print the above-rendered PostScript poster:
122 NOTE: Requires configuration of a printer in `/etc/printcap'.
124 Extract each page of the poster into a separate PNG file:
126 gs -q -dNOPAUSE -dBATCH -sPAPERSIZE=letter \
127 -dTextAlphaBits=4 -dGraphicsAlphaBits=4 \
128 -sDEVICE=png16m -sOutputFile=bsdconfig%03d.png \
131 NOTE: Requires `print/ghostscript9' from ports/packages.
133 NOTE: The converted PNG files are not suitable for printing
134 due to loss of quality during the conversion process.
136 Extract a single page of the poster into a separate PostScript file for
137 printing individual pages from the command-line:
139 psselect 1 bsdconfig.ps bsdconfig-page1.ps
140 lpr -h bsdconfig-page1.ps
142 NOTE: Change "1" to "2" for the second page, ad-infinitum.
143 NOTE: Requires `print/psutils-letter' from ports/packages.