# $Id: manlinks.sed,v 1.13 2008/01/19 23:31:17 tom Exp $ ############################################################################## # Copyright (c) 2000-2003,2008 Free Software Foundation, Inc. # # # # Permission is hereby granted, free of charge, to any person obtaining a # # copy of this software and associated documentation files (the "Software"), # # to deal in the Software without restriction, including without limitation # # the rights to use, copy, modify, merge, publish, distribute, distribute # # with modifications, sublicense, and/or sell copies of the Software, and to # # permit persons to whom the Software is furnished to do so, subject to the # # following conditions: # # # # The above copyright notice and this permission notice shall be included in # # all copies or substantial portions of the Software. # # # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL # # THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER # # DEALINGS IN THE SOFTWARE. # # # # Except as contained in this notice, the name(s) of the above copyright # # holders shall not be used in advertising or otherwise to promote the sale, # # use or other dealings in this Software without prior written # # authorization. # ############################################################################## # Given a manpage (nroff) as input, writes a list of the names that are # listed in the "NAME" section, i.e., the names that we would like to use # as aliases for the manpage -T.Dickey # # eliminate formatting controls that get in the way /^'\\"/d /\.\\"/d /^\.br/d /^\.sp/d /typedef/d s/^\.IX// s/\\f.//g s/[:,]/ /g # # eliminate unnecessary whitespace, convert multiple blanks to single space s/^[ ][ ]*// s/[ ][ ]*$// s/[ ][ ]*/ /g # # convert ".SH" into a more manageable form s/\.SH[ ][ ]*/.SH_(/ # # in ".SH NAME" # change "\-" to "-", eliminate text after "-", and split the remaining lines # at each space, making a list of names: /^\.SH_(NAME/,/^\.SH_(SYNOPSIS/{ s/\\-.*/ -/ / -/{ s/ -.*// s/ /\ /g } /^-/{ d } s/ /\ /g } # # in ".SH SYNOPSIS" # remove any line that does not contain a '(', since we only want functions. # then strip off return-type of each function. # finally, remove the parameter list, which begins with a '('. /^\.SH_(SYNOPSIS/,/^\.SH_(DESCRIPTION/{ /^[^(]*$/d # reduce # .B "int add_wch( const cchar_t *\fIwch\fB );" # to # add_wch( const cchar_t *\fIwch\fB );" s/^\([^ (]* [^ (]* [*]*\)//g s/^\([^ (]* [*]*\)//g # trim blanks in case we have # void (*) (FORM *) field_init(const FORM *form); s/) (/)(/g # reduce stuff like # void (*)(FORM *) field_init(const FORM *form); # to # field_init(const FORM *form); s/^\(([^)]*)\)\(([^)]*)\)*[ ]*//g # rename marker temporarily s/\.SH_(/.SH_/ # kill lines with ");", and trim off beginning of argument list. s/[()].*// # rename marker back s/\.SH_/.SH_(/ } # # delete ".SH DESCRIPTION" and following lines /^\.SH_(DESCRIPTION/,${ d } # # delete any remaining directives /^\./d