7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# CDDL HEADER START
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# The contents of this file are subject to the terms of the
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# Common Development and Distribution License (the "License").
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# You may not use this file except in compliance with the License.
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# See the License for the specific language governing permissions
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# and limitations under the License.
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# When distributing Covered Code, include this CDDL HEADER in each
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# If applicable, add the following below this CDDL HEADER, with the
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# fields enclosed by brackets "[]" replaced with your own identifying
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# information: Portions Copyright [yyyy] [name of copyright owner]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# CDDL HEADER END
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner# Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# Solaris needs /usr/xpg6/bin:/usr/xpg4/bin because the tools in /usr/bin are not POSIX-conformant
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chinexport PATH=/usr/xpg6/bin:/usr/xpg4/bin:/bin:/usr/bin
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# Make sure all math stuff runs in the "C" locale to avoid problems
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# with alternative # radix point representations (e.g. ',' instead of
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# '.' in de_DE.*-locales). This needs to be set _before_ any
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# floating-point constants are defined in this script).
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin # don't use "--" here to allow "-f" for formatting
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# print -u2 "$@"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# Build a list of compound variables calculated from MANPATH and
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# locale which contain...
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# "manpath_element" - the MANPATH element this entry belongs to
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# "dir" - physical directory of "manpath_element"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# "sect" - section (if "manpath_element" is something like /usr/share/man,1b)
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# ... and put the result in the array named by argv[1]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin print -r -- "${MANPATH//:/$'\n'}" | while read manpath_element ; do
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin # strip section from manpath elements like "/usr/share/man,1b"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin if [[ "${manlang}" != "" && -d "${dir}/${manlang}" ]] ; then
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin typeset x s l
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin x="$(egrep -v '^#|^[[:space:]]*$' <"${mancf}" | egrep '^MANSECTS=')"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin while read s ; do \
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin while read l ; do
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin [[ "${l}" != ~(Elr)[[:blank:]]* ]] && ms+=( "${l}" )
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# print -- "sect=$l"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# printf "enumerate_mansects: found %d entries.\n" ${#ms[@]}
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# wrapper around more/less
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin # squish characters in filename which are not allowed in a filesystem
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin # check if we have "less" installed, if not fall back to /usr/xpg4/bin/more
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin if which less >/dev/null 2>&1 ; then
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin # use "cat" here to avoid that "less" may try funny things
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin cat <"${doc_filename}" | less -I -M $"--prompt=MManual\ page\ ${doc_title}\ ?ltline\ %lt?L/%L.:"
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner tmpdirname="$(mktemp -t -d "shman_${PPID}_$$_XXXXXX")"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin mkdir -p "${tmpdirname}" || { print -u2 -f $"Couldn't create tmp. dir %s\n" "${tmpdirname}" ; return 1 ; }
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# /usr/bin/man <keyword>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# debug_print -- "${mandirs[@]}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# debug_print -- "mansects=${mansects[@]}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin typeset match="${mandir}/sman${mansect}/${manname}.${mansect}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin # follow SGML links if needed (needs rework, including protection against link loops)
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin while true ; do
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin tmp="$(cd "${mandir}" ; LC_MESSAGES=C /usr/lib/sgml/sgml2roff "${match}")"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin tbl <<<"${tmp}" | eqn | nroff -u0 -Tlp -man - | col -x | browse_manpage /dev/stdin "${manname}(${mansect})"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin match="${mandir}/man${mansect}/${manname}.${mansect}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin tbl <"${match}" | eqn | nroff -u0 -Tlp -man - | col -x | browse_manpage /dev/stdin "${manname}(${mansect})"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# /usr/bin/man -l <keyword>
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# debug_print -- "mansects=${mansects[@]}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin match="${mandir}/sman${mansect}/${manname}.${mansect}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin printf "%s (%s)\t-M %s\n" "${manname}" "${mansect}" "${mandir}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin match="${mandir}/man${mansect}/${manname}.${mansect}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin printf "%s (%s)\t-M %s\n" "${manname}" "${mansect}" "${mandir}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin print -u2 -f $"%s: Can't open %s.\n" "${progname}" "${windexfile}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin if [[ "${name}${namesec}${title}" == ~(Fi)${manname} ]] ; then
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin printf "%s\t%s\t%s\n" "${name}" "${namesec}" "${title}"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# program start
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner[-?\n@(#)\$Id: shman (Roland Mainz) 2009-12-02 \$\n]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[-author?Roland Mainz <roland.mainz@nrubsig.org>]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[-author?Roland Mainz <roland.mainz@sun.com>]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[+NAME?man - find and display reference manual pages]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[+DESCRIPTION?The man command displays information from the reference
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin manuals. It displays complete manual pages that you select
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin by name, or one-line summaries selected either by keyword
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin (-k), or by the name of an associated file (-f). If no
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin manual page is located, man prints an error message.]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[+?write me.]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[k:keyword?Prints out one-line summaries from the windex database (table of contents) that
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin contain any of the given keywords. The windex database is created using
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin catman(1M).]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[l:list?Lists all manual pages found matching name within the search path.]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[M:mpath?Specifies an alternate search path for manual pages. path is a colon-separated
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin list of directories that contain manual page directory subtrees. For example, if
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin path is /usr/share/man:/usr/local/man, man searches for name in the standard
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin location, and then /usr/local/man. When used with the -k or -f options, the -M
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin option must appear first. Each directory in the path is assumed to contain subdirectories of the form man* or sman* ,
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin one for each section. This option overrides the MANPATH environment variable.]:[path]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[s:section?Specifies sections of the manual for man to search. The directories searched for
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin name are limited to those specified by section. section can be a numerical
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin digit, perhaps followed by one or more letters to match the desired section of
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin the manual, for example, "3libucb". Also, section can be a word, for example,
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin local, new, old, public. section can also be a letter.
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin To specify multiple sections, separate each section with
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin a comma. This option overrides the MANPATH environment variable and the man.cf
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin See Search Path below for an explanation of how man conducts its search.]:[section]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin[+SEE ALSO?\bksh93\b(1), \bman\b(1)]
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chinwhile getopts -a "${progname}" "${man_usage}" OPT ; do
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# printmsg "## OPT=|${OPT}|, OPTARG=|${OPTARG}|"
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# cd /usr/man; LC_MESSAGES=C /usr/lib/sgml/sgml2roff /usr/man/sman1as/asadmin-list-timers.1as | tbl | eqn | nroff -u0 -Tlp -man - | col -x > /tmp/mpLQaqac
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz# process arguments
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz debug_print -f "# searching for %s ...\n" "${manname}"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz elif ${do_list} ; then
7c2fbfb345896881c631598ee3852ce9ce33fb07April Chin# todo: better exit codes