Conference smurf::buildhelp

2467.0. "I want to deliver a patch which includes an updated man page" by AOSG::FILTER (Automatic Posting Software - mail to flume::puck) Tue Aug 06 1996 21:37

Date Of Receipt: 	 6-AUG-1996 20:15:11.32
From: 	KAMLIA::kucherov "sergei kucherov  06-Aug-1996 2014"
To: 	reynolds@DEC:.zko.kamlia
CC: 	kucherov@DEC:.zko.kamlia, metsch@DEC:.zko.kamlia,
	buildhelp@DEC:.zko.kamlia
Subj: 	I want to deliver a patch which includes an updated man page

I believe that this is the "right" thing to do, and is much better
than *just* putting the new command arguments in the patch README
(I will *also* put the info in the README).

A user of a patched system should be able to get current information
from using the "man" command. A user should not have to bother
some SysAdmin and ask if perhaps any new options to commands were added
as part of the new patches. This would contradict our USEG mission as
providing "world class" customer-friendly patches.

I would like to argue my position up the chain of command
to get a resolution and new policy in writing within 4 weeks from today
(which allows, even encourages, delivering updated man pages for patches,
in the few cases it is appropriate (eg. new options added to commands)).
Please let me know what my next step should be to accomplish this goal.
I'd like to push our doing the right thing for our customers.
I have always been very concerned with substandard or out-of-date
documentation.

	Golden rule for customers,
	sergei


------- Forwarded Message

Return-Path: kucherov
Received: from localhost by kamlia.zk3.dec.com; 
(5.65v3.2/1.1.8.2/05Mar96-0145PM)
	id AA12430; Tue, 6 Aug 1996 19:48:02 -0400
Message-Id: <[email protected]>
To: odehelp, buildhelp
Cc: kucherov
Subject: I need to submit a change to the MAN PAGE for mkfdmn
Date: Tue, 06 Aug 96 19:48:01 -0400
From: kucherov
X-Mts: smtp


I need to submit a change to the MAN PAGE for mkfdmn
in various support pools. But I can't find any man pages in the
normal pools. Please advise how I can use ODE or otherwise
update man pages for support pools.

	Thanks,
	sergei

P.S. Obviously I also need to know how to "build" the revised man pages.

------- End of Forwarded Message