freebsd-skq/usr.sbin/bsdconfig/dot/USAGE
dteske 6089bf07c7 Add new flags -d' (sets debug=1) and -D file' (sets debugFile) and
improve debugging initialization. Also fixup USAGE statements while we're
here. Also, change initialization of main program to _not_ change working
directory, allowing the debugFile to be relative without confusion.
2013-04-22 05:02:34 +00:00

144 lines
4.5 KiB
Plaintext

# Copyright (c) 2012-2013 Devin Teske
# All Rights Reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
# 1. Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
# DAMAGES (INLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE.
#
# $FreeBSD$
Usage: bsdconfig @PROGRAM_NAME@ [OPTIONS]
OPTIONS:
-h Print this usage statement and exit.
-c Don't show command-line shortcut relationships.
-d Don't show the date in the graph label.
-i Don't show include relationships.
EXAMPLES:
View dot(1) language output describing bsdconfig(8) layout/make-up:
bsdconfig @PROGRAM_NAME@ | less
Render dot(1) output in SVG format (displays in most modern browsers):
bsdconfig @PROGRAM_NAME@ | dot -Tsvg -o bsdconfig.svg
NOTE: Requires `graphics/graphviz' from ports/packages.
View the above-rendered SVG file using your favorite X11-based viewer:
gimmage bsdconfig.svg
NOTE: Requires `graphics/gimmage' from ports/packages.
or
gthumb bsdconfig.svg
NOTE: Image is scaled to fit window on launch.
NOTE: Requires `graphics/gthumb' from ports/packages.
or
gqview bsdconfig.svg
NOTE: Requires `graphics/gqview' from ports/packages.
or
gx bsdconfig.svg
NOTE: Image is scaled to fit window on launch.
NOTE: Requires `graphics/gx' from ports/packages.
or
eog bsdconfig.svg
NOTE: Requires `graphics/eog' from ports/packages.
Render dot(1) output as PostScript print output consisting of multiple
US-Letter sized pages that can be assembled into a large poster (using
traditional tools such as scissors and tape):
bsdconfig @PROGRAM_NAME@ | dot -Teps -o bsdconfig.eps
poster -v -mLet -s1 -o bsdconfig.ps bsdconfig.eps
NOTE: Change "-s1" above to "-s0.5" to halve the size of the
poster or "-s2", for example, to double the poster size.
NOTE: Requires both `graphics/graphviz' and `print/poster' from
ports/packages.
Render dot(1) output as PostScript scaled to fit on a poster consisting
of 2x-wide and 4x-tall US-Letter sized pages:
bsdconfig @PROGRAM_NAME@ | dot -Teps -o bsdconfig.eps
poster -v -mLet -p2x4Letter -o bsdconfig.ps bsdconfig.eps
NOTE: Requires both `graphics/graphviz' and `print/poster' from
ports/packages.
View the above-rendered PostScript poster using X11:
gsview bsdconfig.ps
NOTE: Requires `print/gsview' from ports/packages.
or
convert bsdconfig.ps bsdconfig.pdf
xpdf bsdconfig.pdf
NOTE: Requires both `graphics/ImageMagick' and
`graphics/xdpf' from ports/packages.
NOTE: The converted PDF file is not suitable for
printing due to loss of quality during the
conversion process.
Print the above-rendered PostScript poster:
lpr -h bsdconfig.ps
NOTE: Requires configuration of a printer in `/etc/printcap'.
Extract each page of the poster into a separate PNG file:
gs -q -dNOPAUSE -dBATCH -sPAPERSIZE=letter \
-dTextAlphaBits=4 -dGraphicsAlphaBits=4 \
-sDEVICE=png16m -sOutputFile=bsdconfig%03d.png \
bsdconfig.ps
NOTE: Requires `print/ghostscript9' from ports/packages.
NOTE: The converted PNG files are not suitable for printing
due to loss of quality during the conversion process.
Extract a single page of the poster into a separate PostScript file for
printing individual pages from the command-line:
psselect 1 bsdconfig.ps bsdconfig-page1.ps
lpr -h bsdconfig-page1.ps
NOTE: Change "1" to "2" for the second page, ad-infinitum.
NOTE: Requires `print/psutils-letter' from ports/packages.