1# Copyright (c) 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 26Usage: bsdconfig @PROGRAM_NAME@ [OPTIONS] [include ...] 27 28OPTIONS: 29 -a Always use color even when output is not to a terminal. 30 -d Print description for each function selected. Implies `-f'. 31 -f Show functions for selected includes. 32 -F pattern 33 If `-f', only print functions matching pattern. Without `-f' 34 print only includes containing functions matching pattern. 35 -h Print this usage statement and exit. 36 -n Disable the use of color. 37 38EXAMPLES: 39 View a list of available includes: 40 41 bsdconfig @PROGRAM_NAME@ 42 43 View functions for all available includes (function names are 44 highlighted): 45 46 bsdconfig @PROGRAM_NAME@ -f 47 48 View functions with less(1) (function names are not highlighted): 49 50 bsdconfig @PROGRAM_NAME@ -f | less 51 52 View functions with less(1) and color: 53 54 bsdconfig @PROGRAM_NAME@ -af | less -R 55 56 View functions from `common.subr': 57 58 bsdconfig @PROGRAM_NAME@ common.subr 59 60 NB: The `-f' flag is implied when given an include. 61 62 Show only functions containing the word `show' in common.subr: 63 64 bsdconfig @PROGRAM_NAME@ -F show common 65 66 NB: The `.subr' suffix on the end of the include is optional. 67 68 Show descriptions of each of the `show' functions: 69 70 bsdconfig @PROGRAM_NAME@ -dF show 71