OpenSolaris

1. Community: OS/Net (ON)
   1. Blogs
   2. Development Process
   3. Developer's Reference
      1. Introduction
      2. Prerequisites
      3. The Source Tree, part 1
      4. The Source Tree, part 2
      5. Building OpenSolaris
      6. Installing and Testing OpenSolaris
      7. Integration Procedure
      8. Best Practices and Requirements
      9. Glossary
   4. Discussions
   5. Installation (from source) Quickstart
      1. Annotated nightly(1) Mail Example
   6. Currently Known Issues
   7. CRT
      1. Advocates & Sponsors
      2. Becoming a CRT Advocate
      3. Charter
      4. RTI nits to avoid
      5. Sponsor Tasks
      6. Becoming a Sponsor
   8. Schedule
   9. ONNV Flag Days, Heads Ups, and Project Integration History
      1. All
      2. Builds 91-95
      3. Builds 86-90
      4. Builds 81-85
      5. Builds 76-80
      6. Builds 71-75
      7. Builds 66-70
      8. Builds 61-65
      9. Builds 56-60
      10. Builds 51-55
      11. Builds 46-50
      12. Builds 41-45
      13. Builds 36-40
      14. Builds 31-35
      15. Builds 26-30
      16. Builds 21-25
   10. Leaders
   11. Observers
   12. Putback Logs
   13. Developing Solaris
       1. Quality Death Spiral
   14. wx
   15. findunref and unreferenced files
   16. Bourne/Korn Shell Coding Conventions

Heads Up - man does the right thing without MANPATH

Date: Thu, 15 May 2008 07:48:20 -0500
From: "Mike Gerdts" <mgerdts at gmail dot com>
To: on-all at eng dot sun dot com, onnv-gate at onnv dot eng dot sun dot com
Subject: Heads Up - man does the right thing without MANPATH

My putback of

  PSARC/2007/688 manwhich: deriving MANPATH from PATH
  6634079 man should take hints from PATH when MANPATH not set

obviates the need for MANPATH in most cases.  If MANPATH is not set,
man will use PATH to take hints as to where it should search, falling
back to /usr/share/man if necessary.  The following are new ways of
using man that do the right thing.

Example 1:

Display ls(1) from /usr/gnu/share/man, ps(1b) from /usr/share/man, and
nawk(1) from /usr/share/man.

$ export PATH=/usr/gnu/bin:/usr/ucb:/usr/bin
$ unset MANPATH
$ man ls ps
$ man nawk


Example 2:

Display man page for /usr/ucb/ps and /opt/csw/bin/wget

$ export PATH=/usr/bin
# MANPATH is set or unset - doesn't matter
$ man /usr/ucb/ps
$ man /opt/csw/bin/wget


Example 3:

Leverage the new man magic, but be sure that section 2 man pages from
/usr/share/man take precedence.  View man page chmod(2) from
/usr/share/man and see what other chmod man pages exist.

$ export PATH=/usr/gnu/bin:/usr/bin:/usr/sbin
$ unset MANPATH
$ export MANPATH=/usr/share/man,2:`man -p`:/opt/myapp/man
$ man chmod
$ man -l chmod
chmod (2)       -M /usr/share/man
chmod (1)       -M /usr/gnu/share/man
chmod (1)       -M /usr/share/man

-- 
Mike Gerdts
http://mgerdts.blogspot.com/