[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Bob's action item
I'm following up on one of my action items. This is regarding the suggestion to permit more than a single refnamediv in a refentry. My task was to provide an example of a reference page that included multiple names and purposes for a set of related functions. See this example for a set of related commands: http://uw713doc.caldera.com/en/man/html.1/ls.1.html This page documents several variations on the Unix "ls" command. They all share the same options, so creating separate reference pages for each would be a lot of duplication. But each has a somewhat different function, so we wanted a separate purpose phrase that would go into the man whatis database so the extra keywords could be searched on with man -k. An example with several related programming functions would be: http://uw713doc.caldera.com/en/man/html.3S/fprintf.3S.html If you view HTML source on either of these, you will see a set of HTML comments that look like this: <!--Meta N2 "lc"--> <!--Meta D2 "list contents of directory in columns"--> <!--Meta N2 "l"--> <!--Meta D2 "list contents of directory in long format"--> <!--Meta N2 "lf"--> <!--Meta D2 "list contents of directory in columns indicating object type"--> <!--Meta N2 "lr"--> <!--Meta D2 "list contents of directory recursively in columns"--> <!--Meta N2 "lx"--> <!--Meta D2 "list contents of directory in columns sorted horizontally"--> The UnixWare makewhatis tool looks for such comments and adds these extra names and purpose lines to the whatis database. Bob Stayton 400 Encinal Street Publications Architect Santa Cruz, CA 95060 Technical Publications voice: (831) 427-7796 The SCO Group fax: (831) 429-1887 email: bobs@sco.com
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]